@yomotech/view-toolkit 1.0.37 → 1.0.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -11,6 +11,89 @@ import { OktaAuthStateService } from '@okta/okta-angular';
11
11
  import { NgForm } from '@angular/forms';
12
12
  import { DynamicDialogRef, DynamicDialogConfig, DialogService } from 'primeng/dynamicdialog';
13
13
  import { NzI18nService } from 'ng-zorro-antd/i18n';
14
+ import * as catalog from '@yomotech/view-toolkit/catalog';
15
+ export { catalog as FieldCatalog };
16
+ import { SafeResourceUrl } from '@angular/platform-browser';
17
+
18
+ /** The building blocks a control is drawn with. */
19
+ type FieldKind = 'text' | 'textarea' | 'number' | 'selection' | 'date' | 'time' | 'datetime' | 'toggle' | 'media' | 'output' | 'other';
20
+ interface FieldModel {
21
+ /** the property's name ("fromDate") and its object ("workOrder") */
22
+ name: string;
23
+ scope: string;
24
+ reference: string;
25
+ /** the property of the data object (type, caption, value ...) or {} */
26
+ property: any;
27
+ /** the control the app uses (option.control or the catalog's choice) */
28
+ control: string;
29
+ kind: FieldKind;
30
+ label: string;
31
+ placeholder: string;
32
+ /** toolkit keyboard, null = the device's own */
33
+ keyboard: string | null;
34
+ required: boolean;
35
+ readonly: boolean;
36
+ visible: boolean;
37
+ /** PrimeNG date pattern for date fields ("dd.mm.yy"), '' otherwise */
38
+ datePattern: string;
39
+ /** HTML input type of a text field */
40
+ inputType: 'text' | 'password' | 'email';
41
+ }
42
+ /** "#/workOrder/properties/fromDate" -> { scope: "workOrder", name: "fromDate" } */
43
+ declare function splitReference(reference: string | null | undefined): {
44
+ scope: string;
45
+ name: string;
46
+ };
47
+ /**
48
+ * The model of one field of a layout (formField, column, card element) against the property
49
+ * schema of its page ({ workOrder: { fromDate: {...} } }).
50
+ */
51
+ declare function fieldModel(field: any, propertySchema: any, languageCode?: string): FieldModel;
52
+ interface FieldRules {
53
+ required: boolean;
54
+ email: boolean;
55
+ minLength: number | null;
56
+ maxLength: number | null;
57
+ /** regular expression of the Designer's "Validation pattern" */
58
+ pattern: string | null;
59
+ min: number | null;
60
+ max: number | null;
61
+ }
62
+ /** The rules a field's layout sets. */
63
+ declare function fieldRules(field: any): FieldRules;
64
+ /**
65
+ * The message for the first error of a field: the layout's own (option.messages[rule], may be a
66
+ * translation key), else the project's text (errorMessage_xx.json: required, pattern, email,
67
+ * minlength, maxlength, min, max), else English. {{field}}, {{requiredLength}}, {{min}}, {{max}}
68
+ * are filled in.
69
+ */
70
+ declare function ruleMessage(field: any, errors: Record<string, any> | null | undefined, projectTexts?: Record<string, string> | null, translations?: Record<string, string> | null, caption?: string): string;
71
+ /**
72
+ * The grid of label and field: layout "horizontal" puts the label beside the field (dialog: an 80px
73
+ * column, form: 30% with at least 110px), otherwise above it. The layout's layoutStyle wins in the
74
+ * dialog.
75
+ */
76
+ declare function fieldInnerLayoutStyle(formField: any, container?: 'dialog' | 'form'): Record<string, any>;
77
+ /**
78
+ * Marks for the app's test runner (#166, .liveforge/tests): a field by its key in the DTO, a button by
79
+ * its action - the same in every language, whatever the caption says. data-vl-field / data-vl-action.
80
+ */
81
+ declare function testFieldKey(field: any): string | null;
82
+ declare function testAction(option: any): string | null;
83
+ /**
84
+ * Whether a button writes real data: to the backend (storageType database - the card's disk icon,
85
+ * Save All, a dialog sending its record), saves or deletes. The test runner refuses such a button
86
+ * unless the flow says "books": true and a person confirmed it (data-vl-writes).
87
+ */
88
+ declare function testWrites(option: any): 'true' | 'false';
89
+
90
+ type CustomKeyboardType = 'email' | 'numeric' | 'alpha' | 'string' | 'date' | 'time';
91
+ declare function normalizeCustomKeyboardType(value: unknown): CustomKeyboardType | null;
92
+ /**
93
+ * Keyboard for a field: option.keyboardType (or the older option.keyboard) when the layout sets one, otherwise derived from the
94
+ * attribute (property schema) type. Returns null where the system keyboard stays in charge.
95
+ */
96
+ declare function resolveCustomKeyboardType(option: any, property: any): CustomKeyboardType | null;
14
97
 
