@yomotech/view-toolkit 1.0.43 → 1.0.45

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yomotech/view-toolkit",
3
- "version": "1.0.43",
3
+ "version": "1.0.45",
4
4
  "peerDependencies": {
5
5
  "@angular/cdk": "^21.0.0",
6
6
  "@angular/common": "^21.0.0",
@@ -126,11 +126,13 @@ declare function assertFieldSettings(schema: Bag, fallback: string, option: Bag,
126
126
 
127
127
  declare const TESTS_DIR = ".liveforge/tests";
128
128
  declare const RESULTS_DIR = ".liveforge/results";
129
+ /** The app's test data, shared by its tests: { customer: { firstName: "Max" }, card: { number: "4242…" } } */
130
+ declare const TEST_DATA_FILE = ".liveforge/test-data.json";
129
131
  declare const TEST_DEVICES: readonly ["phone", "tablet", "laptop", "desktop"];
130
132
  declare const ORIENTATIONS: readonly ["portrait", "landscape"];
131
- declare const STEP_KINDS: readonly ["open", "tap", "type", "pick", "press", "rotate", "device", "wait", "expect"];
133
+ declare const STEP_KINDS: readonly ["open", "menu", "tap", "type", "pick", "press", "scroll", "openRecord", "close", "cart", "rotate", "device", "wait", "expect"];
132
134
  /** What an expect step can check - one of them per step. */
133
- declare const EXPECT_KINDS: readonly ["value", "shows", "keyboard", "list", "message", "visible", "hidden", "locked", "blocked", "inFrame"];
135
+ declare const EXPECT_KINDS: readonly ["value", "shows", "keyboard", "list", "message", "visible", "hidden", "locked", "blocked", "inFrame", "page", "records", "recordsAtLeast", "samePlace", "cartCount", "toast"];
134
136
  /** What has to stay inside the page frame (safe areas, top gap). */
135
137
  declare const FRAME_PARTS: readonly ["keyboard", "dialog", "calendar", "list", "menu"];
136
138
  declare const LIST_STATES: readonly ["open", "closed"];
@@ -153,15 +155,36 @@ interface TestExpect {
153
155
  /** a button that writes real data is there and this flow may not press it (the runner's lock) */
154
156
  blocked?: string;
155
157
  inFrame?: typeof FRAME_PARTS[number];
158
+ /** the open page: its folder under pages/ ("sidemenu/books") */
159
+ page?: string;
160
+ /** the records the open list shows now (exactly / at least) */
161
+ records?: number;
162
+ recordsAtLeast?: number;
163
+ /** back with the X the list stands where it was left (records and scroll position before openRecord) */
164
+ samePlace?: true;
165
+ /** items in the cart (the header's count); "+1" = one more than at the flow's last cart check */
166
+ cartCount?: number | string;
167
+ /** a message shown to the user (its text or its translation key) */
168
+ toast?: string;
156
169
  }
157
170
  interface TestStep {
158
171
  open?: string;
172
+ /** a menu entry by its caption key in Main (a new start: the page history is emptied) */
173
+ menu?: string;
159
174
  tap?: string;
160
175
  type?: string;
161
176
  into?: string;
162
177
  pick?: string;
163
178
  in?: string;
164
179
  press?: string;
180
+ /** pages to go on in the open list (swipe up / its end into view), 1-20 */
181
+ scroll?: number;
182
+ /** a record of the open list by its position (1 = first) or by its shown name - its link opens its page */
183
+ openRecord?: number | string;
184
+ /** the page X - back to the page before */
185
+ close?: true;
186
+ /** the cart in the header */
187
+ cart?: true;
165
188
  rotate?: Orientation;
166
189
  device?: string;
167
190
  /** milliseconds */
@@ -238,8 +261,25 @@ declare function parseDevice(text: string): {
238
261
  declare function flowDevices(flow: TestFlow): string[];
239
262
  /** The kind of a step - the first step key it has. */
240
263
  declare function stepKind(step: TestStep): string | null;
241
- /** The problems of a flow; an empty list means it can run. */
242
- declare function checkTestFlow(flow: any): TestProblem[];
264
+ /** The test data a flow uses, per step: [{ step, ref: "customer.firstName" }]; ref without "data.". */
265
+ declare function testDataRefs(flow: any): {
266
+ step: number;
267
+ ref: string;
268
+ raw: string;
269
+ }[];
270
+ /**
271
+ * The flow with its test data put in: "{{data.customer.firstName}}" -> "Max"; a whole value that is one placeholder
272
+ * keeps the data's type (a number stays a number). Both runners call it before a run; missing lists what is not in data.
273
+ */
274
+ declare function withTestData(flow: TestFlow, data: any): {
275
+ flow: TestFlow;
276
+ missing: string[];
277
+ };
278
+ /**
279
+ * The problems of a flow; an empty list means it can run. With the app's test data, a placeholder that names nothing
280
+ * in it is a problem too (dataUnknown); a placeholder that is no {{data.…}} is one always (dataRefInvalid).
281
+ */
282
+ declare function checkTestFlow(flow: any, data?: any): TestProblem[];
243
283
 
244
284
  /** The building blocks of the app settings in Main, in the order they are shown. */
245
285
  declare const APP_SETTING_BLOCKS: readonly ["startPage", "login", "pagination", "terms", "menu"];
@@ -415,5 +455,5 @@ declare function appSettingsMenu(menu: any[], center: Bag | any, context?: {
415
455
  signedIn?: boolean;
416
456
  }): any[];
417
457
 
418
- export { APP_SETTINGS, APP_SETTINGS_PATH, APP_SETTING_BLOCKS, BASIC_TYPES, CONTROLS, CONTROL_TYPES, DATA_FORMATS, DATA_OBJECT_KEYS, DATA_OBJECT_NAME_PLACES, DATA_OBJECT_PLACES, DEFAULT_DEVICES, DISPLAY_FORMATS, DOCUMENT_KINDS, EXPECT_KINDS, FRAME_PARTS, KEYBOARD_CONTROLS, KEYBOARD_TYPES, LIST_STATES, LOGIN_FLAGS, LOGIN_METHODS, LOGIN_STORAGES, LOGIN_WHEN, MENU_DECIDED_BY, MENU_ENTRY_KINDS, MENU_SWITCHABLE, NUMBER_STYLES, ORIENTATIONS, PAGINATION_ALIGNS, PAGINATION_PLACEMENTS, PAGINATION_TYPES, PLACEHOLDER_CONTROLS, RESULTS_DIR, RESULTS_KEEP, SETTING_MENU_TEXTS, START_PAGE_KEYS, START_PAGE_PATH, STEP_KINDS, SYSTEM_KEYBOARDS, TEMPORAL_TRANSFER, TERMS_DOCUMENTS, TESTS_DIR, TEST_DEVICES, TYPE_ALIASES, appSettingsMenu, assertFieldSettings, baseType, basicType, canonicalControl, checkAppSettings, checkPagePagination, checkTestFlow, clone, controlChoicesFor, controlsFor, dataSettings, defaultKeyboard, displaySettings, effectiveControl, effectiveFormat, flowDevices, keyboardFor, languageName, loginMethod, normalizeFormat, pageOf, paginationFor, parseDevice, readAppSettings, renameDataObject, resolveProperty, resultsToDelete, rolesOf, rulesFor, startPage, startPageFor, stepKind, temporalPart, validateSettings, validationSettings };
458
+ export { APP_SETTINGS, APP_SETTINGS_PATH, APP_SETTING_BLOCKS, BASIC_TYPES, CONTROLS, CONTROL_TYPES, DATA_FORMATS, DATA_OBJECT_KEYS, DATA_OBJECT_NAME_PLACES, DATA_OBJECT_PLACES, DEFAULT_DEVICES, DISPLAY_FORMATS, DOCUMENT_KINDS, EXPECT_KINDS, FRAME_PARTS, KEYBOARD_CONTROLS, KEYBOARD_TYPES, LIST_STATES, LOGIN_FLAGS, LOGIN_METHODS, LOGIN_STORAGES, LOGIN_WHEN, MENU_DECIDED_BY, MENU_ENTRY_KINDS, MENU_SWITCHABLE, NUMBER_STYLES, ORIENTATIONS, PAGINATION_ALIGNS, PAGINATION_PLACEMENTS, PAGINATION_TYPES, PLACEHOLDER_CONTROLS, RESULTS_DIR, RESULTS_KEEP, SETTING_MENU_TEXTS, START_PAGE_KEYS, START_PAGE_PATH, STEP_KINDS, SYSTEM_KEYBOARDS, TEMPORAL_TRANSFER, TERMS_DOCUMENTS, TESTS_DIR, TEST_DATA_FILE, TEST_DEVICES, TYPE_ALIASES, appSettingsMenu, assertFieldSettings, baseType, basicType, canonicalControl, checkAppSettings, checkPagePagination, checkTestFlow, clone, controlChoicesFor, controlsFor, dataSettings, defaultKeyboard, displaySettings, effectiveControl, effectiveFormat, flowDevices, keyboardFor, languageName, loginMethod, normalizeFormat, pageOf, paginationFor, parseDevice, readAppSettings, renameDataObject, resolveProperty, resultsToDelete, rolesOf, rulesFor, startPage, startPageFor, stepKind, temporalPart, testDataRefs, validateSettings, validationSettings, withTestData };
419
459
  export type { AppSettingBlock, AppSettingDef, AppSettings, AppSettingsProblem, Bag, DocumentKind, FlowResult, LoginStorage, LoginWhen, MenuEntryKind, Orientation, Pagination, PaginationAlign, PaginationPlacement, PaginationType, Setting, StepResult, TemporalPart, TermsDocument, TestDevice, TestExpect, TestFlow, TestProblem, TestRun, TestStep };
@@ -79,6 +79,11 @@ declare function fieldInnerLayoutStyle(formField: any, container?: 'dialog' | 'f
79
79
  * its action - the same in every language, whatever the caption says. data-vl-field / data-vl-action.
80
80
  */
81
81
  declare function testFieldKey(field: any): string | null;
82
+ /**
83
+ * The field's DTO name and its key, the way tests name it: "#/shipping/properties/street" -> "shipping.street",
84
+ * nested "#/order/properties/address/properties/city" -> "order.address.city". data-vl-path.
85
+ */
86
+ declare function testFieldPath(field: any): string | null;
82
87
  declare function testAction(option: any): string | null;
83
88
  /**
84
89
  * Whether a button writes real data: to the backend (storageType database - the card's disk icon,
@@ -95,6 +100,46 @@ declare function normalizeCustomKeyboardType(value: unknown): CustomKeyboardType
95
100
  */
96
101
  declare function resolveCustomKeyboardType(option: any, property: any): CustomKeyboardType | null;
97
102
 
103
+ /** Values the placeholders of a call are taken from. */
104
+ interface CallContext {
105
+ userInfo?: any;
106
+ record?: any;
107
+ records?: any[];
108
+ filter?: any;
109
+ env?: any;
110
+ /** Further values a button hands in (purchase: form, cart, response); one more key is {{item.x}} inside $each. */
111
+ [key: string]: any;
112
+ }
113
+ /** A call ready to send. */
114
+ interface BackendCall {
115
+ url: string;
116
+ method: string;
117
+ params: Record<string, string>;
118
+ body: any;
119
+ }
120
+ /**
121
+ * A template with its placeholders filled in. A string that is only one placeholder gives the value
122
+ * itself (a list stays a list); inside a longer text a missing value becomes empty. Objects and
123
+ * lists are filled in deeply.
124
+ */
125
+ declare function resolveTemplate(template: any, context: CallContext): any;
126
+ /** The sources a placeholder may name - the library knows no field names of an app, only these sources. */
127
+ declare const PLACEHOLDER_SOURCES: string[];
128
+ /**
129
+ * An address or text with the placeholders filled in that the context can answer: a known source
130
+ * ({{userInfo.x}}, {{env.x}}, {{record.x}}, {{form.x}}, {{filter.x}}, {{pageNumber}}, {{pageSize}}) - empty when the
131
+ * value is missing - or a field the context or the signed-in user has ({{p5_backend_url}}). Anything else stays as
132
+ * written, so a caller can fill its own ({{id}} of a delete). encode: URL-encode the values (an address part).
133
+ */
134
+ declare function fillPlaceholders(text: string, context: CallContext, encode?: boolean): string;
135
+ /** True when the option describes a backend call (it has an address). */
136
+ declare function hasBackendCall(option: any): boolean;
137
+ /**
138
+ * The call of an option: address, method, URL parameters and content with the placeholders filled in.
139
+ * A relative address is put after env.apiUrl. Without an address there is no call (null).
140
+ */
141
+ declare function buildBackendCall(option: any, context: CallContext): BackendCall | null;
142
+
98
143
  declare class RequestService {
99
144
  private http;
100
145
  pageSize: number;
@@ -103,11 +148,11 @@ declare class RequestService {
103
148
  constructor(http: HttpClient);
104
149
  getAllProject(): rxjs.Observable<Object>;
105
150
  getEnvironmet(selectedProject: any): rxjs.Observable<Object>;
106
- getSectionInfo(url: string, envUrl?: any, passToken?: boolean, selectedProject?: string, userInfo?: any): rxjs.Observable<Object>;
151
+ getSectionInfo(url: string, envUrl?: any, passToken?: boolean, selectedProject?: string, userInfo?: any, option?: any): rxjs.Observable<Object>;
107
152
  readFile(projectName: any, path: any): rxjs.Observable<Object>;
108
153
  getMainLayout(selectedProject: any): rxjs.Observable<Object>;
109
- getInfo(url: string): rxjs.Observable<Object>;
110
- dynamicCall(method: string | undefined, body: any | undefined, url: string, passToken?: boolean, selectedProject?: string, userInfo?: any): rxjs.Observable<Object>;
154
+ getInfo(url: string, option?: any): rxjs.Observable<Object>;
155
+ dynamicCall(method: string | undefined, body: any | undefined, url: string, passToken?: boolean, selectedProject?: string, userInfo?: any, option?: any): rxjs.Observable<Object>;
111
156
  createAuthorizationHeader(userInfo: any, tokenExist?: boolean): HttpHeaders;
112
157
  getLoginUser(token: any, issuer: string): rxjs.Observable<Object>;
113
158
  static ɵfac: i0.ɵɵFactoryDeclaration<RequestService, never>;
@@ -145,7 +190,12 @@ declare class UtilityService {
145
190
  parseBodyObject(obj: any): any;
146
191
  getTotalPrice(tableitemInfo: any): number;
147
192
  getTotalQuantity(tableitemInfo: any): number;
148
- replacePaginationParams(url: string, currentPage: number, pageSize: number): string;
193
+ /**
194
+ * A page's address with its placeholders: {{pageNumber}}, {{pageSize}} and - with a context - any field of the
195
+ * signed-in user ({{userInfo.userId}}) or the Configuration ({{env.x}}). Only page number and size were filled
196
+ * before, so an address could not name the user (hotel Bookings asked for user 3 whoever was signed in).
197
+ */
198
+ replacePaginationParams(url: string, currentPage: number, pageSize: number, context?: CallContext): string;
149
199
  customButton(option: any, propertySchema: any, projectSeleted: any, environment: any): void;
150
200
  /**
151
201
  * The page an entry opens for this user. The app settings form (Main with center.appSettings,
@@ -161,7 +211,6 @@ declare class UtilityService {
161
211
  * the roles there. The user's own fields win over a claim of the same name.
162
212
  */
163
213
  userClaims(userInfo: any): any;
164
- setTableData(data: any, option: any | undefined, tableitemInfo: any, projectSeleted: any): any;
165
214
  setOktaWebCredential(environment: any, projectName: any): {
166
215
  logo: string;
167
216
  baseUrl: any;
@@ -575,6 +624,17 @@ declare function parseRecords(value: unknown): any[];
575
624
  declare function recordOf(propertySchema: Record<string, any> | null | undefined, fields?: string[]): Record<string, any>;
576
625
 
577
626
  /** What PageData needs from the app: storage, backend, the question before deleting, a message. */
627
+ /** dataKey: the answer itself is the list (or the one record, a detail page). */
628
+ declare const DATA_KEY_ANSWER = "@answer";
629
+ /** dataKey: the answer carries no records (void, or only a status). */
630
+ declare const DATA_KEY_NONE = "@none";
631
+ /**
632
+ * The records in a backend answer. dataKey is where they stand: a path ("_embedded.orders"), @answer (the
633
+ * answer itself - a list, or one record) or @none (no records). Without dataKey (older data) the answer itself
634
+ * when it is a list, else its "content" (a Spring page), else none - or, with oneRecord, the answer as the one
635
+ * record (a page that loads a single record, e.g. a detail by its id).
636
+ */
637
+ declare function recordsFrom(answer: any, dataKey?: string | null, oneRecord?: boolean): any[];
578
638
  interface PageDataDeps {
579
639
  readRecords(source: DataSource): Promise<any[]>;
580
640
  writeRecords(source: DataSource, records: any[]): Promise<boolean>;
@@ -588,6 +648,8 @@ interface PageDataDeps {
588
648
  failed(key: string, error: unknown): void;
589
649
  /** Dates of browser records back to Date objects (optional). */
590
650
  restoreDates?(records: any[]): any[];
651
+ /** The app's own work on records just loaded from the backend, e.g. pictures from Media (optional). */
652
+ prepare?(records: any[]): Promise<any[]>;
591
653
  }
592
654
  declare class PageData {
593
655
  records: any[];
@@ -598,14 +660,30 @@ declare class PageData {
598
660
  totalItems: number;
599
661
  loading: boolean;
600
662
  filter: Record<string, any>;
663
+ /** The last backend answer as it came (its paging fields). */
664
+ lastAnswer: any;
601
665
  /** Called after every change of the state above - the container redraws. */
602
666
  onChange: () => void;
603
667
  readonly source: DataSource & Record<string, any>;
604
668
  private readonly deps;
669
+ /** Backend pages load one after another - a second request waits for the first (a card asked for page 2 while
670
+ * page 1 was still on its way, and page 2 replaced it: luv2shop search showed 2 of 7 hits). */
671
+ private queue;
672
+ /** Counts fresh loads; an appended page started before a fresh load is dropped. */
673
+ private generation;
674
+ /** The pages already added while scrolling (page 0 = the first). */
675
+ private loadedUpTo;
605
676
  constructor(source: DataSource & Record<string, any>, deps: PageDataDeps, pageSize?: number);
606
677
  /** Browser list and filter page: all records are here and paged in the app; a backend pages itself. */
607
678
  get clientPaging(): boolean;
608
679
  load(): Promise<void>;
680
+ /**
681
+ * A page of a backend list: fresh (append false) shows only that page, append adds it to the records shown -
682
+ * scrolling. Requests run one after another; a page already added, or beyond the last, is not asked again.
683
+ */
684
+ loadPage(page: number, append?: boolean): Promise<void>;
685
+ /** The list as it was left (back with the page X): its records and the pages they came from. */
686
+ restore(records: any[], page: number): void;
609
687
  /** Records the app loaded itself (a backend page with images, its own paging). */
610
688
  useRecords(records: any[]): void;
611
689
  setFilter(values: Record<string, any>): Promise<void>;
@@ -644,6 +722,7 @@ declare class CardComponent {
644
722
  private requestService;
645
723
  /** Marks for the app's test runner (#166): field key and button action. */
646
724
  readonly vlFieldKey: typeof testFieldKey;
725
+ readonly vlFieldPath: typeof testFieldPath;
647
726
  readonly vlAction: typeof testAction;
648
727
  readonly vlWrites: typeof testWrites;
649
728
  private readonly remoteLists;
@@ -691,6 +770,8 @@ declare class CardComponent {
691
770
  footerSchemaCopy: any;
692
771
  constructor(utilityService: UtilityService, platform: Platform, http: HttpClient, configService: ConfigService, cdr: ChangeDetectorRef, zone: NgZone, modalService: NzModalService, notificationService: NotificationService, oauthService: OAuthService, requestService: RequestService);
693
772
  ngOnInit(): void;
773
+ /** The layout this card wrote last (translated) - any other is a new page's layout. */
774
+ private translatedLayout;
694
775
  ngOnChanges(changes: SimpleChanges): void;
695
776
  onWindowResize(): void;
696
777
  get displayedRecords(): any[];
@@ -729,6 +810,8 @@ declare class CardComponent {
729
810
  key: any;
730
811
  productSchema: any;
731
812
  };
813
+ /** Every class of a style as one class string (array or text) - only the first was set before. */
814
+ classNames(style: any): string;
732
815
  getStyleWithoutClasses(styleObject: any): {
733
816
  classes: string;
734
817
  style: Record<string, any>;
@@ -791,6 +874,7 @@ declare function lockHint(option: any, reason: LockReason, translations?: Record
791
874
  declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestroy {
792
875
  /** Marks for the app's test runner (#166): field key and button action. */
793
876
  readonly vlFieldKey: typeof testFieldKey;
877
+ readonly vlFieldPath: typeof testFieldPath;
794
878
  private readonly remoteLists;
795
879
  /** Loaded lists by field reference. */
796
880
  remoteData: Record<string, any[]>;
@@ -910,6 +994,14 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
910
994
  /** Date and time picker behaviour shared by all containers. */
911
995
  readonly picker: DateTimePickerService;
912
996
  private readonly host;
997
+ private readonly cdr;
998
+ /**
999
+ * The style of a row's cell from its column (scope.style) - without display: the cell stays a table cell. An image's
1000
+ * display: block on the cell took it out of the table and every column moved one to the left (luv2shop Coffee Mugs).
1001
+ */
1002
+ cellStyle(col: any): any;
1003
+ /** Watches the element under the table; in view (with 250px ahead) it asks for the next page. */
1004
+ private observeEnd;
913
1005
  ngOnDestroy(): void;
914
1006
  private sideHintObserver?;
915
1007
  /** Marks the table's scroll area while columns lie beyond its left or right edge. */
@@ -932,6 +1024,12 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
932
1024
  pageSize: number;
933
1025
  currentPage: number;
934
1026
  pages: number[];
1027
+ /** The table pages by scrolling: its end in view asks for the next page (onPageChange). */
1028
+ scrollPagination: boolean;
1029
+ set scrollSentinel(el: ElementRef<HTMLElement> | undefined);
1030
+ private endObserver?;
1031
+ private endElement?;
1032
+ private askedPage;
935
1033
  userInfo: any;
936
1034
  /** A page from browser storage or a filter (A4): its records, delete and paging go through PageData. */
937
1035
  pageData: PageData | null;
@@ -967,13 +1065,22 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
967
1065
  get gridDisplayData(): any[];
968
1066
  translateSchema(schema: any, SelectedLanguage: any): any;
969
1067
  getScope(scope: any): string;
1068
+ /** Every class of a style as one class string (array or text) - only the first was set before. */
1069
+ classNames(style: any): string;
970
1070
  getStyleWithoutClasses(styleObject: any): {
971
- classes: any;
1071
+ classes: string;
972
1072
  style: any;
973
1073
  };
974
1074
  onScrollEvent(event: any): void;
975
1075
  showLinkDetails(option: any, data: any): void;
976
1076
  invokeGridBtnClick(option: any, propertySchema: any): void;
1077
+ /**
1078
+ * An action icon of a row (save / delete of an action column) calls its address. The address is filled per click
1079
+ * from the layout ({{field}} = the row's field) - the layout's own option stays as it is (it was overwritten, a
1080
+ * second row called the first row's id). After success only this row changes: the record the server answers, else
1081
+ * the values the action sets (option.afterSuccessSet, chosen in the Designer) - no value is fixed here (it wrote
1082
+ * "APPROVED", also when rejecting).
1083
+ */
977
1084
  upsertAction(option: any, data: any): void;
978
1085
  setActionColumn(option: any, data: any): boolean;
979
1086
  findDynamicKeyAndValue(object: Record<string, any>): {
@@ -1053,7 +1160,7 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1053
1160
  /** The DTO type of a column as the data object declares it ("string", "quantity" ...). */
1054
1161
  cellType(col: any): string;
1055
1162
  static ɵfac: i0.ɵɵFactoryDeclaration<GridComponent, never>;
1056
- 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; }; "pageData": { "alias": "pageData"; "required": false; }; }, { "editRow": "editRow"; "onPageChange": "onPageChange"; "onPageSizeChange": "onPageSizeChange"; "onGridScroll": "onGridScroll"; "showGridLink": "showGridLink"; "gridButtonClick": "gridButtonClick"; "gridIncreamentClick": "gridIncreamentClick"; "gridDecreamentClick": "gridDecreamentClick"; "gridImgClick": "gridImgClick"; }, never, never, true, never>;
1163
+ 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; }; "scrollPagination": { "alias": "scrollPagination"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "pageData": { "alias": "pageData"; "required": false; }; }, { "editRow": "editRow"; "onPageChange": "onPageChange"; "onPageSizeChange": "onPageSizeChange"; "onGridScroll": "onGridScroll"; "showGridLink": "showGridLink"; "gridButtonClick": "gridButtonClick"; "gridIncreamentClick": "gridIncreamentClick"; "gridDecreamentClick": "gridDecreamentClick"; "gridImgClick": "gridImgClick"; }, never, never, true, never>;
1057
1164
  }
1058
1165
 
1059
1166
  declare class HeaderMenuComponent implements AfterViewInit {
@@ -1073,6 +1180,8 @@ declare class HeaderMenuComponent implements AfterViewInit {
1073
1180
  environment: any;
1074
1181
  tenantName: any;
1075
1182
  projectSeleted: any;
1183
+ /** The signed-in user - its name for the user element. */
1184
+ userInfo: any;
1076
1185
  cartInfo: any;
1077
1186
  buttonClick: EventEmitter<any>;
1078
1187
  showTableContent: EventEmitter<any>;
@@ -1082,14 +1191,26 @@ declare class HeaderMenuComponent implements AfterViewInit {
1082
1191
  ngOnChanges(changes: SimpleChanges): void;
1083
1192
  ngAfterViewInit(): void;
1084
1193
  getStyle(styleObject: any): Record<string, any>;
1194
+ /** The classes of a style (style.classes), for [ngClass] beside getStyle. */
1195
+ classNames(styleObject: any): string;
1085
1196
  isVisible(header: any): boolean;
1086
- shouldShowDefaultButton(header: any): boolean;
1197
+ /** The kinds of header elements; a group holds elements of its own. */
1198
+ static readonly KINDS: readonly ["image", "text", "button", "search", "cart", "user", "group"];
1199
+ /** An element's kind: its control, else (older headers) its field name or its cart action; else a button. */
1200
+ kindOf(header: any): string;
1201
+ /** Shown: visible, and - with islogin - only signed in (true) or only signed out (false). */
1202
+ isShown(header: any): boolean;
1203
+ /** The text of an element: label.caption, an older label text or caption. */
1204
+ captionOf(header: any): string;
1205
+ signedIn(): boolean;
1206
+ /** The name of the signed-in user (name, else email). */
1207
+ userName(): string;
1087
1208
  invokeSearchedItems(option: any, search: any): void;
1088
1209
  invokeHeaderButtonClick(option: any): void;
1089
1210
  invokeShowtableContent(option: any): void;
1090
1211
  setHeaderItems(items: any[]): Promise<any[]>;
1091
1212
  static ɵfac: i0.ɵɵFactoryDeclaration<HeaderMenuComponent, never>;
1092
- static ɵcmp: i0.ɵɵComponentDeclaration<HeaderMenuComponent, "vl-header-menu", never, { "headerItems": { "alias": "headerItems"; "required": false; }; "headerLayout": { "alias": "headerLayout"; "required": false; }; "environment": { "alias": "environment"; "required": false; }; "tenantName": { "alias": "tenantName"; "required": false; }; "projectSeleted": { "alias": "projectSeleted"; "required": false; }; "cartInfo": { "alias": "cartInfo"; "required": false; }; }, { "buttonClick": "buttonClick"; "showTableContent": "showTableContent"; "searchItems": "searchItems"; }, never, never, true, never>;
1213
+ static ɵcmp: i0.ɵɵComponentDeclaration<HeaderMenuComponent, "vl-header-menu", never, { "headerItems": { "alias": "headerItems"; "required": false; }; "headerLayout": { "alias": "headerLayout"; "required": false; }; "environment": { "alias": "environment"; "required": false; }; "tenantName": { "alias": "tenantName"; "required": false; }; "projectSeleted": { "alias": "projectSeleted"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "cartInfo": { "alias": "cartInfo"; "required": false; }; }, { "buttonClick": "buttonClick"; "showTableContent": "showTableContent"; "searchItems": "searchItems"; }, never, never, true, never>;
1093
1214
  }
1094
1215
 
1095
1216
  declare class NetworkLogService {
@@ -1120,6 +1241,7 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1120
1241
  private utilityService;
1121
1242
  /** Marks for the app's test runner (#166): field key and button action. */
1122
1243
  readonly vlFieldKey: typeof testFieldKey;
1244
+ readonly vlFieldPath: typeof testFieldPath;
1123
1245
  private readonly remoteLists;
1124
1246
  /** Date and time picker behaviour shared by all containers. */
1125
1247
  readonly picker: DateTimePickerService;
@@ -1214,6 +1336,10 @@ declare class PaginationComponent implements OnInit {
1214
1336
  private updateDeviceMode;
1215
1337
  get isFirstPage(): boolean;
1216
1338
  get isLastPage(): boolean;
1339
+ /** The sizes offered: the layout's (or 5/10/15/20) and the size in use, sorted - a size the backend chose stays visible. */
1340
+ sizeOptions(): number[];
1341
+ /** The classes the layout gives the bar (pagination.style.classes) - the app's style.css styles the bar through them. */
1342
+ get paginationClasses(): string;
1217
1343
  get paginationStyle(): Record<string, any>;
1218
1344
  get listStyle(): Record<string, any>;
1219
1345
  get sizeControlStyle(): Record<string, any>;
@@ -1456,6 +1582,14 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
1456
1582
  private destroyMobileLoginSubscription;
1457
1583
  private clearLoginUser;
1458
1584
  getUserInfoFromToken(token: string): any | null;
1585
+ /**
1586
+ * Whether a menu entry is hidden: sign-in (option.login) like before, and an entry with option.role only for a
1587
+ * user of that role. The role is the user's value under the app settings' roleKey (default userRole), compared
1588
+ * without case - Main says "ADMIN", a backend may answer "admin". hotel showed admin and customer entries to all.
1589
+ */
1590
+ itemHidden(item: any, submenu?: boolean): boolean;
1591
+ /** True without option.role, else when the signed-in user has that role (case does not matter). */
1592
+ private roleFits;
1459
1593
  setLoginedUser(user: any): void;
1460
1594
  /** The menu entry with action 'logout', at any depth of the menu. */
1461
1595
  private findLogoutMenu;
@@ -1936,13 +2070,20 @@ declare class RemoteListService {
1936
2070
  static ɵprov: i0.ɵɵInjectableDeclaration<RemoteListService>;
1937
2071
  }
1938
2072
 
2073
+ /** The app's environment (Configuration), set once by the app; the default for every call. */
2074
+ declare function setProxyEnvironment(environment: any): void;
2075
+ /** true: through the proxy. The call decides (option.proxy true/false), else the Configuration (environment.proxy). */
2076
+ declare function proxyFor(option?: any, environment?: any): boolean;
2077
+
1939
2078
  /** Prefix of the forwarding path on the app's own origin. */
1940
2079
  declare const BACKEND_PROXY_PREFIX = "/api/proxy";
2080
+
1941
2081
  /**
1942
- * The address to call for a backend URL: unchanged on the devices and for relative URLs; in the web
1943
- * https://p5w1.wilken.de/p5ws/x?y=1 becomes <origin>/api/proxy/p5w1.wilken.de/p5ws/x?y=1.
2082
+ * The address to call for a backend URL. Through the proxy only when the customer switched it on (proxyFor:
2083
+ * the call's option.proxy, else the Configuration) - never automatically (user decision 2026-10-25). Unchanged
2084
+ * on the devices (native HTTP, no CORS) and for relative URLs.
1944
2085
  */
1945
- declare function backendUrl(url: string): string;
2086
+ declare function backendUrl(url: string, proxy: boolean): string;
1946
2087
 
1947
2088
  declare class RecordStore {
1948
2089
  private utilityService;
@@ -1962,37 +2103,6 @@ declare class RecordStore {
1962
2103
  static ɵprov: i0.ɵɵInjectableDeclaration<RecordStore>;
1963
2104
  }
1964
2105
 
1965
- /** Values the placeholders of a call are taken from. */
1966
- interface CallContext {
1967
- userInfo?: any;
1968
- record?: any;
1969
- records?: any[];
1970
- filter?: any;
1971
- env?: any;
1972
- /** Further values a button hands in (purchase: form, cart, response); one more key is {{item.x}} inside $each. */
1973
- [key: string]: any;
1974
- }
1975
- /** A call ready to send. */
1976
- interface BackendCall {
1977
- url: string;
1978
- method: string;
1979
- params: Record<string, string>;
1980
- body: any;
1981
- }
1982
- /**
1983
- * A template with its placeholders filled in. A string that is only one placeholder gives the value
1984
- * itself (a list stays a list); inside a longer text a missing value becomes empty. Objects and
1985
- * lists are filled in deeply.
1986
- */
1987
- declare function resolveTemplate(template: any, context: CallContext): any;
1988
- /** True when the option describes a backend call (it has an address). */
1989
- declare function hasBackendCall(option: any): boolean;
1990
- /**
1991
- * The call of an option: address, method, URL parameters and content with the placeholders filled in.
1992
- * A relative address is put after env.apiUrl. Without an address there is no call (null).
1993
- */
1994
- declare function buildBackendCall(option: any, context: CallContext): BackendCall | null;
1995
-
1996
2106
  declare class BackendCallService {
1997
2107
  private readonly remoteLists;
1998
2108
  private readonly utilityService;
@@ -2499,7 +2609,6 @@ declare function sectionSticky(section: any): boolean;
2499
2609
  */
2500
2610
  declare function sectionVisible(section: any, propertySchema: any): boolean;
2501
2611
 
2502
- /** The terms part of the app settings as readAppSettings gives it. */
2503
2612
  interface TermsSettings {
2504
2613
  enabled: boolean;
2505
2614
  confirmOnStart: boolean;
@@ -2530,11 +2639,12 @@ declare function termsStamp(terms: TermsSettings): string;
2530
2639
  declare function termsStorageKey(project: string): string;
2531
2640
  /** Whether the browser's acceptance covers this state. */
2532
2641
  declare function acceptedLocally(stored: TermsAcceptance | null | undefined, stamp: string): boolean;
2533
- /** An address with {{user}}, {{version}} and {{env.x}} filled in (URL-encoded); a relative one goes after apiUrl. */
2642
+ /** An address with {{user}}, {{version}}, {{userInfo.x}} and {{env.x}} filled in (URL-encoded); a relative one goes after apiUrl. */
2534
2643
  declare function termsUrl(url: string, values: {
2535
2644
  user: string;
2536
2645
  version: string;
2537
2646
  env?: Record<string, any>;
2647
+ userInfo?: any;
2538
2648
  }): string;
2539
2649
  /**
2540
2650
  * The backend's answer to the status question: { version, accepted }. The backend's version is the state that
@@ -2547,5 +2657,5 @@ declare function backendTermsState(answer: any, stamp: string): {
2547
2657
  /** The user the acceptance belongs to: e-mail, user name or subject of the sign-in. */
2548
2658
  declare function termsUser(userInfo: any): string;
2549
2659
 
2550
- export { AppVersionResetService, Autocomplete, BACKEND_PROXY_PREFIX, BackendCallService, CardComponent, CheckboxControl, ConfigService, ControlComponent, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, DEFAULT_DATE_FORMAT, DateFormatPipe, DateHintPipe, DateRangeControl, DateTextPipe, DateTimeControl, DropdownControl, FormComponent, GridComponent, HeaderMenuComponent, LogsComponent, MediaControl, MediaSourcePipe, MobileKeycloakService, MobileOidcService, MobileOktaService, ModelComponent, NetworkLogService, NotificationService, NumberControl, PageData, PaginationComponent, PasswordControl, PlaceholderPipe, READ_ATTEMPT_TIMEOUT, REQUEST_STAGES, RETRY_PAUSES, RETRY_STATUSES, RadioControl, RecordStore, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, RulesPipe, SIDE_DOCK_CLASS, STORAGE_DATE_FORMAT, SideMenuComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, ViewToolkitModule, VisiblePipe, acceptedLocally, applyLayoutDefaults, backendTermsState, backendUrl, buildBackendCall, buttonLocked, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, displayDateValue, displayNumber, fieldInnerLayoutStyle, fieldModel, fieldRules, fixedTimeText, formatDate, formatDates, fromStorageValue, hasBackendCall, inputFormatHint, isBrowserSource, isNativeMobile, isNativePhone, isSignedIn, languageDatePattern, layoutPlaceholder, lockHint, lockReason, lockReasons, mediaKind, normalizeCustomKeyboardType, numberShape, numberStep, numberSuffix, parseRecords, parseStorageDate, primeDatePattern, recordOf, resolveCustomKeyboardType, resolvePlaceholder, resolveTemplate, ruleMessage, sectionSpan, sectionSticky, sectionTabletSpan, sectionVisible, setDateLanguage, setInputHintLanguage, setToolkitKeyboardOnWeb, shapeDateDigits, shapeTimeText, sideDockWidth, splitReference, stagedRead, stagedRequest, storageKind, storageValue, storedToTyped, styleParts, termsStamp, termsStorageKey, termsToConfirm, termsUrl, termsUser, testAction, testFieldKey, testWrites, timeHourFormat, toggleMeridiem, toolkitKeyboardActive, typedToStored, usesTwelveHours, visibleFields, whenOnline };
2660
+ export { AppVersionResetService, Autocomplete, BACKEND_PROXY_PREFIX, BackendCallService, CardComponent, CheckboxControl, ConfigService, ControlComponent, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, DATA_KEY_ANSWER, DATA_KEY_NONE, DEFAULT_DATE_FORMAT, DateFormatPipe, DateHintPipe, DateRangeControl, DateTextPipe, DateTimeControl, DropdownControl, FormComponent, GridComponent, HeaderMenuComponent, LogsComponent, MediaControl, MediaSourcePipe, MobileKeycloakService, MobileOidcService, MobileOktaService, ModelComponent, NetworkLogService, NotificationService, NumberControl, PLACEHOLDER_SOURCES, PageData, PaginationComponent, PasswordControl, PlaceholderPipe, READ_ATTEMPT_TIMEOUT, REQUEST_STAGES, RETRY_PAUSES, RETRY_STATUSES, RadioControl, RecordStore, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, RulesPipe, SIDE_DOCK_CLASS, STORAGE_DATE_FORMAT, SideMenuComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, ViewToolkitModule, VisiblePipe, acceptedLocally, applyLayoutDefaults, backendTermsState, backendUrl, buildBackendCall, buttonLocked, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, displayDateValue, displayNumber, fieldInnerLayoutStyle, fieldModel, fieldRules, fillPlaceholders, fixedTimeText, formatDate, formatDates, fromStorageValue, hasBackendCall, inputFormatHint, isBrowserSource, isNativeMobile, isNativePhone, isSignedIn, languageDatePattern, layoutPlaceholder, lockHint, lockReason, lockReasons, mediaKind, normalizeCustomKeyboardType, numberShape, numberStep, numberSuffix, parseRecords, parseStorageDate, primeDatePattern, proxyFor, recordOf, recordsFrom, resolveCustomKeyboardType, resolvePlaceholder, resolveTemplate, ruleMessage, sectionSpan, sectionSticky, sectionTabletSpan, sectionVisible, setDateLanguage, setInputHintLanguage, setProxyEnvironment, setToolkitKeyboardOnWeb, shapeDateDigits, shapeTimeText, sideDockWidth, splitReference, stagedRead, stagedRequest, storageKind, storageValue, storedToTyped, styleParts, termsStamp, termsStorageKey, termsToConfirm, termsUrl, termsUser, testAction, testFieldKey, testFieldPath, testWrites, timeHourFormat, toggleMeridiem, toolkitKeyboardActive, typedToStored, usesTwelveHours, visibleFields, whenOnline };
2551
2661
  export type { BackendCall, CallContext, ControlKind, CustomKeyboardTarget, CustomKeyboardType, DataSource, FieldKind, FieldModel, FieldRules, LockHint, LockReason, MediaKind, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, NumberShape, OidcProvider, OidcRefresh, OidcTokens, PageDataDeps, RequestTimeoutMessages, StagedReadOptions, StorageKind, TermsAcceptance, TermsDialogDocument, TermsSettings };