@yomotech/view-toolkit 1.0.35 → 1.0.38

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;
@@ -73,7 +156,7 @@ declare class UtilityService {
73
156
  authParams: {
74
157
  pkce: boolean;
75
158
  issuer: any;
76
- scopes: any;
159
+ scopes: string[] | undefined;
77
160
  };
78
161
  };
79
162
  setOktaMobileCredential(environment: any): {
@@ -85,6 +168,8 @@ declare class UtilityService {
85
168
  responseType: any;
86
169
  pkceEnabled: any;
87
170
  };
171
+ /** OAuth scopes as the list okta-auth-js expects; undefined lets it use its default. */
172
+ private oauthScopeList;
88
173
  /** OAuth scope as the space separated string the OAuth2 plugin expects. */
89
174
  private oauthScope;
90
175
  setupStripePaymentForm(environment: any, form: any, onCardChange: (message: string) => void): Promise<void>;
@@ -131,8 +216,37 @@ declare class Couchdb {
131
216
  * classifying it as text would change the shape they receive.
132
217
  */
133
218
  private isTextFile;
219
+ /** Ids of the files under a folder of the project, e.g. listFiles(db, 'ssl/mobile/'). Empty on any error. */
220
+ listFiles(dbName: string, prefix: string): Promise<string[]>;
134
221
  private getDocumentUrl;
135
222
  private getDbUrl;
223
+ private isAttachmentMedia;
224
+ /** Signed links by "db/doc/name", reused until a minute before they run out. */
225
+ private mediaLinks;
226
+ /**
227
+ * A signed link for one media attachment (#145). A <video>/<audio src> sends no tenant header,
228
+ * so POST /media-token is asked with it instead - the same header every read already carries,
229
+ * nothing else is needed - and answers the path it signed plus a token for that one file
230
+ * (8 hours). The player then reads couchdb.yomotech.de<path>?token=... with Range itself.
231
+ */
232
+ getMediaStreamUrl(dbName: string, docId: string, name: string): Promise<string>;
233
+ /**
234
+ * What a media field holds, made playable: a URL (http, https, data, blob) stays as it is; a
235
+ * file name ("clip.mp4", also "Media/clip.mp4") is read from Media/ of the selected project -
236
+ * a signed link for an attachment, a data URL for an older Base64 document. '' when unknown.
237
+ */
238
+ resolveMediaSource(source: string): Promise<string>;
239
+ /** Media prepared at the start, by "db/name": an object URL (loaded whole) or a signed link. */
240
+ private preloadedMedia;
241
+ /**
242
+ * Prepares the project's video and audio at the start of the app, in the background (#145): only
243
+ * the files in environments/media.json - the media the pages use, written by the Designer on
244
+ * export; without that list nothing is preloaded. Per file the signed link; a file up to maxBytes
245
+ * (20 MB) is loaded whole and kept as an object URL, so Play starts at once and without network. A
246
+ * larger one keeps only the link. A failure is no error for the app: resolveMediaSource then asks
247
+ * for the link as before.
248
+ */
249
+ preloadProjectMedia(dbName: string, maxBytes?: number): Promise<void>;
136
250
  private getReadHeaders;
137
251
  private buildTenantHeaders;
138
252
  getImageSrcFromCouchDb(couchDbName: string, filePath: string): Promise<string>;
@@ -181,14 +295,6 @@ declare class NotificationService {
181
295
  static ɵprov: i0.ɵɵInjectableDeclaration<NotificationService>;
182
296
  }
183
297
 
184
- type CustomKeyboardType = 'email' | 'numeric' | 'alpha' | 'string' | 'date' | 'time';
185
- declare function normalizeCustomKeyboardType(value: unknown): CustomKeyboardType | null;
186
- /**
187
- * Keyboard for a field: option.keyboardType when the layout sets one, otherwise derived from the
188
- * attribute (property schema) type. Returns null where the system keyboard stays in charge.
189
- */
190
- declare function resolveCustomKeyboardType(option: any, property: any): CustomKeyboardType | null;
191
-
192
298
  type CustomKeyboardTarget = HTMLInputElement | HTMLTextAreaElement;
193
299
  interface CustomKeyboardSession {
194
300
  target: CustomKeyboardTarget;
@@ -258,6 +364,12 @@ declare class CustomKeyboardService {
258
364
  insert(character: string): void;
259
365
  backspace(): void;
260
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;
261
373
  close(option?: {
262
374
  blurTarget?: boolean;
263
375
  restoreAccessoryBar?: boolean;
@@ -281,7 +393,12 @@ declare class CustomKeyboardService {
281
393
  private updateDateTimeTarget;
282
394
  /** String position right after the given number of digits, separators included. */
283
395
  private positionAfterDigits;
284
- 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;
285
402
  private formatTimeDigits;
286
403
  beginPickerOverlay(): void;
287
404
  endPickerOverlay(option?: {
@@ -321,9 +438,9 @@ declare class CustomKeyboardService {
321
438
  declare class DateTimePickerService {
322
439
  private readonly keyboard;
323
440
  /** On the devices the date picker docks at the bottom like a keyboard; in a browser it drops down. */
324
- readonly isNativeMobile: boolean;
441
+ get isNativeMobile(): boolean;
325
442
  /** panelStyleClass of a date picker. */
326
- readonly datePanelClass: string;
443
+ get datePanelClass(): string;
327
444
  /** panelStyleClass of a time picker: compact and attached to its field everywhere. */
328
445
  readonly timePanelClass = "model-datepicker-panel model-timepicker-panel";
329
446
  /**
@@ -331,7 +448,7 @@ declare class DateTimePickerService {
331
448
  * wrapper around the panel, and a transformed wrapper becomes the reference of the panel's
332
449
  * position: fixed - the docked calendar flew up next to its field while closing.
333
450
  */
334
- readonly dockedMotion: {
451
+ get dockedMotion(): {
335
452
  disabled: boolean;
336
453
  } | undefined;
337
454
  private activePicker;
@@ -412,10 +529,13 @@ declare class CardComponent {
412
529
  private notificationService;
413
530
  private oauthService;
414
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;
415
536
  private readonly remoteLists;
416
537
  /** Loaded lists by field reference. */
417
538
  remoteData: Record<string, any[]>;
418
- private readonly cardRemoteData;
419
539
  /** Current suggestions of an autocomplete by field reference. */
420
540
  remoteSuggestions: Record<string, any[]>;
421
541
  /** Loads every backend list the given layout nodes describe; dropdown/combobox get their items. */
@@ -424,9 +544,12 @@ declare class CardComponent {
424
544
  completeRemote(event: any, node: any): void;
425
545
  /** Date and time picker behaviour shared by all containers. */
426
546
  readonly picker: DateTimePickerService;
547
+ private readonly keyboard;
427
548
  private readonly pickerHost;
428
549
  /** Keep existing checkbox data objects usable; new objects use boolean. */
429
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';
430
553
  itemInfo: any;
431
554
  currentPage: number;
432
555
  pageSize: number;
@@ -516,32 +639,20 @@ declare class CardComponent {
516
639
  getMediaSource(layout: any, record: any): string;
517
640
  getMediaLabel(layout: any): string;
518
641
  getMediaKind(layout: any, record: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
519
- cardProperty(node: any): any;
520
- cardControlProperty(node: any): any;
521
- cardType(node: any): string;
522
- isSharedCardField(node: any): boolean;
523
- isCardGroup(node: any): boolean;
524
- isCardTitle(node: any, area: string): boolean;
525
- cardFieldValue(node: any, record?: any): any;
526
- cardFieldCaption(node: any): string;
527
- protectedCardValue(node: any, record: any, nested: boolean): string;
528
- private readonly emptyCardItems;
529
- cardFieldItems(node: any): any[] | undefined;
530
- cardGroupStyle(node: any): Record<string, any>;
531
- cardFieldWrapperStyle(node: any, nested: boolean, area: string): Record<string, any>;
532
- private readonly rendererFields;
533
- cardRendererField(node: any, area: string): any;
534
- private cardAccess;
535
- onCardFieldChange(node: any, value: any, record?: any, area?: string): void;
536
- onCardItemSelected(node: any, item: any, record?: any): void;
537
- private cardChangeQueued;
538
- private cardDestroyed;
539
- private scheduleCardDataChange;
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;
540
647
  static ɵfac: i0.ɵɵFactoryDeclaration<CardComponent, never>;
541
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>;
542
649
  }
543
650
 
544
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;
545
656
  private readonly remoteLists;
546
657
  /** Loaded lists by field reference. */
547
658
  remoteData: Record<string, any[]>;
@@ -549,6 +660,15 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
549
660
  remoteSuggestions: Record<string, any[]>;
550
661
  /** Loads every backend list the given layout nodes describe; dropdown/combobox get their items. */
551
662
  loadRemoteLists(nodes: any[], propertySchema: any): Promise<void>;
663
+ /** Backend lists still on the way, by field reference. */
664
+ remoteLoading: Record<string, boolean>;
665
+ private lastRemoteQuery;
666
+ /**
667
+ * What an autocomplete shows when it has no entries: "loading" while its list is on the way,
668
+ * "no results" after - in the project's language (autocompleteLoading, autocompleteNoResults),
669
+ * English when the project has no text for it.
670
+ */
671
+ autocompleteEmptyText(node: any): string;
552
672
  /** (completeMethod) of an autocomplete with a backend list. */
553
673
  completeRemote(event: any, node: any): void;
554
674
  /** Date and time picker behaviour shared by all containers. */
@@ -556,7 +676,7 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
556
676
  private readonly host;
557
677
  ngOnDestroy(): void;
558
678
  /** Keep existing checkbox data objects usable; new objects use boolean. */
559
- renderFieldType(type: string | undefined): string | undefined;
679
+ renderFieldType(type: string | undefined, field?: any): string | undefined;
560
680
  customEmailPattern: string;
561
681
  showPassword: boolean;
562
682
  formCopy: any;
@@ -578,7 +698,7 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
578
698
  };
579
699
  getSectionBodyStyle(formSection: any): any;
580
700
  getFieldWrapperStyle(formField: any): any;
581
- getFieldInnerLayoutStyle(formField: any): any;
701
+ getFieldInnerLayoutStyle(formField: any): Record<string, any>;
582
702
  getScope(scope: any): string;
583
703
  togglePasswordVisibility(): void;
584
704
  invokeFormBtnClick(option: any, propertySchema: any): void;
@@ -597,6 +717,20 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
597
717
  getMediaSource(field: any): string;
598
718
  getMediaLabel(field: any): string;
599
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;
600
734
  static ɵfac: i0.ɵɵFactoryDeclaration<FormComponent, never>;
601
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>;
602
736
  }
@@ -706,6 +840,29 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
706
840
  getMediaSource(col: any, data: any): string;
707
841
  getMediaLabel(col: any): string;
708
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;
709
866
  static ɵfac: i0.ɵɵFactoryDeclaration<GridComponent, never>;
710
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>;
711
868
  }
@@ -716,6 +873,10 @@ declare class HeaderMenuComponent implements AfterViewInit {
716
873
  private utilityService;
717
874
  private couchdbService;
718
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;
719
880
  isLogined: boolean;
720
881
  propertyschema: any;
721
882
  headerItems: any[];
@@ -767,9 +928,13 @@ declare class ModelComponent implements OnChanges, OnDestroy {
767
928
  private readonly dialogRef;
768
929
  private readonly dialogConfig;
769
930
  private utilityService;
931
+ /** Marks for the app's test runner (#166): field key and button action. */
932
+ readonly vlFieldKey: typeof testFieldKey;
933
+ readonly vlAction: typeof testAction;
934
+ readonly vlWrites: typeof testWrites;
770
935
  private readonly remoteLists;
771
936
  /** Keep existing checkbox data objects usable; new objects use boolean. */
772
- renderFieldType(type: string | undefined): string | undefined;
937
+ renderFieldType(type: string | undefined, field?: any): string | undefined;
773
938
  /** Date and time picker behaviour shared by all containers. */
774
939
  readonly picker: DateTimePickerService;
775
940
  private readonly host;
@@ -802,10 +967,18 @@ declare class ModelComponent implements OnChanges, OnDestroy {
802
967
  resolveToken(template: string, context: any): string;
803
968
  buildCompany(userInfo: any): string;
804
969
  getScope(scope: any): string;
970
+ /** The autocomplete asked last, so a list that arrives later can still be shown for it. */
971
+ private lastAutocomplete;
972
+ /**
973
+ * What an autocomplete shows when it has no entries: "loading" while its list is on the way,
974
+ * "no results" after. In the project's language (languages/<code>.json: autocompleteLoading,
975
+ * autocompleteNoResults), English when the project has no text for it.
976
+ */
977
+ autocompleteEmptyText(formField: any): string;
805
978
  autocompChangeEvent(event: any, formField: any): void;
806
979
  autocompFocusOutEvent(event: any, formField: any): void;
807
980
  autocompSelectEvent(obj: any, formField?: any): void;
808
- setErroMessage(formField: any, errorMessages: any, errorType: any): any;
981
+ setErroMessage(formField: any, errorMessages: any, errorType: any): string;
809
982
  getStyleWithoutClasses(styleObject: any): {
810
983
  classes: any;
811
984
  style: any;
@@ -823,7 +996,6 @@ declare class ModelComponent implements OnChanges, OnDestroy {
823
996
  resetRule(rule: any, formField: any): void;
824
997
  isRuleTriggered(rule: any, formField: any): boolean;
825
998
  applyDurationRule(rule: any, formField: any): void;
826
- private ruleClock;
827
999
  invokeSetformData(): void;
828
1000
  invokeFormBtnClick(option: any, propertySchema: any, form: NgForm): void;
829
1001
  checkValidty(form: NgForm): boolean;
@@ -832,11 +1004,13 @@ declare class ModelComponent implements OnChanges, OnDestroy {
832
1004
  getMediaSource(field: any): string;
833
1005
  getMediaLabel(field: any): string;
834
1006
  getMediaKind(field: any): 'image' | 'video' | 'audio' | 'pdf' | 'file';
835
- sharedErrorsVisible: boolean;
836
- sharedProperty(field: any): any;
837
- usesSharedField(field: any): boolean;
838
- private initializeSharedDefaults;
839
- onSharedFieldChange(field: any, value: any): void;
1007
+ /**
1008
+ * A field's message shows once the user typed in it and left it, or after a save attempt - not
1009
+ * when an empty field was only passed through (the message then pushed the row and its label out
1010
+ * of line). #166
1011
+ */
1012
+ saveTried: boolean;
1013
+ showError(control: any): boolean;
840
1014
  static ɵfac: i0.ɵɵFactoryDeclaration<ModelComponent, never>;
841
1015
  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>;
842
1016
  }
@@ -1075,24 +1249,53 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
1075
1249
  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>;
1076
1250
  }
1077
1251
 
1078
- declare class Autocomplete {
1079
- formField: any;
1080
- modalItemInfo: any;
1081
- matchData: any;
1082
- selectedLanguageInfo: any;
1252
+ declare class Autocomplete implements OnChanges {
1253
+ /** the field of the layout (scope, option, label) */
1254
+ field: any;
1255
+ /** editing: the object whose value is the choice (the property in the property schema) */
1256
+ target: any;
1257
+ /** reading: the text to show (a card's record) */
1258
+ value: any;
1259
+ readonly: boolean;
1260
+ /** the loaded entries of the field's source and whether they are still on the way */
1261
+ list: any[] | null | undefined;
1262
+ loading: boolean;
1263
+ /** combobox: the same list, values outside it only with option.allowCustom */
1264
+ combobox: boolean;
1265
+ /** the toolkit keyboard (the container's keyboardTypeFor) */
1266
+ keyboard: string | null;
1267
+ saveTried: boolean;
1083
1268
  errorMessages: any;
1084
- autocompChange: EventEmitter<any>;
1085
- autocompFocusOut: EventEmitter<any>;
1086
- autocompChangeEvent(event: any, formField: any): void;
1087
- autocompFocusOutEvent(event: any, formField: any): void;
1088
- getScope(scope: any): string;
1089
- getStyleWithoutClasses(styleObject: any): {
1090
- classes: any;
1091
- style: any;
1092
- };
1093
- setErroMessage(formField: any, errorMessages: any, errorType: any): any;
1269
+ /** the project's texts in the selected language (placeholder keys, loading / no results) */
1270
+ translations: Record<string, string> | null;
1271
+ inputStyle: any;
1272
+ inputClass: string;
1273
+ /** a chosen entry (object) - the container fills other fields from it (onSelect.mapFields) */
1274
+ picked: EventEmitter<any>;
1275
+ private control?;
1276
+ private autocomplete?;
1277
+ suggestions: any[];
1278
+ private lastQuery;
1279
+ /** the name of the field in the entries (the property's name, "workOrderNo") */
1280
+ get key(): string;
1281
+ get optionLabel(): string;
1282
+ get forceSelection(): boolean;
1283
+ get emptyText(): string;
1284
+ /** (completeMethod): the entries that start with what was typed */
1285
+ complete(event: {
1286
+ query?: string;
1287
+ }): void;
1288
+ /** the list arrived while open: show it for what was typed meanwhile */
1289
+ ngOnChanges(changes: SimpleChanges): void;
1290
+ private filter;
1291
+ changed(value: any): void;
1292
+ placeholder(): string;
1293
+ showError(): boolean;
1294
+ message(): string;
1295
+ /** text of a value for reading: the label of an entry, or the value itself */
1296
+ shown(value: any): string;
1094
1297
  static ɵfac: i0.ɵɵFactoryDeclaration<Autocomplete, never>;
1095
- 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>;
1298
+ 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>;
1096
1299
  }
1097
1300
 
1098
1301
  declare class Button {
@@ -1105,9 +1308,34 @@ declare class Date$1 {
1105
1308
  static ɵcmp: i0.ɵɵComponentDeclaration<Date$1, "vl-date", never, {}, {}, never, never, true, never>;
1106
1309
  }
1107
1310
 
1108
- declare class Dropdown {
1109
- static ɵfac: i0.ɵɵFactoryDeclaration<Dropdown, never>;
1110
- static ɵcmp: i0.ɵɵComponentDeclaration<Dropdown, "vl-dropdown", never, {}, {}, never, never, true, never>;
1311
+ declare class DropdownControl {
1312
+ field: any;
1313
+ target: any;
1314
+ value: any;
1315
+ readonly: boolean;
1316
+ /** the loaded entries (the property's data), used when the layout has no allowed values */
1317
+ items: any[] | null | undefined;
1318
+ saveTried: boolean;
1319
+ errorMessages: any;
1320
+ translations: Record<string, string> | null;
1321
+ inputStyle: any;
1322
+ inputClass: string;
1323
+ chosen: EventEmitter<any>;
1324
+ private control?;
1325
+ private cache;
1326
+ private get option();
1327
+ private caption;
1328
+ /** { label, value } entries - the same array while the source does not change */
1329
+ entries(): {
1330
+ label: string;
1331
+ value: any;
1332
+ }[];
1333
+ shown(value: any): string;
1334
+ placeholder(): string;
1335
+ showError(): boolean;
1336
+ message(): string;
1337
+ static ɵfac: i0.ɵɵFactoryDeclaration<DropdownControl, never>;
1338
+ 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>;
1111
1339
  }
1112
1340
 
1113
1341
  declare class ErrorMessage {
@@ -1146,6 +1374,13 @@ declare class Textbox {
1146
1374
  private utilityService;
1147
1375
  formField: any;
1148
1376
  modalItemInfo: any;
1377
+ /** set by the dialog after a save attempt: messages show then even for untouched fields */
1378
+ saveTried: boolean;
1379
+ errorMessages: any;
1380
+ /** reading: show the value as text (a link when option.link) */
1381
+ readonly: boolean;
1382
+ value: any;
1383
+ linkClicked: EventEmitter<any>;
1149
1384
  selectedLanguageInfo: any;
1150
1385
  constructor(cdr: ChangeDetectorRef, utilityService: UtilityService);
1151
1386
  ngOnInit(): void;
@@ -1157,8 +1392,10 @@ declare class Textbox {
1157
1392
  /** The toolkit keyboard for this field, from option.keyboardType or the attribute type. */
1158
1393
  keyboardTypeFor(formField: any): CustomKeyboardType | null;
1159
1394
  getPlaceholder(formField: any): string;
1395
+ showError(control: any): boolean;
1396
+ fieldMessage(control: any): string;
1160
1397
  static ɵfac: i0.ɵɵFactoryDeclaration<Textbox, never>;
1161
- static ɵcmp: i0.ɵɵComponentDeclaration<Textbox, "vl-textbox", never, { "formField": { "alias": "formField"; "required": false; }; "modalItemInfo": { "alias": "modalItemInfo"; "required": false; }; }, {}, never, never, true, never>;
1398
+ 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>;
1162
1399
  }
1163
1400
 
1164
1401
  declare class Time {
@@ -1168,7 +1405,7 @@ declare class Time {
1168
1405
 
1169
1406
  declare class ViewToolkitModule {
1170
1407
  static ɵfac: i0.ɵɵFactoryDeclaration<ViewToolkitModule, never>;
1171
- 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]>;
1408
+ 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]>;
1172
1409
  static ɵinj: i0.ɵɵInjectorDeclaration<ViewToolkitModule>;
1173
1410
  }
1174
1411
 
@@ -1230,6 +1467,9 @@ declare class CustomKeyboardComponent {
1230
1467
  private toUpper;
1231
1468
  enterKey(key: string): void;
1232
1469
  enterSpace(): void;
1470
+ /** The field takes several lines (textArea): the text keyboard offers a new-line key. */
1471
+ get multiLine(): boolean;
1472
+ enterNewLine(): void;
1233
1473
  toggleCase(): void;
1234
1474
  toggleSymbols(): void;
1235
1475
  static ɵfac: i0.ɵɵFactoryDeclaration<CustomKeyboardComponent, never>;
@@ -1250,18 +1490,109 @@ declare class CustomKeyboardDirective implements OnDestroy {
1250
1490
  static ɵdir: i0.ɵɵDirectiveDeclaration<CustomKeyboardDirective, "[vlCustomKeyboard]", never, { "keyboardType": { "alias": "vlCustomKeyboard"; "required": false; }; }, {}, never, never, true, never>;
1251
1491
  }
1252
1492
 
1493
+ /** Turns the toolkit keyboards on or off in a browser (the Designer's preview, Mobile/Tablet). */
1494
+ declare function setToolkitKeyboardOnWeb(on: boolean): void;
1495
+ /** Whether fields get the toolkit keyboards: on the devices always, in a browser when switched on. */
1496
+ declare function toolkitKeyboardActive(): boolean;
1497
+
1498
+ declare function setDateLanguage(languageCode: string | null | undefined): void;
1499
+ declare function currentDateLanguage(): string;
1500
+ /** The numeric date pattern of a language in PrimeNG letters, year with four digits: de "dd.mm.yy". */
1501
+ declare function languageDatePattern(languageCode?: string): string;
1502
+ /** A fixed pattern of the Designer (Unicode letters, "dd.MM.yyyy") in PrimeNG letters ("dd.mm.yy"). */
1503
+ declare function primeDatePattern(unicodePattern: string): string;
1504
+ /** The pattern a date field is typed in (PrimeNG letters). */
1505
+ declare function dateInputPattern(option: any, property: any, languageCode?: string): string;
1506
+ /**
1507
+ * Digits typed on the toolkit keyboard shaped into a date pattern (PrimeNG letters): with
1508
+ * "dd.mm.yy" 18102026 becomes 18.10.2026. yy takes four digits, the other parts two.
1509
+ */
1510
+ declare function shapeDateDigits(digits: string, pattern: string): string;
1511
+ /** The number of digits of a date pattern (8 for dd.mm.yy). */
1512
+ declare function dateDigitCount(pattern: string): number;
1513
+ /**
1514
+ * A date or time value for a list. Date by the field's display style (option.displayFormat):
1515
+ * short -> numeric with four-digit year (de 18.10.2026), medium or none -> the language's medium
1516
+ * style (de 18.10.2026, en Oct 18, 2026), long -> long style (de 18. Oktober 2026), custom -> the
1517
+ * fixed pattern. Time hh:mm. The year never shrinks to two digits.
1518
+ */
1519
+ declare function displayDateValue(value: any, kind: 'date' | 'time' | 'datetime', option?: any, languageCode?: string): string;
1520
+ /** The language of the automatic input hints and of dates (the project language; set with the date pickers' one). */
1521
+ declare function setInputHintLanguage(languageCode: string | null | undefined): void;
1522
+ /**
1523
+ * The input format of a date picker format ("yy-mm-dd": PrimeNG, yy = 4-digit year) or of a time
1524
+ * field ("time", 24 hours) in the letters of `languageCode`: "JJJJ-MM-TT", "hh:mm".
1525
+ */
1526
+ declare function inputFormatHint(dateFormat: string, languageCode?: string): string;
1527
+ /** A time in a fixed pattern: HH / H (24 hours), hh / h (12 hours), mm, a (AM/PM). */
1528
+ declare function fixedTimeText(date: Date, pattern: string): string;
1529
+ /** Whether a language writes times with 12 hours and AM/PM (en yes, de no). */
1530
+ declare function usesTwelveHours(languageCode?: string): boolean;
1531
+ /** PrimeNG hourFormat of the language: "12" or "24". */
1532
+ declare function timeHourFormat(languageCode?: string): '12' | '24';
1533
+ /**
1534
+ * Typed time digits shaped into the field ("0830" -> "08:30"); with 12 hours an AM/PM stays, a
1535
+ * complete time without one gets AM (12 PM), and an hour from 13 becomes PM ("2030" -> "08:30 PM").
1536
+ */
1537
+ declare function shapeTimeText(text: string, twelveHours: boolean): string;
1538
+ /** AM <-> PM of a typed 12-hour time ("08:30 AM" -> "08:30 PM"); a time without one gets PM. */
1539
+ declare function toggleMeridiem(text: string): string;
1540
+
1541
+ /**
1542
+ * The placeholder of a field: only its layout (option.placeholder, set in the Designer), translated
1543
+ * when the selected language has an entry for it; empty otherwise. Never from the data object - the
1544
+ * DTO defines only the type (decided 2026-10-18, #166).
1545
+ */
1546
+ declare function layoutPlaceholder(option: any, translations?: Record<string, string> | null): string;
1547
+ /** @deprecated the placeholder never comes from the data object any more - use layoutPlaceholder. */
1548
+ declare function resolvePlaceholder(_propertySchema: any, _reference: string | null | undefined, _translations?: Record<string, string> | null): string;
1253
1549
  /**
1254
- * The placeholder of the field `reference` in `propertySchema`, translated when the selected
1255
- * language has an entry for it; empty when the project defines none.
1550
+ * Template form: [placeholder]="propertySchema | vlPlaceholder: reference : translations : option" -
1551
+ * only the layout's option.placeholder, never the data object (step 4, #166).
1256
1552
  */
1257
- declare function resolvePlaceholder(propertySchema: any, reference: string | null | undefined, translations?: Record<string, string> | null): string;
1258
- /** Template form of resolvePlaceholder: [placeholder]="propertySchema | vlPlaceholder: reference". */
1259
1553
  declare class PlaceholderPipe implements PipeTransform {
1260
- transform(propertySchema: any, reference: string | null | undefined, translations?: Record<string, string> | null): string;
1554
+ transform(propertySchema: any, reference: string | null | undefined, translations?: Record<string, string> | null, option?: any): string;
1261
1555
  static ɵfac: i0.ɵɵFactoryDeclaration<PlaceholderPipe, never>;
1262
1556
  static ɵpipe: i0.ɵɵPipeDeclaration<PlaceholderPipe, "vlPlaceholder", true>;
1263
1557
  }
1264
1558
 
1559
+ /**
1560
+ * Template form for date and time pickers:
1561
+ * [placeholder]="propertySchema | vlDateHint: reference : option : 'date' | 'time'".
1562
+ * The field's own placeholder, else its input format.
1563
+ */
1564
+ declare class DateHintPipe implements PipeTransform {
1565
+ transform(propertySchema: any, reference: string | null | undefined, option?: any, kind?: 'date' | 'time'): string;
1566
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateHintPipe, never>;
1567
+ static ɵpipe: i0.ɵɵPipeDeclaration<DateHintPipe, "vlDateHint", true>;
1568
+ }
1569
+ /**
1570
+ * The pattern a date picker is typed and shown in (PrimeNG letters), following the app language:
1571
+ * [dateFormat]="propertySchema | vlDateFormat: reference : option".
1572
+ */
1573
+ declare class DateFormatPipe implements PipeTransform {
1574
+ transform(propertySchema: any, reference: string | null | undefined, option?: any): string;
1575
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateFormatPipe, never>;
1576
+ static ɵpipe: i0.ɵɵPipeDeclaration<DateFormatPipe, "vlDateFormat", true>;
1577
+ }
1578
+ /** A date or time value in a list: {{ value | vlDateText: 'date' | 'time' : option }} (de 18.10.2026, 08:05). */
1579
+ declare class DateTextPipe implements PipeTransform {
1580
+ transform(value: any, kind?: 'date' | 'time' | 'datetime', option?: any): string;
1581
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateTextPipe, never>;
1582
+ static ɵpipe: i0.ɵɵPipeDeclaration<DateTextPipe, "vlDateText", true>;
1583
+ }
1584
+
1585
+ /** [src]="source | vlMedia | async" - the same Promise for the same source, so no request loop. */
1586
+ declare class MediaSourcePipe implements PipeTransform {
1587
+ private couchdb;
1588
+ /** Kept one hour: a signed link lasts eight, a page lives shorter. */
1589
+ private static readonly known;
1590
+ constructor(couchdb: Couchdb);
1591
+ transform(source: string | null | undefined): Promise<string>;
1592
+ static ɵfac: i0.ɵɵFactoryDeclaration<MediaSourcePipe, never>;
1593
+ static ɵpipe: i0.ɵɵPipeDeclaration<MediaSourcePipe, "vlMedia", true>;
1594
+ }
1595
+
1265
1596
  interface RequestTimeoutMessages {
1266
1597
  requestSlow: string;
1267
1598
  requestStillSlow: string;
@@ -1299,6 +1630,26 @@ declare class RequestTimeoutService {
1299
1630
  }
1300
1631
  /** A request under the waiting rule (RequestTimeoutService.run); runs plainly before Angular is up. */
1301
1632
  declare function stagedRequest<T>(work: (signal: AbortSignal) => Promise<T>): Promise<T>;
1633
+ /** Answers that are worth asking again: the server or the way to it had a moment. */
1634
+ declare const RETRY_STATUSES: ReadonlySet<number>;
1635
+ /** Pauses between the attempts of a read, in ms; the last one repeats. */
1636
+ declare const RETRY_PAUSES: readonly [1000, 2000, 4000, 8000];
1637
+ /** One attempt of a read without an answer is given up after this and sent again. */
1638
+ declare const READ_ATTEMPT_TIMEOUT = 15000;
1639
+ interface StagedReadOptions {
1640
+ /** Ask once more after a 403 (a first read at the start can be refused while it is set up). */
1641
+ retryForbiddenOnce?: boolean;
1642
+ }
1643
+ /**
1644
+ * A read under the waiting rule that does not give up on a weak network: tried again until it has
1645
+ * an answer that is no passing error, at most until the 60 s of the waiting rule are over. Only for
1646
+ * requests without a side effect - a write that arrived but whose answer was lost would be stored
1647
+ * twice. The last answer is returned as it is (the caller decides on !ok); after the last attempt
1648
+ * the error of that attempt is thrown.
1649
+ */
1650
+ declare function stagedRead(work: (signal: AbortSignal) => Promise<Response>, options?: StagedReadOptions): Promise<Response>;
1651
+ /** Resolves at once when the device has a network, else when it is back (or the time is over). */
1652
+ declare function whenOnline(signal?: AbortSignal, deadline?: number): Promise<void>;
1302
1653
 
1303
1654
  declare class RemoteListService {
1304
1655
  /** The signed-in user (claims + token), set by the app; used when a caller has none. */
@@ -1331,5 +1682,313 @@ declare class RemoteListService {
1331
1682
  static ɵprov: i0.ɵɵInjectableDeclaration<RemoteListService>;
1332
1683
  }
1333
1684
 
1334
- export { AppVersionResetService, CardComponent, ConfigService, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, FormComponent, GridComponent, HeaderMenuComponent, LogsComponent, MobileKeycloakService, MobileOidcService, MobileOktaService, ModelComponent, NetworkLogService, NotificationService, PaginationComponent, PlaceholderPipe, REQUEST_STAGES, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, SIDE_DOCK_CLASS, SideMenuComponent, UtilityService, ViewToolkitModule, isNativeMobile, isNativePhone, normalizeCustomKeyboardType, resolveCustomKeyboardType, resolvePlaceholder, sideDockWidth, stagedRequest };
1335
- export type { CustomKeyboardTarget, CustomKeyboardType, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, OidcProvider, OidcRefresh, OidcTokens, RequestTimeoutMessages };
1685
+ /** Prefix of the forwarding path on the app's own origin. */
1686
+ declare const BACKEND_PROXY_PREFIX = "/api/proxy";
1687
+ /**
1688
+ * The address to call for a backend URL: unchanged on the devices and for relative URLs; in the web
1689
+ * https://p5w1.wilken.de/p5ws/x?y=1 becomes <origin>/api/proxy/p5w1.wilken.de/p5ws/x?y=1.
1690
+ */
1691
+ declare function backendUrl(url: string): string;
1692
+
1693
+ interface NumberShape {
1694
+ style: 'decimal' | 'currency' | 'percent' | 'unit';
1695
+ currency: string | null;
1696
+ unit: string | null;
1697
+ /** translation key of a custom unit, or the translated text */
1698
+ unitLabel: string | null;
1699
+ minFraction: number | null;
1700
+ maxFraction: number | null;
1701
+ grouping: boolean;
1702
+ /** stored as an integer in the currency's minor units (cents) */
1703
+ minorUnits: boolean;
1704
+ }
1705
+ /**
1706
+ * The shape of a number field. row: the record the field belongs to (grid row, card record) or the
1707
+ * object's properties ({ name: { value } }) - for currencyField.
1708
+ */
1709
+ declare function numberShape(field: any, property?: any, row?: any): NumberShape;
1710
+ /** Decimal places of a currency (EUR 2, JPY 0). */
1711
+ declare function currencyDigits(currency: string): number;
1712
+ /** The stored value as the number the user sees and types (cents -> euros, 0.125 -> 12.5 %). */
1713
+ declare function storedToTyped(value: any, shape: NumberShape): number | null;
1714
+ /** The typed number as it is stored (euros -> cents as an integer, 12.5 % -> 0.125). */
1715
+ declare function typedToStored(typed: any, shape: NumberShape): number | null;
1716
+ /** A stored number shown in the app language: "1.234,50 €", "12,5 %", "5 kg", "1.234,5". */
1717
+ declare function displayNumber(value: any, shape: NumberShape, translations?: Record<string, string> | null, languageCode?: string): string;
1718
+ /** The sign beside the input: "€", "%", "kg", the custom unit's text, or ''. */
1719
+ declare function numberSuffix(shape: NumberShape, translations?: Record<string, string> | null, languageCode?: string): string;
1720
+ /** The input's step: the field's step, else one cent for a currency, else 1. */
1721
+ declare function numberStep(field: any, shape: NumberShape, integer: boolean): number | 'any';
1722
+
1723
+ declare function visibleFields(fields: any[] | null | undefined): any[];
1724
+ declare class VisiblePipe implements PipeTransform {
1725
+ transform(fields: any[] | null | undefined): any[];
1726
+ static ɵfac: i0.ɵɵFactoryDeclaration<VisiblePipe, never>;
1727
+ static ɵpipe: i0.ɵɵPipeDeclaration<VisiblePipe, "vlVisible", true>;
1728
+ }
1729
+
1730
+ declare class RulesPipe implements PipeTransform {
1731
+ transform(field: any): FieldRules;
1732
+ static ɵfac: i0.ɵɵFactoryDeclaration<RulesPipe, never>;
1733
+ static ɵpipe: i0.ɵɵPipeDeclaration<RulesPipe, "vlRules", true>;
1734
+ }
1735
+
1736
+ declare class PasswordControl {
1737
+ /** the field of the layout (scope, option, label) */
1738
+ field: any;
1739
+ /** editing: the object whose value is the password (the property in the property schema) */
1740
+ target: any;
1741
+ /** reading: the value to show (a card's record) */
1742
+ value: any;
1743
+ readonly: boolean;
1744
+ /** set by the container after a save attempt */
1745
+ saveTried: boolean;
1746
+ errorMessages: any;
1747
+ translations: Record<string, string> | null;
1748
+ inputStyle: any;
1749
+ inputClass: string;
1750
+ visible: boolean;
1751
+ /** the input's model, for the error line */
1752
+ private control?;
1753
+ dots(value: any): string;
1754
+ placeholder(): string;
1755
+ /** the error line: after typing and leaving, or after a save attempt (as everywhere) */
1756
+ pwShown(): boolean;
1757
+ message(): string;
1758
+ static ɵfac: i0.ɵɵFactoryDeclaration<PasswordControl, never>;
1759
+ 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>;
1760
+ }
1761
+
1762
+ declare class TextareaControl {
1763
+ /** the field of the layout (scope, option, label) */
1764
+ field: any;
1765
+ /** editing: the object whose value is the text (the property in the property schema) */
1766
+ target: any;
1767
+ /** reading: the text to show (a card's record) */
1768
+ value: any;
1769
+ readonly: boolean;
1770
+ /** in a grid cell: one line with an ellipsis, the whole text as tooltip */
1771
+ compact: boolean;
1772
+ /** the toolkit keyboard (the container's keyboardTypeFor) */
1773
+ keyboard: string | null;
1774
+ saveTried: boolean;
1775
+ errorMessages: any;
1776
+ translations: Record<string, string> | null;
1777
+ inputStyle: any;
1778
+ inputClass: string;
1779
+ private control?;
1780
+ lines(): number;
1781
+ placeholder(): string;
1782
+ showError(): boolean;
1783
+ message(): string;
1784
+ static ɵfac: i0.ɵɵFactoryDeclaration<TextareaControl, never>;
1785
+ 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>;
1786
+ }
1787
+
1788
+ declare class SwitchControl {
1789
+ /** the field of the layout (scope, option, label) */
1790
+ field: any;
1791
+ /** the object whose value is switched (the property in the property schema) */
1792
+ target: any;
1793
+ /** reading: the value to show (a card's record) instead of target.value */
1794
+ value: any;
1795
+ readonly: boolean;
1796
+ /** the property's type: "boolean", or a two-value text */
1797
+ type: string;
1798
+ translations: Record<string, string> | null;
1799
+ /** after a change (the containers recalculate, e.g. setformData) */
1800
+ switched: EventEmitter<any>;
1801
+ private get option();
1802
+ private get current();
1803
+ get on(): boolean;
1804
+ set(on: boolean): void;
1805
+ get captionLeft(): boolean;
1806
+ get caption(): string;
1807
+ static ɵfac: i0.ɵɵFactoryDeclaration<SwitchControl, never>;
1808
+ 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>;
1809
+ }
1810
+
1811
+ declare class RadioControl {
1812
+ field: any;
1813
+ target: any;
1814
+ value: any;
1815
+ readonly: boolean;
1816
+ /** the property's type ("boolean" gives true/false) */
1817
+ type: string;
1818
+ saveTried: boolean;
1819
+ errorMessages: any;
1820
+ translations: Record<string, string> | null;
1821
+ chosen: EventEmitter<any>;
1822
+ private buttons?;
1823
+ get horizontal(): boolean;
1824
+ choices(): any[];
1825
+ caption(value: any): string;
1826
+ private get control();
1827
+ showError(): boolean;
1828
+ message(): string;
1829
+ static ɵfac: i0.ɵɵFactoryDeclaration<RadioControl, never>;
1830
+ 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>;
1831
+ }
1832
+
1833
+ declare class NumberControl {
1834
+ field: any;
1835
+ target: any;
1836
+ value: any;
1837
+ readonly: boolean;
1838
+ /** the property's type: "integer" takes whole steps only */
1839
+ type: string;
1840
+ keyboard: string | null;
1841
+ saveTried: boolean;
1842
+ errorMessages: any;
1843
+ translations: Record<string, string> | null;
1844
+ inputStyle: any;
1845
+ inputClass: string;
1846
+ /** the property of the data object (older layouts: its currency) */
1847
+ property: any;
1848
+ /** the record the field belongs to, for a currency taken from another field */
1849
+ row: any;
1850
+ changed: EventEmitter<any>;
1851
+ private control?;
1852
+ get kind(): 'spinner' | 'slider' | 'plain';
1853
+ get shape(): NumberShape;
1854
+ get step(): number | 'any';
1855
+ get sliderStep(): number;
1856
+ get rangeMin(): number;
1857
+ get rangeMax(): number;
1858
+ stepBy(direction: 1 | -1): void;
1859
+ /** the number the user sees and types (cents as euros, 0.125 as 12.5) */
1860
+ typed(): number | null;
1861
+ set(typed: any): void;
1862
+ suffix(): string;
1863
+ shown(value: any): string;
1864
+ placeholder(): string;
1865
+ showError(): boolean;
1866
+ message(): string;
1867
+ static ɵfac: i0.ɵɵFactoryDeclaration<NumberControl, never>;
1868
+ 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>;
1869
+ }
1870
+
1871
+ declare class CheckboxControl {
1872
+ field: any;
1873
+ /** the object holding the value (the property, or a grid row with key) */
1874
+ target: any;
1875
+ /** the name of the value in target ("value" for a property, the field name for a grid row) */
1876
+ key: string;
1877
+ /** reading: the value to show instead of target[key] */
1878
+ value: any;
1879
+ readonly: boolean;
1880
+ /** "boolean", or a two-value text */
1881
+ type: string;
1882
+ /** the text beside the box (the field's caption); empty for none */
1883
+ caption: string;
1884
+ saveTried: boolean;
1885
+ errorMessages: any;
1886
+ translations: Record<string, string> | null;
1887
+ inputStyle: any;
1888
+ toggled: EventEmitter<any>;
1889
+ private control?;
1890
+ private get option();
1891
+ private get current();
1892
+ get checked(): boolean;
1893
+ set(on: boolean): void;
1894
+ get captionLeft(): boolean;
1895
+ showError(): boolean;
1896
+ message(): string;
1897
+ static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxControl, never>;
1898
+ 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>;
1899
+ }
1900
+
1901
+ declare class DateTimeControl {
1902
+ readonly picker: DateTimePickerService;
1903
+ field: any;
1904
+ target: any;
1905
+ /** the property of the data object (its picker pattern counts) */
1906
+ property: any;
1907
+ kind: 'date' | 'time' | 'datetime';
1908
+ value: any;
1909
+ readonly: boolean;
1910
+ keyboard: string | null;
1911
+ saveTried: boolean;
1912
+ errorMessages: any;
1913
+ translations: Record<string, string> | null;
1914
+ inputStyle: any;
1915
+ inputClass: string;
1916
+ changed: EventEmitter<any>;
1917
+ /** the calendar or clock opened */
1918
+ opened: EventEmitter<void>;
1919
+ private control?;
1920
+ /** PrimeNG pattern of the date part (de dd.mm.yy = dd.mm.yyyy) */
1921
+ pattern(): string;
1922
+ /** "12" (en, AM/PM) or "24" - by the app language */
1923
+ hourFormat(): '12' | '24';
1924
+ placeholder(): string;
1925
+ /** typed digits shaped into the pattern, like the toolkit keyboard does */
1926
+ typing(event: any): void;
1927
+ shown(value: any): string;
1928
+ showError(): boolean;
1929
+ message(): string;
1930
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateTimeControl, never>;
1931
+ 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>;
1932
+ }
1933
+
1934
+ declare class DateRangeControl implements OnChanges {
1935
+ field: any;
1936
+ /** the property holding the pair [from, to] in value */
1937
+ target: any;
1938
+ value: any;
1939
+ readonly: boolean;
1940
+ keyboard: string | null;
1941
+ saveTried: boolean;
1942
+ errorMessages: any;
1943
+ translations: Record<string, string> | null;
1944
+ inputStyle: any;
1945
+ inputClass: string;
1946
+ changed: EventEmitter<any>;
1947
+ from: {
1948
+ value: any;
1949
+ };
1950
+ to: {
1951
+ value: any;
1952
+ };
1953
+ fromField: any;
1954
+ toField: any;
1955
+ ngOnChanges(): void;
1956
+ update(): void;
1957
+ private time;
1958
+ wrongOrder(): boolean;
1959
+ orderMessage(): string;
1960
+ shown(value: any): string;
1961
+ static ɵfac: i0.ɵɵFactoryDeclaration<DateRangeControl, never>;
1962
+ 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>;
1963
+ }
1964
+
1965
+ type MediaKind = 'image' | 'video' | 'audio' | 'pdf' | 'file';
1966
+ /** What a media source is: by its data: type, else by the file extension; image when unknown. */
1967
+ declare function mediaKind(source: string, ...names: any[]): MediaKind;
1968
+ declare class MediaControl {
1969
+ private readonly sanitizer;
1970
+ private trustedCache;
1971
+ field: any;
1972
+ /** the field's value: a URL, a file name of the project's Media/, or a data: URL */
1973
+ value: any;
1974
+ /** the property of the data object (its caption, default) */
1975
+ property: any;
1976
+ /** grid cells and cards: a thumbnail or symbol, the large view on tap */
1977
+ compact: boolean;
1978
+ mediaStyle: any;
1979
+ mediaClass: string;
1980
+ /** a tap on an image (the containers' image action) */
1981
+ clicked: EventEmitter<void>;
1982
+ large: boolean;
1983
+ source(): string;
1984
+ kind(): MediaKind;
1985
+ label(): string;
1986
+ symbolClass(): string;
1987
+ /** the resolved link as a frame source - the same object for the same link */
1988
+ trusted(url: string): SafeResourceUrl;
1989
+ static ɵfac: i0.ɵɵFactoryDeclaration<MediaControl, never>;
1990
+ 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>;
1991
+ }
1992
+
1993
+ export { AppVersionResetService, Autocomplete, BACKEND_PROXY_PREFIX, CardComponent, CheckboxControl, ConfigService, 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, 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, testAction, testFieldKey, testWrites, timeHourFormat, toggleMeridiem, toolkitKeyboardActive, typedToStored, usesTwelveHours, visibleFields, whenOnline };
1994
+ export type { CustomKeyboardTarget, CustomKeyboardType, FieldKind, FieldModel, FieldRules, MediaKind, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, NumberShape, OidcProvider, OidcRefresh, OidcTokens, RequestTimeoutMessages, StagedReadOptions };