15
98
  declare class RequestService {
16
99
  private http;
@@ -212,14 +295,6 @@ declare class NotificationService {
212
295
  static ɵprov: i0.ɵɵInjectableDeclaration<NotificationService>;
213
296
  }
214
297
 
215
- type CustomKeyboardType = 'email' | 'numeric' | 'alpha' | 'string' | 'date' | 'time';
216
- declare function normalizeCustomKeyboardType(value: unknown): CustomKeyboardType | null;
217
- /**
218
- * Keyboard for a field: option.keyboardType when the layout sets one, otherwise derived from the
219
- * attribute (property schema) type. Returns null where the system keyboard stays in charge.
220
- */
221
- declare function resolveCustomKeyboardType(option: any, property: any): CustomKeyboardType | null;
222
-
223
298
  type CustomKeyboardTarget = HTMLInputElement | HTMLTextAreaElement;
224
299
  interface CustomKeyboardSession {
225
300
  target: CustomKeyboardTarget;
@@ -289,6 +364,12 @@ declare class CustomKeyboardService {
289
364
  insert(character: string): void;
290
365
  backspace(): void;
291
366
  clear(): void;
367
+ /**
368
+ * The field the keyboard types into stays clearly marked until the keyboard closes, wherever the
369
+ * browser focus goes; an autocomplete marks its frame (its input has none). Style: vl-field-active
370
+ * in custom-keyboard.component.css (#166, OFFENE-PUNKTE 43).
371
+ */
372
+ private markActiveField;
292
373
  close(option?: {
293
374
  blurTarget?: boolean;
294
375
  restoreAccessoryBar?: boolean;
@@ -312,7 +393,12 @@ declare class CustomKeyboardService {
312
393
  private updateDateTimeTarget;
313
394
  /** String position right after the given number of digits, separators included. */
314
395
  private positionAfterDigits;
315
- private formatDateDigits;
396
+ /** A time field typed with 12 hours and AM/PM (vl-datetime in English: data-vl-time-12). */
397
+ twelveHours(target: CustomKeyboardTarget | null | undefined): boolean;
398
+ /** The AM/PM key: turns the time of the open 12-hour field round. */
399
+ toggleMeridiem(): void;
400
+ /** The pattern the date field is typed in (vlDateFormat on its picker); ISO where none is set. */
401
+ private datePatternOf;
316
402
  private formatTimeDigits;
317
403
  beginPickerOverlay(): void;
318
404
  endPickerOverlay(option?: {
@@ -443,6 +529,10 @@ declare class CardComponent {
443
529
  private notificationService;
444
530
  private oauthService;
445
531
  private requestService;
532
+ /** Marks for the app's test runner (#166): field key and button action. */
533
+ readonly vlFieldKey: typeof testFieldKey;
534
+ readonly vlAction: typeof testAction;
535
+ readonly vlWrites: typeof testWrites;
446
536
  private readonly remoteLists;
447
537
  /** Loaded lists by field reference. */
448
538
  remoteData: Record<string, any[]>;
@@ -454,9 +544,12 @@ declare class CardComponent {
454
544
  completeRemote(event: any, node: any): void;
455
545
  /** Date and time picker behaviour shared by all containers. */
456
546
  readonly picker: DateTimePickerService;
547
+ private readonly keyboard;
457
548
  private readonly pickerHost;
458
549
  /** Keep existing checkbox data objects usable; new objects use boolean. */
459
550
  renderFieldType(type: string | undefined): string | undefined;
551
+ /** "datetime" for a value with date and time (type datetime or control dateTimepicker), else "date". */
552
+ cardDateKind(field: any): 'date' | 'datetime';
460
553
  itemInfo: any;
461
554
  currentPage: number;
462
555
  pageSize: number;
@@ -546,11 +639,20 @@ declare class CardComponent {
546
639
  getMediaSource(layout: any, record: any): string;
547
640
  getMediaLabel(layout: any): string;
548
641
  getMediaKind(layout: any, record: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
642
+ /**
643
+ * The toolkit keyboard of a field - the same rule as the dialog: the field's keyboardType (or the
644
+ * older keyboard; native/none = the device's own), else from its attribute type. #166 step 4.2
645
+ */
646
+ keyboardTypeFor(field: any, propertySchema: any): CustomKeyboardType | null;
549
647
  static ɵfac: i0.ɵɵFactoryDeclaration<CardComponent, never>;
550
648
  static ɵcmp: i0.ɵɵComponentDeclaration<CardComponent, "vl-card", never, { "itemInfo": { "alias": "itemInfo"; "required": false; }; "currentPage": { "alias": "currentPage"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "mobileDisplay": { "alias": "mobileDisplay"; "required": false; }; "scrollPagination": { "alias": "scrollPagination"; "required": false; }; "pages": { "alias": "pages"; "required": false; }; "paginationMode": { "alias": "paginationMode"; "required": false; }; "paginationLoading": { "alias": "paginationLoading"; "required": false; }; }, { "cardButtonClick": "cardButtonClick"; "cardHeaderButtonClick": "cardHeaderButtonClick"; "linkDetails": "linkDetails"; "imageDetails": "imageDetails"; "onPageSizeChange": "onPageSizeChange"; "onPageChange": "onPageChange"; "cardDataChange": "cardDataChange"; }, never, never, true, never>;
551
649
  }
552
650
 
553
651
  declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestroy {
652
+ /** Marks for the app's test runner (#166): field key and button action. */
653
+ readonly vlFieldKey: typeof testFieldKey;
654
+ readonly vlAction: typeof testAction;
655
+ readonly vlWrites: typeof testWrites;
554
656
  private readonly remoteLists;
555
657
  /** Loaded lists by field reference. */
556
658
  remoteData: Record<string, any[]>;
@@ -574,7 +676,7 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
574
676
  private readonly host;
575
677
  ngOnDestroy(): void;
576
678
  /** Keep existing checkbox data objects usable; new objects use boolean. */
577
- renderFieldType(type: string | undefined): string | undefined;
679
+ renderFieldType(type: string | undefined, field?: any): string | undefined;
578
680
  customEmailPattern: string;
579
681
  showPassword: boolean;
580
682
  formCopy: any;
@@ -596,7 +698,7 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
596
698
  };
597
699
  getSectionBodyStyle(formSection: any): any;
598
700
  getFieldWrapperStyle(formField: any): any;
599
- getFieldInnerLayoutStyle(formField: any): any;
701
+ getFieldInnerLayoutStyle(formField: any): Record<string, any>;
600
702
  getScope(scope: any): string;
601
703
  togglePasswordVisibility(): void;
602
704
  invokeFormBtnClick(option: any, propertySchema: any): void;
@@ -615,6 +717,20 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
615
717
  getMediaSource(field: any): string;
616
718
  getMediaLabel(field: any): string;
617
719
  getMediaKind(field: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
720
+ /**
721
+ * A field's message shows once the user typed in it and left it, or after a save attempt - not
722
+ * when an empty field was only passed through (the message then pushed the row and its label out
723
+ * of line). #166
724
+ */
725
+ saveTried: boolean;
726
+ showError(control: any): boolean;
727
+ /**
728
+ * The toolkit keyboard of a field - the same rule as the dialog: the field's keyboardType (or the
729
+ * older keyboard; native/none = the device's own), else from its attribute type. #166 step 4.2
730
+ */
731
+ keyboardTypeFor(field: any, propertySchema: any): CustomKeyboardType | null;
732
+ /** The message of a field's first error (layout's own, project text, English) - #166 step 4.6. */
733
+ fieldMessage(field: any, control: any): string;
618
734
  static ɵfac: i0.ɵɵFactoryDeclaration<FormComponent, never>;
619
735
  static ɵcmp: i0.ɵɵComponentDeclaration<FormComponent, "vl-form", never, { "errorMessages": { "alias": "errorMessages"; "required": false; }; "creditCardError": { "alias": "creditCardError"; "required": false; }; "form": { "alias": "form"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; }, { "formButtonClick": "formButtonClick"; "checkBoxChangeEvent": "checkBoxChangeEvent"; }, never, never, true, never>;
620
736
  }
@@ -724,6 +840,29 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
724
840
  getMediaSource(col: any, data: any): string;
725
841
  getMediaLabel(col: any): string;
726
842
  getMediaKind(col: any, data: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
843
+ /**
844
+ * Whether a column shows a date or a time (DTO type date/time, or the old option.dateFormat) -
845
+ * shown like everywhere else in the app language (vlDateText, services/date-display.ts).
846
+ */
847
+ dateKind(col: any): 'date' | 'time' | 'datetime' | null;
848
+ /**
849
+ * A field's message shows once the user typed in it and left it, or after a save attempt - not
850
+ * when an empty field was only passed through (the message then pushed the row and its label out
851
+ * of line). #166
852
+ */
853
+ saveTried: boolean;
854
+ showError(control: any): boolean;
855
+ /**
856
+ * The toolkit keyboard of a field - the same rule as the dialog: the field's keyboardType (or the
857
+ * older keyboard; native/none = the device's own), else from its attribute type. #166 step 4.2
858
+ */
859
+ keyboardTypeFor(field: any, propertySchema: any): CustomKeyboardType | null;
860
+ /** The message of a field's first error (layout's own, project text, English) - #166 step 4.6. */
861
+ fieldMessage(field: any, control: any): string;
862
+ /** The layout's control of a column where the grid shows a shared control (#166 step 4.4). */
863
+ cellControl(col: any): string;
864
+ /** The DTO type of a column ("boolean" or a text flag for the switch). */
865
+ propertyType(col: any): string;
727
866
  static ɵfac: i0.ɵɵFactoryDeclaration<GridComponent, never>;
728
867
  static ɵcmp: i0.ɵɵComponentDeclaration<GridComponent, "vl-grid", never, { "errorMessages": { "alias": "errorMessages"; "required": false; }; "environment": { "alias": "environment"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "tableitemInfo": { "alias": "tableitemInfo"; "required": false; }; "form": { "alias": "form"; "required": false; }; "isTableDataLoad": { "alias": "isTableDataLoad"; "required": false; }; "currenTableOptions": { "alias": "currenTableOptions"; "required": false; }; "projectSeleted": { "alias": "projectSeleted"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "currentPage": { "alias": "currentPage"; "required": false; }; "pages": { "alias": "pages"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; }, { "onPageChange": "onPageChange"; "onPageSizeChange": "onPageSizeChange"; "onGridScroll": "onGridScroll"; "showGridLink": "showGridLink"; "gridButtonClick": "gridButtonClick"; "gridIncreamentClick": "gridIncreamentClick"; "gridDecreamentClick": "gridDecreamentClick"; "gridImgClick": "gridImgClick"; }, never, never, true, never>;
729
868
  }
@@ -734,6 +873,10 @@ declare class HeaderMenuComponent implements AfterViewInit {
734
873
  private utilityService;
735
874
  private couchdbService;
736
875
  private platform;
876
+ /** Marks for the app's test runner (#166): field key and button action. */
877
+ readonly vlFieldKey: typeof testFieldKey;
878
+ readonly vlAction: typeof testAction;
879
+ readonly vlWrites: typeof testWrites;
737
880
  isLogined: boolean;
738
881
  propertyschema: any;
739
882
  headerItems: any[];
@@ -785,14 +928,12 @@ declare class ModelComponent implements OnChanges, OnDestroy {
785
928
  private readonly dialogRef;
786
929
  private readonly dialogConfig;
787
930
  private utilityService;
931
+ /** Marks for the app's test runner (#166): field key and button action. */
932
+ readonly vlFieldKey: typeof testFieldKey;
788
933
  private readonly remoteLists;
789
- /** Keep existing checkbox data objects usable; new objects use boolean. */
790
- renderFieldType(type: string | undefined): string | undefined;
791
934
  /** Date and time picker behaviour shared by all containers. */
792
935
  readonly picker: DateTimePickerService;
793
936
  private readonly host;
794
- /** The toolkit keyboard for a field, from option.keyboardType or the attribute type. */
795
- keyboardTypeFor(formField: any): CustomKeyboardType | null;
796
937
  matchData: any[];
797
938
  date2: Date | undefined;
798
939
  errorMessages: any;
@@ -810,8 +951,6 @@ declare class ModelComponent implements OnChanges, OnDestroy {
810
951
  private initializeDialogContent;
811
952
  private updateDialogHeader;
812
953
  updateLayoutLanguage<T>(schema: T, translations: Record<string, string>): T;
813
- getLabel(formField: any): any;
814
- getButtonCaption(formField: any): any;
815
954
  mapDataToPropertySchema(data: any, modalItemInfo: any): void;
816
955
  setAutoCompleteData(): Promise<void>;
817
956
  /** The field's backend list (RemoteListService - shared by every container). */
@@ -820,22 +959,32 @@ declare class ModelComponent implements OnChanges, OnDestroy {
820
959
  resolveToken(template: string, context: any): string;
821
960
  buildCompany(userInfo: any): string;
822
961
  getScope(scope: any): string;
962
+ /** The autocomplete asked last, so a list that arrives later can still be shown for it. */
963
+ private lastAutocomplete;
964
+ /**
965
+ * What an autocomplete shows when it has no entries: "loading" while its list is on the way,
966
+ * "no results" after. In the project's language (languages/<code>.json: autocompleteLoading,
967
+ * autocompleteNoResults), English when the project has no text for it.
968
+ */
969
+ autocompleteEmptyText(formField: any): string;
823
970
  autocompChangeEvent(event: any, formField: any): void;
824
971
  autocompFocusOutEvent(event: any, formField: any): void;
825
972
  autocompSelectEvent(obj: any, formField?: any): void;
826
- setErroMessage(formField: any, errorMessages: any, errorType: any): any;
827
- getStyleWithoutClasses(styleObject: any): {
828
- classes: any;
829
- style: any;
973
+ setErroMessage(formField: any, errorMessages: any, errorType: any): string;
974
+ /** A style object of the layout: its classes (all of them) and its CSS. */
975
+ styleOf(styleObject: any): {
976
+ classes: string;
977
+ style: Record<string, any>;
830
978
  };
979
+ /** The section is a 12 column grid, as in the Designer; the section's own style comes on top. */
831
980
  getSectionBodyStyle(formSection: any): Record<string, any>;
981
+ /**
982
+ * The field's wrapper in the section grid: the field's whole style from the layout (the Designer's
983
+ * wrapper style), placed by gridColumn ("span N", else gridSpan) and never wider than its column.
984
+ */
832
985
  getFieldWrapperStyle(formField: any): Record<string, any>;
833
986
  onTimePanelShow(formField: any): void;
834
- getControlStyle(formField: any): Record<string, any>;
835
- getFieldInnerLayoutStyle(formField: any): Record<string, any>;
836
987
  dateChangeEvent(formField: any, value: any): void;
837
- onDateTyping(event: any): void;
838
- onTimeTyping(event: any): void;
839
988
  timeChangeEvent(formField: any, value: any): void;
840
989
  handleRules(formField: any, value: any): void;
841
990
  resetRule(rule: any, formField: any): void;
@@ -845,10 +994,13 @@ declare class ModelComponent implements OnChanges, OnDestroy {
845
994
  invokeFormBtnClick(option: any, propertySchema: any, form: NgForm): void;
846
995
  checkValidty(form: NgForm): boolean;
847
996
  onCancel(): void;
848
- private getMediaProperty;
849
- getMediaSource(field: any): string;
850
- getMediaLabel(field: any): string;
851
- getMediaKind(field: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
997
+ /**
998
+ * A field's message shows once the user typed in it and left it, or after a save attempt - not
999
+ * when an empty field was only passed through (the message then pushed the row and its label out
1000
+ * of line). #166
1001
+ */
1002
+ saveTried: boolean;
1003
+ showError(control: any): boolean;
852
1004
  static ɵfac: i0.ɵɵFactoryDeclaration<ModelComponent, never>;
853
1005
  static ɵcmp: i0.ɵɵComponentDeclaration<ModelComponent, "vl-model", never, { "errorMessages": { "alias": "errorMessages"; "required": false; }; "modalItemInfo": { "alias": "modalItemInfo"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "setFormDataHandler": { "alias": "setFormDataHandler"; "required": false; }; }, {}, never, never, true, never>;
854
1006
  }
@@ -1087,24 +1239,64 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
1087
1239
  static ɵcmp: i0.ɵɵComponentDeclaration<SideMenuComponent, "vl-side-menu", never, { "menuItems": { "alias": "menuItems"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "settings": { "alias": "settings"; "required": false; }; "projects": { "alias": "projects"; "required": false; }; "tenantName": { "alias": "tenantName"; "required": false; }; "environment": { "alias": "environment"; "required": false; }; "projectSeleted": { "alias": "projectSeleted"; "required": false; }; "appVersionInfo": { "alias": "appVersionInfo"; "required": false; }; }, { "languageChange": "languageChange"; "invokeMenu": "invokeMenu"; "menuToggle": "menuToggle"; "invokeProject": "invokeProject"; "errorMessage": "errorMessage"; "deleteProject": "deleteProject"; "paginationType": "paginationType"; }, never, never, true, never>;
1088
1240
  }
1089
1241
 
1090
- declare class Autocomplete {
1091
- formField: any;
1092
- modalItemInfo: any;
1093
- matchData: any;
1094
- selectedLanguageInfo: any;
1242
+ declare class Autocomplete implements OnChanges {
1243
+ private host;
1244
+ /** the field of the layout (scope, option, label) */
1245
+ field: any;
1246
+ /** editing: the object whose value is the choice (the property in the property schema) */
1247
+ target: any;
1248
+ /** reading: the text to show (a card's record) */
1249
+ value: any;
1250
+ readonly: boolean;
1251
+ /** the loaded entries of the field's source and whether they are still on the way */
1252
+ list: any[] | null | undefined;
1253
+ loading: boolean;
1254
+ /** combobox: the same list, values outside it only with option.allowCustom */
1255
+ combobox: boolean;
1256
+ /** the toolkit keyboard (the container's keyboardTypeFor) */
1257
+ keyboard: string | null;
1258
+ saveTried: boolean;
1095
1259
  errorMessages: any;
1096
- autocompChange: EventEmitter<any>;
1097
- autocompFocusOut: EventEmitter<any>;
1098
- autocompChangeEvent(event: any, formField: any): void;
1099
- autocompFocusOutEvent(event: any, formField: any): void;
1100
- getScope(scope: any): string;
1101
- getStyleWithoutClasses(styleObject: any): {
1102
- classes: any;
1103
- style: any;
1104
- };
1105
- setErroMessage(formField: any, errorMessages: any, errorType: any): any;
1260
+ /** the project's texts in the selected language (placeholder keys, loading / no results) */
1261
+ translations: Record<string, string> | null;
1262
+ inputStyle: any;
1263
+ inputClass: string;
1264
+ /** a chosen entry (object) - the container fills other fields from it (onSelect.mapFields) */
1265
+ picked: EventEmitter<any>;
1266
+ private control?;
1267
+ private autocomplete?;
1268
+ suggestions: any[];
1269
+ private lastQuery;
1270
+ constructor(host: ElementRef<HTMLElement>);
1271
+ /** the name of the field in the entries (the property's name, "workOrderNo") */
1272
+ get key(): string;
1273
+ get optionLabel(): string;
1274
+ get forceSelection(): boolean;
1275
+ get emptyText(): string;
1276
+ /** (completeMethod): the entries that start with what was typed */
1277
+ complete(event: {
1278
+ query?: string;
1279
+ }): void;
1280
+ /** The entries changed while the list is open: its height and so its place change too. */
1281
+ private refit;
1282
+ /** the list arrived while open: show it for what was typed meanwhile */
1283
+ ngOnChanges(changes: SimpleChanges): void;
1284
+ private filter;
1285
+ /**
1286
+ * (onShow): the list stays inside the page frame - the dialog, else the window - and above a
1287
+ * keyboard docked below. It opens to the side with more room and gets shorter (scrolls) when the
1288
+ * room is small. Before, the list flipped upwards over the dialog's top edge up to the status bar
1289
+ * (phone in landscape, keyboard beside the dialog - test F15).
1290
+ */
1291
+ fitList(): void;
1292
+ changed(value: any): void;
1293
+ placeholder(): string;
1294
+ showError(): boolean;
1295
+ message(): string;
1296
+ /** text of a value for reading: the label of an entry, or the value itself */
1297
+ shown(value: any): string;
1106
1298
  static ɵfac: i0.ɵɵFactoryDeclaration<Autocomplete, never>;
1107
- static ɵcmp: i0.ɵɵComponentDeclaration<Autocomplete, "vl-autocomplete", never, { "formField": { "alias": "formField"; "required": false; }; "modalItemInfo": { "alias": "modalItemInfo"; "required": false; }; "matchData": { "alias": "matchData"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; }, { "autocompChange": "autocompChange"; "autocompFocusOut": "autocompFocusOut"; }, never, never, true, never>;
1299
+ static ɵcmp: i0.ɵɵComponentDeclaration<Autocomplete, "vl-autocomplete", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "list": { "alias": "list"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "combobox": { "alias": "combobox"; "required": false; }; "keyboard": { "alias": "keyboard"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputClass": { "alias": "inputClass"; "required": false; }; }, { "picked": "picked"; }, never, never, true, never>;
1108
1300
  }
1109
1301
 
1110
1302
  declare class Button {
@@ -1117,9 +1309,34 @@ declare class Date$1 {
1117
1309
  static ɵcmp: i0.ɵɵComponentDeclaration<Date$1, "vl-date", never, {}, {}, never, never, true, never>;
1118
1310
  }
1119
1311
 
1120
- declare class Dropdown {
1121
- static ɵfac: i0.ɵɵFactoryDeclaration<Dropdown, never>;
1122
- static ɵcmp: i0.ɵɵComponentDeclaration<Dropdown, "vl-dropdown", never, {}, {}, never, never, true, never>;
1312
+ declare class DropdownControl {
1313
+ field: any;
1314
+ target: any;
1315
+ value: any;
1316
+ readonly: boolean;
1317
+ /** the loaded entries (the property's data), used when the layout has no allowed values */
1318
+ items: any[] | null | undefined;
1319
+ saveTried: boolean;
1320
+ errorMessages: any;
1321
+ translations: Record<string, string> | null;
1322
+ inputStyle: any;
1323
+ inputClass: string;
1324
+ chosen: EventEmitter<any>;
1325
+ private control?;
1326
+ private cache;
1327
+ private get option();
1328
+ private caption;
1329
+ /** { label, value } entries - the same array while the source does not change */
1330
+ entries(): {
1331
+ label: string;
1332
+ value: any;
1333
+ }[];
1334
+ shown(value: any): string;
1335
+ placeholder(): string;
1336
+ showError(): boolean;
1337
+ message(): string;
1338
+ static ɵfac: i0.ɵɵFactoryDeclaration<DropdownControl, never>;
1339
+ static ɵcmp: i0.ɵɵComponentDeclaration<DropdownControl, "vl-dropdown", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "items": { "alias": "items"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputClass": { "alias": "inputClass"; "required": false; }; }, { "chosen": "chosen"; }, never, never, true, never>;
1123
1340
  }
1124
1341
 
1125
1342
  declare class ErrorMessage {
@@ -1158,6 +1375,13 @@ declare class Textbox {
1158
1375
  private utilityService;
1159
1376
  formField: any;
1160
1377
  modalItemInfo: any;
1378
+ /** set by the dialog after a save attempt: messages show then even for untouched fields */
1379
+ saveTried: boolean;
1380
+ errorMessages: any;
1381
+ /** reading: show the value as text (a link when option.link) */
1382
+ readonly: boolean;
1383
+ value: any;
1384
+ linkClicked: EventEmitter<any>;
1161
1385
  selectedLanguageInfo: any;
1162
1386
  constructor(cdr: ChangeDetectorRef, utilityService: UtilityService);
1163
1387
  ngOnInit(): void;
@@ -1169,8 +1393,10 @@ declare class Textbox {
1169
1393
  /** The toolkit keyboard for this field, from option.keyboardType or the attribute type. */
1170
1394
  keyboardTypeFor(formField: any): CustomKeyboardType | null;
1171
1395
  getPlaceholder(formField: any): string;
1396
+ showError(control: any): boolean;
1397
+ fieldMessage(control: any): string;
1172
1398
  static ɵfac: i0.ɵɵFactoryDeclaration<Textbox, never>;
1173
- static ɵcmp: i0.ɵɵComponentDeclaration<Textbox, "vl-textbox", never, { "formField": { "alias": "formField"; "required": false; }; "modalItemInfo": { "alias": "modalItemInfo"; "required": false; }; }, {}, never, never, true, never>;
1399
+ static ɵcmp: i0.ɵɵComponentDeclaration<Textbox, "vl-textbox", never, { "formField": { "alias": "formField"; "required": false; }; "modalItemInfo": { "alias": "modalItemInfo"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "linkClicked": "linkClicked"; }, never, never, true, never>;
1174
1400
  }
1175
1401
 
1176
1402
  declare class Time {
@@ -1180,7 +1406,7 @@ declare class Time {
1180
1406
 
1181
1407
  declare class ViewToolkitModule {
1182
1408
  static ɵfac: i0.ɵɵFactoryDeclaration<ViewToolkitModule, never>;
1183
- static ɵmod: i0.ɵɵNgModuleDeclaration<ViewToolkitModule, never, [typeof i1.CommonModule, typeof CardComponent, typeof FormComponent, typeof GridComponent, typeof HeaderMenuComponent, typeof LogsComponent, typeof ModelComponent, typeof PaginationComponent, typeof SideMenuComponent, typeof Autocomplete, typeof Button, typeof Date$1, typeof Dropdown, typeof ErrorMessage, typeof Label, typeof String, typeof Textbox, typeof Time], [typeof CardComponent, typeof FormComponent, typeof GridComponent, typeof HeaderMenuComponent, typeof LogsComponent, typeof ModelComponent, typeof PaginationComponent, typeof SideMenuComponent]>;
1409
+ static ɵmod: i0.ɵɵNgModuleDeclaration<ViewToolkitModule, never, [typeof i1.CommonModule, typeof CardComponent, typeof FormComponent, typeof GridComponent, typeof HeaderMenuComponent, typeof LogsComponent, typeof ModelComponent, typeof PaginationComponent, typeof SideMenuComponent, typeof Autocomplete, typeof Button, typeof Date$1, typeof DropdownControl, typeof ErrorMessage, typeof Label, typeof String, typeof Textbox, typeof Time], [typeof CardComponent, typeof FormComponent, typeof GridComponent, typeof HeaderMenuComponent, typeof LogsComponent, typeof ModelComponent, typeof PaginationComponent, typeof SideMenuComponent]>;
1184
1410
  static ɵinj: i0.ɵɵInjectorDeclaration<ViewToolkitModule>;
1185
1411
  }
1186
1412
 
@@ -1242,6 +1468,9 @@ declare class CustomKeyboardComponent {
1242
1468
  private toUpper;
1243
1469
  enterKey(key: string): void;
1244
1470
  enterSpace(): void;
1471
+ /** The field takes several lines (textArea): the text keyboard offers a new-line key. */
1472
+ get multiLine(): boolean;
1473
+ enterNewLine(): void;
1245
1474
  toggleCase(): void;
1246
1475
  toggleSymbols(): void;
1247
1476
  static ɵfac: i0.ɵɵFactoryDeclaration<CustomKeyboardComponent, never>;
@@ -1267,18 +1496,93 @@ declare function setToolkitKeyboardOnWeb(on: boolean): void;
1267
1496
  /** Whether fields get the toolkit keyboards: on the devices always, in a browser when switched on. */
1268
1497
  declare function toolkitKeyboardActive(): boolean;
1269
1498
 
1499
+ declare function setDateLanguage(languageCode: string | null | undefined): void;
1500
+ declare function currentDateLanguage(): string;
1501
+ /** The numeric date pattern of a language in PrimeNG letters, year with four digits: de "dd.mm.yy". */
1502
+ declare function languageDatePattern(languageCode?: string): string;
1503
+ /** A fixed pattern of the Designer (Unicode letters, "dd.MM.yyyy") in PrimeNG letters ("dd.mm.yy"). */
1504
+ declare function primeDatePattern(unicodePattern: string): string;
1505
+ /** The pattern a date field is typed in (PrimeNG letters). */
1506
+ declare function dateInputPattern(option: any, property: any, languageCode?: string): string;
1507
+ /**
1508
+ * Digits typed on the toolkit keyboard shaped into a date pattern (PrimeNG letters): with
1509
+ * "dd.mm.yy" 18102026 becomes 18.10.2026. yy takes four digits, the other parts two.
1510
+ */
1511
+ declare function shapeDateDigits(digits: string, pattern: string): string;
1512
+ /** The number of digits of a date pattern (8 for dd.mm.yy). */
1513
+ declare function dateDigitCount(pattern: string): number;
1270
1514
  /**
1271
- * The placeholder of the field `reference` in `propertySchema`, translated when the selected
1272
- * language has an entry for it; empty when the project defines none.
1515
+ * A date or time value for a list. Date by the field's display style (option.displayFormat):
1516
+ * short -> numeric with four-digit year (de 18.10.2026), medium or none -> the language's medium
1517
+ * style (de 18.10.2026, en Oct 18, 2026), long -> long style (de 18. Oktober 2026), custom -> the
1518
+ * fixed pattern. Time hh:mm. The year never shrinks to two digits.
1519
+ */
1520
+ declare function displayDateValue(value: any, kind: 'date' | 'time' | 'datetime', option?: any, languageCode?: string): string;
1521
+ /** The language of the automatic input hints and of dates (the project language; set with the date pickers' one). */
1522
+ declare function setInputHintLanguage(languageCode: string | null | undefined): void;
1523
+ /**
1524
+ * The input format of a date picker format ("yy-mm-dd": PrimeNG, yy = 4-digit year) or of a time
1525
+ * field ("time", 24 hours) in the letters of `languageCode`: "JJJJ-MM-TT", "hh:mm".
1526
+ */
1527
+ declare function inputFormatHint(dateFormat: string, languageCode?: string): string;
1528
+ /** A time in a fixed pattern: HH / H (24 hours), hh / h (12 hours), mm, a (AM/PM). */
1529
+ declare function fixedTimeText(date: Date, pattern: string): string;
1530
+ /** Whether a language writes times with 12 hours and AM/PM (en yes, de no). */
1531
+ declare function usesTwelveHours(languageCode?: string): boolean;
1532
+ /** PrimeNG hourFormat of the language: "12" or "24". */
1533
+ declare function timeHourFormat(languageCode?: string): '12' | '24';
1534
+ /**
1535
+ * Typed time digits shaped into the field ("0830" -> "08:30"); with 12 hours an AM/PM stays, a
1536
+ * complete time without one gets AM (12 PM), and an hour from 13 becomes PM ("2030" -> "08:30 PM").
1537
+ */
1538
+ declare function shapeTimeText(text: string, twelveHours: boolean): string;
1539
+ /** AM <-> PM of a typed 12-hour time ("08:30 AM" -> "08:30 PM"); a time without one gets PM. */
1540
+ declare function toggleMeridiem(text: string): string;
1541
+
1542
+ /**
1543
+ * The placeholder of a field: only its layout (option.placeholder, set in the Designer), translated
1544
+ * when the selected language has an entry for it; empty otherwise. Never from the data object - the
1545
+ * DTO defines only the type (decided 2026-10-18, #166).
1546
+ */
1547
+ declare function layoutPlaceholder(option: any, translations?: Record<string, string> | null): string;
1548
+ /** @deprecated the placeholder never comes from the data object any more - use layoutPlaceholder. */
1549
+ declare function resolvePlaceholder(_propertySchema: any, _reference: string | null | undefined, _translations?: Record<string, string> | null): string;
1550
+ /**
1551
+ * Template form: [placeholder]="propertySchema | vlPlaceholder: reference : translations : option" -
1552
+ * only the layout's option.placeholder, never the data object (step 4, #166).
1273
1553
  */
1274
- declare function resolvePlaceholder(propertySchema: any, reference: string | null | undefined, translations?: Record<string, string> | null): string;
1275
- /** Template form of resolvePlaceholder: [placeholder]="propertySchema | vlPlaceholder: reference". */
1276
1554
  declare class PlaceholderPipe implements PipeTransform {
1277
- transform(propertySchema: any, reference: string | null | undefined, translations?: Record<string, string> | null): string;
1555
+ transform(propertySchema: any, reference: string | null | undefined, translations?: Record<string, string> | null, option?: any): string;
1278
1556
  static ɵfac: i0.ɵɵFactoryDeclaration<PlaceholderPipe, never>;
1279
1557
  static ɵpipe: i0.ɵɵPipeDeclaration<PlaceholderPipe, "vlPlaceholder", true>;
1280
1558
  }
1281
1559
 
1560
+ /**
1561
+ * Template form for date and time pickers:
1562
+ * [placeholder]="propertySchema | vlDateHint: reference : option : 'date' | 'time'".
1563
+ * The field's own placeholder, else its input format.
1564
+ */
1565
+ declare class DateHintPipe implements PipeTransform {
1566
+ transform(propertySchema: any, reference: string | null | undefined, option?: any, kind?: 'date' | 'time'): string;
1567
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateHintPipe, never>;
1568
+ static ɵpipe: i0.ɵɵPipeDeclaration<DateHintPipe, "vlDateHint", true>;
1569
+ }
1570
+ /**
1571
+ * The pattern a date picker is typed and shown in (PrimeNG letters), following the app language:
1572
+ * [dateFormat]="propertySchema | vlDateFormat: reference : option".
1573
+ */
1574
+ declare class DateFormatPipe implements PipeTransform {
1575
+ transform(propertySchema: any, reference: string | null | undefined, option?: any): string;
1576
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateFormatPipe, never>;
1577
+ static ɵpipe: i0.ɵɵPipeDeclaration<DateFormatPipe, "vlDateFormat", true>;
1578
+ }
1579
+ /** A date or time value in a list: {{ value | vlDateText: 'date' | 'time' : option }} (de 18.10.2026, 08:05). */
1580
+ declare class DateTextPipe implements PipeTransform {
1581
+ transform(value: any, kind?: 'date' | 'time' | 'datetime', option?: any): string;
1582
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateTextPipe, never>;
1583
+ static ɵpipe: i0.ɵɵPipeDeclaration<DateTextPipe, "vlDateText", true>;
1584
+ }
1585
+
1282
1586
  /** [src]="source | vlMedia | async" - the same Promise for the same source, so no request loop. */
1283
1587
  declare class MediaSourcePipe implements PipeTransform {
1284
1588
  private couchdb;
@@ -1327,6 +1631,26 @@ declare class RequestTimeoutService {
1327
1631
  }
1328
1632
  /** A request under the waiting rule (RequestTimeoutService.run); runs plainly before Angular is up. */
1329
1633
  declare function stagedRequest<T>(work: (signal: AbortSignal) => Promise<T>): Promise<T>;
1634
+ /** Answers that are worth asking again: the server or the way to it had a moment. */
1635
+ declare const RETRY_STATUSES: ReadonlySet<number>;
1636
+ /** Pauses between the attempts of a read, in ms; the last one repeats. */
1637
+ declare const RETRY_PAUSES: readonly [1000, 2000, 4000, 8000];
1638
+ /** One attempt of a read without an answer is given up after this and sent again. */
1639
+ declare const READ_ATTEMPT_TIMEOUT = 15000;
1640
+ interface StagedReadOptions {
1641
+ /** Ask once more after a 403 (a first read at the start can be refused while it is set up). */
1642
+ retryForbiddenOnce?: boolean;
1643
+ }
1644
+ /**
1645
+ * A read under the waiting rule that does not give up on a weak network: tried again until it has
1646
+ * an answer that is no passing error, at most until the 60 s of the waiting rule are over. Only for
1647
+ * requests without a side effect - a write that arrived but whose answer was lost would be stored
1648
+ * twice. The last answer is returned as it is (the caller decides on !ok); after the last attempt
1649
+ * the error of that attempt is thrown.
1650
+ */
1651
+ declare function stagedRead(work: (signal: AbortSignal) => Promise<Response>, options?: StagedReadOptions): Promise<Response>;
1652
+ /** Resolves at once when the device has a network, else when it is back (or the time is over). */
1653
+ declare function whenOnline(signal?: AbortSignal, deadline?: number): Promise<void>;
1330
1654
 
1331
1655
  declare class RemoteListService {
1332
1656
  /** The signed-in user (claims + token), set by the app; used when a caller has none. */
@@ -1367,5 +1691,389 @@ declare const BACKEND_PROXY_PREFIX = "/api/proxy";
1367
1691
  */
1368
1692
  declare function backendUrl(url: string): string;
1369
1693
 
1370
- export { AppVersionResetService, BACKEND_PROXY_PREFIX, CardComponent, ConfigService, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, FormComponent, GridComponent, HeaderMenuComponent, LogsComponent, MediaSourcePipe, MobileKeycloakService, MobileOidcService, MobileOktaService, ModelComponent, NetworkLogService, NotificationService, PaginationComponent, PlaceholderPipe, REQUEST_STAGES, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, SIDE_DOCK_CLASS, SideMenuComponent, UtilityService, ViewToolkitModule, backendUrl, isNativeMobile, isNativePhone, normalizeCustomKeyboardType, resolveCustomKeyboardType, resolvePlaceholder, setToolkitKeyboardOnWeb, sideDockWidth, stagedRequest, toolkitKeyboardActive };
1371
- export type { CustomKeyboardTarget, CustomKeyboardType, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, OidcProvider, OidcRefresh, OidcTokens, RequestTimeoutMessages };
1694
+ interface NumberShape {
1695
+ style: 'decimal' | 'currency' | 'percent' | 'unit';
1696
+ currency: string | null;
1697
+ unit: string | null;
1698
+ /** translation key of a custom unit, or the translated text */
1699
+ unitLabel: string | null;
1700
+ minFraction: number | null;
1701
+ maxFraction: number | null;
1702
+ grouping: boolean;
1703
+ /** stored as an integer in the currency's minor units (cents) */
1704
+ minorUnits: boolean;
1705
+ }
1706
+ /**
1707
+ * The shape of a number field. row: the record the field belongs to (grid row, card record) or the
1708
+ * object's properties ({ name: { value } }) - for currencyField.
1709
+ */
1710
+ declare function numberShape(field: any, property?: any, row?: any): NumberShape;
1711
+ /** Decimal places of a currency (EUR 2, JPY 0). */
1712
+ declare function currencyDigits(currency: string): number;
1713
+ /** The stored value as the number the user sees and types (cents -> euros, 0.125 -> 12.5 %). */
1714
+ declare function storedToTyped(value: any, shape: NumberShape): number | null;
1715
+ /** The typed number as it is stored (euros -> cents as an integer, 12.5 % -> 0.125). */
1716
+ declare function typedToStored(typed: any, shape: NumberShape): number | null;
1717
+ /** A stored number shown in the app language: "1.234,50 €", "12,5 %", "5 kg", "1.234,5". */
1718
+ declare function displayNumber(value: any, shape: NumberShape, translations?: Record<string, string> | null, languageCode?: string): string;
1719
+ /** The sign beside the input: "€", "%", "kg", the custom unit's text, or ''. */
1720
+ declare function numberSuffix(shape: NumberShape, translations?: Record<string, string> | null, languageCode?: string): string;
1721
+ /** The input's step: the field's step, else one cent for a currency, else 1. */
1722
+ declare function numberStep(field: any, shape: NumberShape, integer: boolean): number | 'any';
1723
+
1724
+ declare function visibleFields(fields: any[] | null | undefined): any[];
1725
+ declare class VisiblePipe implements PipeTransform {
1726
+ transform(fields: any[] | null | undefined): any[];
1727
+ static ɵfac: i0.ɵɵFactoryDeclaration<VisiblePipe, never>;
1728
+ static ɵpipe: i0.ɵɵPipeDeclaration<VisiblePipe, "vlVisible", true>;
1729
+ }
1730
+
1731
+ declare class RulesPipe implements PipeTransform {
1732
+ transform(field: any): FieldRules;
1733
+ static ɵfac: i0.ɵɵFactoryDeclaration<RulesPipe, never>;
1734
+ static ɵpipe: i0.ɵɵPipeDeclaration<RulesPipe, "vlRules", true>;
1735
+ }
1736
+
1737
+ declare class PasswordControl {
1738
+ /** the field of the layout (scope, option, label) */
1739
+ field: any;
1740
+ /** editing: the object whose value is the password (the property in the property schema) */
1741
+ target: any;
1742
+ /** reading: the value to show (a card's record) */
1743
+ value: any;
1744
+ readonly: boolean;
1745
+ /** set by the container after a save attempt */
1746
+ saveTried: boolean;
1747
+ errorMessages: any;
1748
+ translations: Record<string, string> | null;
1749
+ inputStyle: any;
1750
+ inputClass: string;
1751
+ visible: boolean;
1752
+ /** the input's model, for the error line */
1753
+ private control?;
1754
+ dots(value: any): string;
1755
+ placeholder(): string;
1756
+ /** the error line: after typing and leaving, or after a save attempt (as everywhere) */
1757
+ pwShown(): boolean;
1758
+ message(): string;
1759
+ static ɵfac: i0.ɵɵFactoryDeclaration<PasswordControl, never>;
1760
+ static ɵcmp: i0.ɵɵComponentDeclaration<PasswordControl, "vl-password", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputClass": { "alias": "inputClass"; "required": false; }; }, {}, never, never, true, never>;
1761
+ }
1762
+
1763
+ declare class TextareaControl {
1764
+ /** the field of the layout (scope, option, label) */
1765
+ field: any;
1766
+ /** editing: the object whose value is the text (the property in the property schema) */
1767
+ target: any;
1768
+ /** reading: the text to show (a card's record) */
1769
+ value: any;
1770
+ readonly: boolean;
1771
+ /** in a grid cell: one line with an ellipsis, the whole text as tooltip */
1772
+ compact: boolean;
1773
+ /** the toolkit keyboard (the container's keyboardTypeFor) */
1774
+ keyboard: string | null;
1775
+ saveTried: boolean;
1776
+ errorMessages: any;
1777
+ translations: Record<string, string> | null;
1778
+ inputStyle: any;
1779
+ inputClass: string;
1780
+ private control?;
1781
+ lines(): number;
1782
+ placeholder(): string;
1783
+ showError(): boolean;
1784
+ message(): string;
1785
+ static ɵfac: i0.ɵɵFactoryDeclaration<TextareaControl, never>;
1786
+ static ɵcmp: i0.ɵɵComponentDeclaration<TextareaControl, "vl-textarea", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "compact": { "alias": "compact"; "required": false; }; "keyboard": { "alias": "keyboard"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputClass": { "alias": "inputClass"; "required": false; }; }, {}, never, never, true, never>;
1787
+ }
1788
+
1789
+ declare class SwitchControl {
1790
+ /** the field of the layout (scope, option, label) */
1791
+ field: any;
1792
+ /** the object whose value is switched (the property in the property schema) */
1793
+ target: any;
1794
+ /** reading: the value to show (a card's record) instead of target.value */
1795
+ value: any;
1796
+ readonly: boolean;
1797
+ /** the property's type: "boolean", or a two-value text */
1798
+ type: string;
1799
+ translations: Record<string, string> | null;
1800
+ /** after a change (the containers recalculate, e.g. setformData) */
1801
+ switched: EventEmitter<any>;
1802
+ private get option();
1803
+ private get current();
1804
+ get on(): boolean;
1805
+ set(on: boolean): void;
1806
+ get captionLeft(): boolean;
1807
+ get caption(): string;
1808
+ static ɵfac: i0.ɵɵFactoryDeclaration<SwitchControl, never>;
1809
+ static ɵcmp: i0.ɵɵComponentDeclaration<SwitchControl, "vl-switch", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "type": { "alias": "type"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; }, { "switched": "switched"; }, never, never, true, never>;
1810
+ }
1811
+
1812
+ declare class RadioControl {
1813
+ field: any;
1814
+ target: any;
1815
+ value: any;
1816
+ readonly: boolean;
1817
+ /** the property's type ("boolean" gives true/false) */
1818
+ type: string;
1819
+ saveTried: boolean;
1820
+ errorMessages: any;
1821
+ translations: Record<string, string> | null;
1822
+ chosen: EventEmitter<any>;
1823
+ private buttons?;
1824
+ get horizontal(): boolean;
1825
+ choices(): any[];
1826
+ caption(value: any): string;
1827
+ private get control();
1828
+ showError(): boolean;
1829
+ message(): string;
1830
+ static ɵfac: i0.ɵɵFactoryDeclaration<RadioControl, never>;
1831
+ static ɵcmp: i0.ɵɵComponentDeclaration<RadioControl, "vl-radio", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "type": { "alias": "type"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; }, { "chosen": "chosen"; }, never, never, true, never>;
1832
+ }
1833
+
1834
+ declare class NumberControl {
1835
+ field: any;
1836
+ target: any;
1837
+ value: any;
1838
+ readonly: boolean;
1839
+ /** the property's type: "integer" takes whole steps only */
1840
+ type: string;
1841
+ keyboard: string | null;
1842
+ saveTried: boolean;
1843
+ errorMessages: any;
1844
+ translations: Record<string, string> | null;
1845
+ inputStyle: any;
1846
+ inputClass: string;
1847
+ /** the property of the data object (older layouts: its currency) */
1848
+ property: any;
1849
+ /** the record the field belongs to, for a currency taken from another field */
1850
+ row: any;
1851
+ changed: EventEmitter<any>;
1852
+ private control?;
1853
+ get kind(): 'spinner' | 'slider' | 'plain';
1854
+ get shape(): NumberShape;
1855
+ get step(): number | 'any';
1856
+ get sliderStep(): number;
1857
+ get rangeMin(): number;
1858
+ get rangeMax(): number;
1859
+ stepBy(direction: 1 | -1): void;
1860
+ /** the number the user sees and types (cents as euros, 0.125 as 12.5) */
1861
+ typed(): number | null;
1862
+ set(typed: any): void;
1863
+ suffix(): string;
1864
+ shown(value: any): string;
1865
+ placeholder(): string;
1866
+ showError(): boolean;
1867
+ message(): string;
1868
+ static ɵfac: i0.ɵɵFactoryDeclaration<NumberControl, never>;
1869
+ static ɵcmp: i0.ɵɵComponentDeclaration<NumberControl, "vl-number", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "type": { "alias": "type"; "required": false; }; "keyboard": { "alias": "keyboard"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputClass": { "alias": "inputClass"; "required": false; }; "property": { "alias": "property"; "required": false; }; "row": { "alias": "row"; "required": false; }; }, { "changed": "changed"; }, never, never, true, never>;
1870
+ }
1871
+
1872
+ declare class CheckboxControl {
1873
+ field: any;
1874
+ /** the object holding the value (the property, or a grid row with key) */
1875
+ target: any;
1876
+ /** the name of the value in target ("value" for a property, the field name for a grid row) */
1877
+ key: string;
1878
+ /** reading: the value to show instead of target[key] */
1879
+ value: any;
1880
+ readonly: boolean;
1881
+ /** "boolean", or a two-value text */
1882
+ type: string;
1883
+ /** the text beside the box (the field's caption); empty for none */
1884
+ caption: string;
1885
+ saveTried: boolean;
1886
+ errorMessages: any;
1887
+ translations: Record<string, string> | null;
1888
+ inputStyle: any;
1889
+ toggled: EventEmitter<any>;
1890
+ private control?;
1891
+ private get option();
1892
+ private get current();
1893
+ get checked(): boolean;
1894
+ set(on: boolean): void;
1895
+ get captionLeft(): boolean;
1896
+ showError(): boolean;
1897
+ message(): string;
1898
+ static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxControl, never>;
1899
+ static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxControl, "vl-checkbox", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "key": { "alias": "key"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "type": { "alias": "type"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; }, { "toggled": "toggled"; }, never, never, true, never>;
1900
+ }
1901
+
1902
+ declare class DateTimeControl {
1903
+ readonly picker: DateTimePickerService;
1904
+ field: any;
1905
+ target: any;
1906
+ /** the property of the data object (its picker pattern counts) */
1907
+ property: any;
1908
+ kind: 'date' | 'time' | 'datetime';
1909
+ value: any;
1910
+ readonly: boolean;
1911
+ keyboard: string | null;
1912
+ saveTried: boolean;
1913
+ errorMessages: any;
1914
+ translations: Record<string, string> | null;
1915
+ inputStyle: any;
1916
+ inputClass: string;
1917
+ changed: EventEmitter<any>;
1918
+ /** the calendar or clock opened */
1919
+ opened: EventEmitter<void>;
1920
+ private control?;
1921
+ /** PrimeNG pattern of the date part (de dd.mm.yy = dd.mm.yyyy) */
1922
+ pattern(): string;
1923
+ /** "12" (en, AM/PM) or "24" - by the app language */
1924
+ hourFormat(): '12' | '24';
1925
+ placeholder(): string;
1926
+ /** typed digits shaped into the pattern, like the toolkit keyboard does */
1927
+ typing(event: any): void;
1928
+ shown(value: any): string;
1929
+ showError(): boolean;
1930
+ message(): string;
1931
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateTimeControl, never>;
1932
+ static ɵcmp: i0.ɵɵComponentDeclaration<DateTimeControl, "vl-datetime", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "property": { "alias": "property"; "required": false; }; "kind": { "alias": "kind"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "keyboard": { "alias": "keyboard"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputClass": { "alias": "inputClass"; "required": false; }; }, { "changed": "changed"; "opened": "opened"; }, never, never, true, never>;
1933
+ }
1934
+
1935
+ declare class DateRangeControl implements OnChanges {
1936
+ field: any;
1937
+ /** the property holding the pair [from, to] in value */
1938
+ target: any;
1939
+ value: any;
1940
+ readonly: boolean;
1941
+ keyboard: string | null;
1942
+ saveTried: boolean;
1943
+ errorMessages: any;
1944
+ translations: Record<string, string> | null;
1945
+ inputStyle: any;
1946
+ inputClass: string;
1947
+ changed: EventEmitter<any>;
1948
+ from: {
1949
+ value: any;
1950
+ };
1951
+ to: {
1952
+ value: any;
1953
+ };
1954
+ fromField: any;
1955
+ toField: any;
1956
+ ngOnChanges(): void;
1957
+ update(): void;
1958
+ private time;
1959
+ wrongOrder(): boolean;
1960
+ orderMessage(): string;
1961
+ shown(value: any): string;
1962
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateRangeControl, never>;
1963
+ static ɵcmp: i0.ɵɵComponentDeclaration<DateRangeControl, "vl-daterange", never, { "field": { "alias": "field"; "required": false; }; "target": { "alias": "target"; "required": false; }; "value": { "alias": "value"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "keyboard": { "alias": "keyboard"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "translations": { "alias": "translations"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputClass": { "alias": "inputClass"; "required": false; }; }, { "changed": "changed"; }, never, never, true, never>;
1964
+ }
1965
+
1966
+ type MediaKind = 'image' | 'video' | 'audio' | 'pdf' | 'file';
1967
+ /** What a media source is: by its data: type, else by the file extension; image when unknown. */
1968
+ declare function mediaKind(source: string, ...names: any[]): MediaKind;
1969
+ declare class MediaControl {
1970
+ private readonly sanitizer;
1971
+ private trustedCache;
1972
+ field: any;
1973
+ /** the field's value: a URL, a file name of the project's Media/, or a data: URL */
1974
+ value: any;
1975
+ /** the property of the data object (its caption, default) */
1976
+ property: any;
1977
+ /** grid cells and cards: a thumbnail or symbol, the large view on tap */
1978
+ compact: boolean;
1979
+ mediaStyle: any;
1980
+ mediaClass: string;
1981
+ /** a tap on an image (the containers' image action) */
1982
+ clicked: EventEmitter<void>;
1983
+ large: boolean;
1984
+ source(): string;
1985
+ kind(): MediaKind;
1986
+ label(): string;
1987
+ symbolClass(): string;
1988
+ /** the resolved link as a frame source - the same object for the same link */
1989
+ trusted(url: string): SafeResourceUrl;
1990
+ static ɵfac: i0.ɵɵFactoryDeclaration<MediaControl, never>;
1991
+ static ɵcmp: i0.ɵɵComponentDeclaration<MediaControl, "vl-media", never, { "field": { "alias": "field"; "required": false; }; "value": { "alias": "value"; "required": false; }; "property": { "alias": "property"; "required": false; }; "compact": { "alias": "compact"; "required": false; }; "mediaStyle": { "alias": "mediaStyle"; "required": false; }; "mediaClass": { "alias": "mediaClass"; "required": false; }; }, { "clicked": "clicked"; }, never, never, true, never>;
1992
+ }
1993
+
1994
+ /** The building blocks <vl-control> draws a field with. */
1995
+ type ControlKind = 'button' | 'media' | 'creditCard' | 'text' | 'password' | 'textarea' | 'autocomplete' | 'combobox' | 'dropdown' | 'radio' | 'checkbox' | 'switch' | 'number' | 'date' | 'time' | 'datetime' | 'daterange';
1996
+ /** The property a field is bound to (scope.reference) in the page's property schema, or undefined. */
1997
+ declare function controlProperty(field: any, propertySchema: any): any;
1998
+ /**
1999
+ * The building block of a field:
2000
+ * - no scope.reference: a button (layout field without a property)
2001
+ * - the property type decides media, credit card and the period (dateRange)
2002
+ * - otherwise the control (option.control, or the field catalog's choice for the type)
2003
+ */
2004
+ declare function controlKind(field: any, property: any): ControlKind;
2005
+ /**
2006
+ * A style object of the layout split into its classes and its CSS: { classes: ['a', 'b'], color }
2007
+ * -> { classes: 'a b', style: { color } }. Every class counts, not only the first.
2008
+ */
2009
+ declare function styleParts(styleObject: any): {
2010
+ classes: string;
2011
+ style: Record<string, any>;
2012
+ };
2013
+
2014
+ declare class ControlComponent implements OnChanges {
2015
+ /** the field of the layout (formField) */
2016
+ field: any;
2017
+ /** the page's property schema: { workOrder: { fromDate: { type, value, ... } } } */
2018
+ propertySchema: any;
2019
+ /** the project's language: selectedLanguage (translations), errorMessages */
2020
+ selectedLanguageInfo: any;
2021
+ /** the container's own error texts, when the project has none */
2022
+ errorMessages: any;
2023
+ /** set by the container after a save attempt: messages show then even for untouched fields */
2024
+ saveTried: boolean;
2025
+ /** the label rule of the container: 'dialog' (the layout's layoutStyle) or 'form' */
2026
+ container: 'dialog' | 'form';
2027
+ /** an entry of an autocomplete or combobox list was chosen */
2028
+ picked: EventEmitter<any>;
2029
+ /** a date, time or period was set */
2030
+ changed: EventEmitter<any>;
2031
+ /** a time picker opened */
2032
+ opened: EventEmitter<void>;
2033
+ /** a check box, switch or radio button changed */
2034
+ toggled: EventEmitter<any>;
2035
+ /** a button was clicked; its option (innerAction, action ...) */
2036
+ buttonClick: EventEmitter<any>;
2037
+ kind: ControlKind;
2038
+ property: any;
2039
+ /** the property's object ({ fromDate: {...}, toDate: {...} }), for amounts with a currency field */
2040
+ row: any;
2041
+ keyboard: CustomKeyboardType | null;
2042
+ /** vl-textbox reads the property schema from a container info */
2043
+ textboxInfo: any;
2044
+ readonly vlAction: typeof testAction;
2045
+ readonly vlWrites: typeof testWrites;
2046
+ ngOnChanges(): void;
2047
+ /** protected in the layout: the value is shown, not typed in */
2048
+ get readonly(): boolean;
2049
+ /** the property the control writes into ({} so a control never writes into undefined) */
2050
+ get target(): any;
2051
+ get translations(): Record<string, string> | null;
2052
+ get messages(): any;
2053
+ /** label.value, the layout's label.caption, then the data object's caption - translated */
2054
+ get label(): string;
2055
+ /** a check box carries its own caption; every other control gets the label above or beside it */
2056
+ get showLabel(): boolean;
2057
+ /** text flag (string "Y"/"N" ...) or Boolean, for check box, switch and radio buttons */
2058
+ get toggleType(): string;
2059
+ innerStyle(): Record<string, any>;
2060
+ labelStyle(): {
2061
+ classes: string;
2062
+ style: Record<string, any>;
2063
+ };
2064
+ /** scope.style: the input's own style in the layout (the Designer's "input" style) */
2065
+ inputStyle(): {
2066
+ classes: string;
2067
+ style: Record<string, any>;
2068
+ };
2069
+ /** a button has no input; the field's style is the button's */
2070
+ buttonStyle(): {
2071
+ classes: string;
2072
+ style: Record<string, any>;
2073
+ };
2074
+ static ɵfac: i0.ɵɵFactoryDeclaration<ControlComponent, never>;
2075
+ static ɵcmp: i0.ɵɵComponentDeclaration<ControlComponent, "vl-control", never, { "field": { "alias": "field"; "required": false; }; "propertySchema": { "alias": "propertySchema"; "required": false; }; "selectedLanguageInfo": { "alias": "selectedLanguageInfo"; "required": false; }; "errorMessages": { "alias": "errorMessages"; "required": false; }; "saveTried": { "alias": "saveTried"; "required": false; }; "container": { "alias": "container"; "required": false; }; }, { "picked": "picked"; "changed": "changed"; "opened": "opened"; "toggled": "toggled"; "buttonClick": "buttonClick"; }, never, never, true, never>;
2076
+ }
2077
+
2078
+ export { AppVersionResetService, Autocomplete, BACKEND_PROXY_PREFIX, CardComponent, CheckboxControl, ConfigService, ControlComponent, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, DateFormatPipe, DateHintPipe, DateRangeControl, DateTextPipe, DateTimeControl, DropdownControl, FormComponent, GridComponent, HeaderMenuComponent, LogsComponent, MediaControl, MediaSourcePipe, MobileKeycloakService, MobileOidcService, MobileOktaService, ModelComponent, NetworkLogService, NotificationService, NumberControl, PaginationComponent, PasswordControl, PlaceholderPipe, READ_ATTEMPT_TIMEOUT, REQUEST_STAGES, RETRY_PAUSES, RETRY_STATUSES, RadioControl, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, RulesPipe, SIDE_DOCK_CLASS, SideMenuComponent, SwitchControl, TextareaControl, Textbox, UtilityService, ViewToolkitModule, VisiblePipe, backendUrl, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, displayDateValue, displayNumber, fieldInnerLayoutStyle, fieldModel, fieldRules, fixedTimeText, inputFormatHint, isNativeMobile, isNativePhone, languageDatePattern, layoutPlaceholder, mediaKind, normalizeCustomKeyboardType, numberShape, numberStep, numberSuffix, primeDatePattern, resolveCustomKeyboardType, resolvePlaceholder, ruleMessage, setDateLanguage, setInputHintLanguage, setToolkitKeyboardOnWeb, shapeDateDigits, shapeTimeText, sideDockWidth, splitReference, stagedRead, stagedRequest, storedToTyped, styleParts, testAction, testFieldKey, testWrites, timeHourFormat, toggleMeridiem, toolkitKeyboardActive, typedToStored, usesTwelveHours, visibleFields, whenOnline };
2079
+ export type { ControlKind, CustomKeyboardTarget, CustomKeyboardType, FieldKind, FieldModel, FieldRules, MediaKind, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, NumberShape, OidcProvider, OidcRefresh, OidcTokens, RequestTimeoutMessages, StagedReadOptions };