@yomotech/view-toolkit 1.0.44 → 1.0.46

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.44",
3
+ "version": "1.0.46",
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 };
@@ -80,6 +80,11 @@ declare function fieldInnerLayoutStyle(formField: any, container?: 'dialog' | 'f
80
80
  * its action - the same in every language, whatever the caption says. data-vl-field / data-vl-action.
81
81
  */
82
82
  declare function testFieldKey(field: any): string | null;
83
+ /**
84
+ * The field's DTO name and its key, the way tests name it: "#/shipping/properties/street" -> "shipping.street",
85
+ * nested "#/order/properties/address/properties/city" -> "order.address.city". data-vl-path.
86
+ */
87
+ declare function testFieldPath(field: any): string | null;
83
88
  declare function testAction(option: any): string | null;
84
89
  /**
85
90
  * Whether a button writes real data: to the backend (storageType database - the card's disk icon,
@@ -329,6 +334,46 @@ declare function normalizeCustomKeyboardType(value: unknown): CustomKeyboardType
329
334
  */
330
335
  declare function resolveCustomKeyboardType(option: any, property: any): CustomKeyboardType | null;
331
336
 
337
+ /** Values the placeholders of a call are taken from. */
338
+ interface CallContext {
339
+ userInfo?: any;
340
+ record?: any;
341
+ records?: any[];
342
+ filter?: any;
343
+ env?: any;
344
+ /** Further values a button hands in (purchase: form, cart, response); one more key is {{item.x}} inside $each. */
345
+ [key: string]: any;
346
+ }
347
+ /** A call ready to send. */
348
+ interface BackendCall {
349
+ url: string;
350
+ method: string;
351
+ params: Record<string, string>;
352
+ body: any;
353
+ }
354
+ /**
355
+ * A template with its placeholders filled in. A string that is only one placeholder gives the value
356
+ * itself (a list stays a list); inside a longer text a missing value becomes empty. Objects and
357
+ * lists are filled in deeply.
358
+ */
359
+ declare function resolveTemplate(template: any, context: CallContext): any;
360
+ /** The sources a placeholder may name - the library knows no field names of an app, only these sources. */
361
+ declare const PLACEHOLDER_SOURCES: string[];
362
+ /**
363
+ * An address or text with the placeholders filled in that the context can answer: a known source
364
+ * ({{userInfo.x}}, {{env.x}}, {{record.x}}, {{form.x}}, {{filter.x}}, {{pageNumber}}, {{pageSize}}) - empty when the
365
+ * value is missing - or a field the context or the signed-in user has ({{p5_backend_url}}). Anything else stays as
366
+ * written, so a caller can fill its own ({{id}} of a delete). encode: URL-encode the values (an address part).
367
+ */
368
+ declare function fillPlaceholders(text: string, context: CallContext, encode?: boolean): string;
369
+ /** True when the option describes a backend call (it has an address). */
370
+ declare function hasBackendCall(option: any): boolean;
371
+ /**
372
+ * The call of an option: address, method, URL parameters and content with the placeholders filled in.
373
+ * A relative address is put after env.apiUrl. Without an address there is no call (null).
374
+ */
375
+ declare function buildBackendCall(option: any, context: CallContext): BackendCall | null;
376
+
332
377
  declare class RequestService {
333
378
  private http;
334
379
  pageSize: number;
@@ -337,11 +382,11 @@ declare class RequestService {
337
382
  constructor(http: HttpClient);
338
383
  getAllProject(): rxjs.Observable<Object>;
339
384
  getEnvironmet(selectedProject: any): rxjs.Observable<Object>;
340
- getSectionInfo(url: string, envUrl?: any, passToken?: boolean, selectedProject?: string, userInfo?: any): rxjs.Observable<Object>;
385
+ getSectionInfo(url: string, envUrl?: any, passToken?: boolean, selectedProject?: string, userInfo?: any, option?: any): rxjs.Observable<Object>;
341
386
  readFile(projectName: any, path: any): rxjs.Observable<Object>;
342
387
  getMainLayout(selectedProject: any): rxjs.Observable<Object>;
343
- getInfo(url: string): rxjs.Observable<Object>;
344
- dynamicCall(method: string | undefined, body: any | undefined, url: string, passToken?: boolean, selectedProject?: string, userInfo?: any): rxjs.Observable<Object>;
388
+ getInfo(url: string, option?: any): rxjs.Observable<Object>;
389
+ dynamicCall(method: string | undefined, body: any | undefined, url: string, passToken?: boolean, selectedProject?: string, userInfo?: any, option?: any): rxjs.Observable<Object>;
345
390
  createAuthorizationHeader(userInfo: any, tokenExist?: boolean): HttpHeaders;
346
391
  getLoginUser(token: any, issuer: string): rxjs.Observable<Object>;
347
392
  static ɵfac: i0.ɵɵFactoryDeclaration<RequestService, never>;
@@ -379,7 +424,12 @@ declare class UtilityService {
379
424
  parseBodyObject(obj: any): any;
380
425
  getTotalPrice(tableitemInfo: any): number;
381
426
  getTotalQuantity(tableitemInfo: any): number;
382
- replacePaginationParams(url: string, currentPage: number, pageSize: number): string;
427
+ /**
428
+ * A page's address with its placeholders: {{pageNumber}}, {{pageSize}} and - with a context - any field of the
429
+ * signed-in user ({{userInfo.userId}}) or the Configuration ({{env.x}}). Only page number and size were filled
430
+ * before, so an address could not name the user (hotel Bookings asked for user 3 whoever was signed in).
431
+ */
432
+ replacePaginationParams(url: string, currentPage: number, pageSize: number, context?: CallContext): string;
383
433
  customButton(option: any, propertySchema: any, projectSeleted: any, environment: any): void;
384
434
  /**
385
435
  * The page an entry opens for this user. The app settings form (Main with center.appSettings,
@@ -395,7 +445,6 @@ declare class UtilityService {
395
445
  * the roles there. The user's own fields win over a claim of the same name.
396
446
  */
397
447
  userClaims(userInfo: any): any;
398
- setTableData(data: any, option: any | undefined, tableitemInfo: any, projectSeleted: any): any;
399
448
  setOktaWebCredential(environment: any, projectName: any): {
400
449
  logo: string;
401
450
  baseUrl: any;
@@ -809,6 +858,17 @@ declare function parseRecords(value: unknown): any[];
809
858
  declare function recordOf(propertySchema: Record<string, any> | null | undefined, fields?: string[]): Record<string, any>;
810
859
 
811
860
  /** What PageData needs from the app: storage, backend, the question before deleting, a message. */
861
+ /** dataKey: the answer itself is the list (or the one record, a detail page). */
862
+ declare const DATA_KEY_ANSWER = "@answer";
863
+ /** dataKey: the answer carries no records (void, or only a status). */
864
+ declare const DATA_KEY_NONE = "@none";
865
+ /**
866
+ * The records in a backend answer. dataKey is where they stand: a path ("_embedded.orders"), @answer (the
867
+ * answer itself - a list, or one record) or @none (no records). Without dataKey (older data) the answer itself
868
+ * when it is a list, else its "content" (a Spring page), else none - or, with oneRecord, the answer as the one
869
+ * record (a page that loads a single record, e.g. a detail by its id).
870
+ */
871
+ declare function recordsFrom(answer: any, dataKey?: string | null, oneRecord?: boolean): any[];
812
872
  interface PageDataDeps {
813
873
  readRecords(source: DataSource): Promise<any[]>;
814
874
  writeRecords(source: DataSource, records: any[]): Promise<boolean>;
@@ -822,6 +882,8 @@ interface PageDataDeps {
822
882
  failed(key: string, error: unknown): void;
823
883
  /** Dates of browser records back to Date objects (optional). */
824
884
  restoreDates?(records: any[]): any[];
885
+ /** The app's own work on records just loaded from the backend, e.g. pictures from Media (optional). */
886
+ prepare?(records: any[]): Promise<any[]>;
825
887
  }
826
888
  declare class PageData {
827
889
  records: any[];
@@ -832,14 +894,30 @@ declare class PageData {
832
894
  totalItems: number;
833
895
  loading: boolean;
834
896
  filter: Record<string, any>;
897
+ /** The last backend answer as it came (its paging fields). */
898
+ lastAnswer: any;
835
899
  /** Called after every change of the state above - the container redraws. */
836
900
  onChange: () => void;
837
901
  readonly source: DataSource & Record<string, any>;
838
902
  private readonly deps;
903
+ /** Backend pages load one after another - a second request waits for the first (a card asked for page 2 while
904
+ * page 1 was still on its way, and page 2 replaced it: luv2shop search showed 2 of 7 hits). */
905
+ private queue;
906
+ /** Counts fresh loads; an appended page started before a fresh load is dropped. */
907
+ private generation;
908
+ /** The pages already added while scrolling (page 0 = the first). */
909
+ private loadedUpTo;
839
910
  constructor(source: DataSource & Record<string, any>, deps: PageDataDeps, pageSize?: number);
840
911
  /** Browser list and filter page: all records are here and paged in the app; a backend pages itself. */
841
912
  get clientPaging(): boolean;
842
913
  load(): Promise<void>;
914
+ /**
915
+ * A page of a backend list: fresh (append false) shows only that page, append adds it to the records shown -
916
+ * scrolling. Requests run one after another; a page already added, or beyond the last, is not asked again.
917
+ */
918
+ loadPage(page: number, append?: boolean): Promise<void>;
919
+ /** The list as it was left (back with the page X): its records and the pages they came from. */
920
+ restore(records: any[], page: number): void;
843
921
  /** Records the app loaded itself (a backend page with images, its own paging). */
844
922
  useRecords(records: any[]): void;
845
923
  setFilter(values: Record<string, any>): Promise<void>;
@@ -878,6 +956,7 @@ declare class CardComponent {
878
956
  private requestService;
879
957
  /** Marks for the app's test runner (#166): field key and button action. */
880
958
  readonly vlFieldKey: typeof testFieldKey;
959
+ readonly vlFieldPath: typeof testFieldPath;
881
960
  readonly vlAction: typeof testAction;
882
961
  readonly vlWrites: typeof testWrites;
883
962
  private readonly remoteLists;
@@ -945,6 +1024,8 @@ declare class CardComponent {
945
1024
  footerSchemaCopy: any;
946
1025
  constructor(utilityService: UtilityService, platform: Platform, http: HttpClient, configService: ConfigService, cdr: ChangeDetectorRef, zone: NgZone, modalService: NzModalService, notificationService: NotificationService, oauthService: OAuthService, requestService: RequestService);
947
1026
  ngOnInit(): void;
1027
+ /** The layout this card wrote last (translated) - any other is a new page's layout. */
1028
+ private translatedLayout;
948
1029
  ngOnChanges(changes: SimpleChanges): void;
949
1030
  onWindowResize(): void;
950
1031
  get displayedRecords(): any[];
@@ -1002,6 +1083,8 @@ declare class CardComponent {
1002
1083
  key: any;
1003
1084
  productSchema: any;
1004
1085
  };
1086
+ /** Every class of a style as one class string (array or text) - only the first was set before. */
1087
+ classNames(style: any): string;
1005
1088
  getStyleWithoutClasses(styleObject: any): {
1006
1089
  classes: string;
1007
1090
  style: Record<string, any>;
@@ -1177,6 +1260,7 @@ declare function lockHint(option: any, reason: LockReason, translations?: Record
1177
1260
  declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestroy {
1178
1261
  /** Marks for the app's test runner (#166): field key and button action. */
1179
1262
  readonly vlFieldKey: typeof testFieldKey;
1263
+ readonly vlFieldPath: typeof testFieldPath;
1180
1264
  private readonly remoteLists;
1181
1265
  /** Loaded lists by field reference. */
1182
1266
  remoteData: Record<string, any[]>;
@@ -1319,6 +1403,8 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1319
1403
  readonly picker: DateTimePickerService;
1320
1404
  private readonly host;
1321
1405
  private readonly cdr;
1406
+ /** Watches the element under the table; in view (with 250px ahead) it asks for the next page. */
1407
+ private observeEnd;
1322
1408
  ngOnDestroy(): void;
1323
1409
  private sideHintObserver?;
1324
1410
  /** Marks the table's scroll area while columns lie beyond its left or right edge. */
@@ -1341,6 +1427,12 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1341
1427
  pageSize: number;
1342
1428
  currentPage: number;
1343
1429
  pages: number[];
1430
+ /** The table pages by scrolling: its end in view asks for the next page (onPageChange). */
1431
+ scrollPagination: boolean;
1432
+ set scrollSentinel(el: ElementRef<HTMLElement> | undefined);
1433
+ private endObserver?;
1434
+ private endElement?;
1435
+ private askedPage;
1344
1436
  userInfo: any;
1345
1437
  /** A page from browser storage or a filter (A4): its records, delete and paging go through PageData. */
1346
1438
  pageData: PageData | null;
@@ -1424,13 +1516,22 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1424
1516
  private stopResize;
1425
1517
  translateSchema(schema: any, SelectedLanguage: any): any;
1426
1518
  getScope(scope: any): string;
1519
+ /** Every class of a style as one class string (array or text) - only the first was set before. */
1520
+ classNames(style: any): string;
1427
1521
  getStyleWithoutClasses(styleObject: any): {
1428
- classes: any;
1522
+ classes: string;
1429
1523
  style: any;
1430
1524
  };
1431
1525
  onScrollEvent(event: any): void;
1432
1526
  showLinkDetails(option: any, data: any): void;
1433
1527
  invokeGridBtnClick(option: any, propertySchema: any): void;
1528
+ /**
1529
+ * An action icon of a row (save / delete of an action column) calls its address. The address is filled per click
1530
+ * from the layout ({{field}} = the row's field) - the layout's own option stays as it is (it was overwritten, a
1531
+ * second row called the first row's id). After success only this row changes: the record the server answers, else
1532
+ * the values the action sets (option.afterSuccessSet, chosen in the Designer) - no value is fixed here (it wrote
1533
+ * "APPROVED", also when rejecting).
1534
+ */
1434
1535
  upsertAction(option: any, data: any): void;
1435
1536
  setActionColumn(option: any, data: any): boolean;
1436
1537
  findDynamicKeyAndValue(object: Record<string, any>): {
@@ -1510,7 +1611,7 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1510
1611
  /** The DTO type of a column as the data object declares it ("string", "quantity" ...). */
1511
1612
  cellType(col: any): string;
1512
1613
  static ɵfac: i0.ɵɵFactoryDeclaration<GridComponent, never>;
1513
- 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; }; "design": { "alias": "design"; "required": false; }; }, { "editRow": "editRow"; "designChange": "designChange"; "onPageChange": "onPageChange"; "onPageSizeChange": "onPageSizeChange"; "onGridScroll": "onGridScroll"; "showGridLink": "showGridLink"; "gridButtonClick": "gridButtonClick"; "gridIncreamentClick": "gridIncreamentClick"; "gridDecreamentClick": "gridDecreamentClick"; "gridImgClick": "gridImgClick"; }, never, never, true, never>;
1614
+ 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; }; "design": { "alias": "design"; "required": false; }; }, { "editRow": "editRow"; "designChange": "designChange"; "onPageChange": "onPageChange"; "onPageSizeChange": "onPageSizeChange"; "onGridScroll": "onGridScroll"; "showGridLink": "showGridLink"; "gridButtonClick": "gridButtonClick"; "gridIncreamentClick": "gridIncreamentClick"; "gridDecreamentClick": "gridDecreamentClick"; "gridImgClick": "gridImgClick"; }, never, never, true, never>;
1514
1615
  }
1515
1616
 
1516
1617
  declare class HeaderMenuComponent implements AfterViewInit {
@@ -1530,6 +1631,8 @@ declare class HeaderMenuComponent implements AfterViewInit {
1530
1631
  environment: any;
1531
1632
  tenantName: any;
1532
1633
  projectSeleted: any;
1634
+ /** The signed-in user - its name for the user element. */
1635
+ userInfo: any;
1533
1636
  cartInfo: any;
1534
1637
  buttonClick: EventEmitter<any>;
1535
1638
  showTableContent: EventEmitter<any>;
@@ -1539,14 +1642,26 @@ declare class HeaderMenuComponent implements AfterViewInit {
1539
1642
  ngOnChanges(changes: SimpleChanges): void;
1540
1643
  ngAfterViewInit(): void;
1541
1644
  getStyle(styleObject: any): Record<string, any>;
1645
+ /** The classes of a style (style.classes), for [ngClass] beside getStyle. */
1646
+ classNames(styleObject: any): string;
1542
1647
  isVisible(header: any): boolean;
1543
- shouldShowDefaultButton(header: any): boolean;
1648
+ /** The kinds of header elements; a group holds elements of its own. */
1649
+ static readonly KINDS: readonly ["image", "text", "button", "search", "cart", "user", "group"];
1650
+ /** An element's kind: its control, else (older headers) its field name or its cart action; else a button. */
1651
+ kindOf(header: any): string;
1652
+ /** Shown: visible, and - with islogin - only signed in (true) or only signed out (false). */
1653
+ isShown(header: any): boolean;
1654
+ /** The text of an element: label.caption, an older label text or caption. */
1655
+ captionOf(header: any): string;
1656
+ signedIn(): boolean;
1657
+ /** The name of the signed-in user (name, else email). */
1658
+ userName(): string;
1544
1659
  invokeSearchedItems(option: any, search: any): void;
1545
1660
  invokeHeaderButtonClick(option: any): void;
1546
1661
  invokeShowtableContent(option: any): void;
1547
1662
  setHeaderItems(items: any[]): Promise<any[]>;
1548
1663
  static ɵfac: i0.ɵɵFactoryDeclaration<HeaderMenuComponent, never>;
1549
- 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>;
1664
+ 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>;
1550
1665
  }
1551
1666
 
1552
1667
  declare class NetworkLogService {
@@ -1577,6 +1692,7 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1577
1692
  private utilityService;
1578
1693
  /** Marks for the app's test runner (#166): field key and button action. */
1579
1694
  readonly vlFieldKey: typeof testFieldKey;
1695
+ readonly vlFieldPath: typeof testFieldPath;
1580
1696
  private readonly remoteLists;
1581
1697
  /** Date and time picker behaviour shared by all containers. */
1582
1698
  readonly picker: DateTimePickerService;
@@ -1686,6 +1802,10 @@ declare class PaginationComponent implements OnInit {
1686
1802
  private updateDeviceMode;
1687
1803
  get isFirstPage(): boolean;
1688
1804
  get isLastPage(): boolean;
1805
+ /** The sizes offered: the layout's (or 5/10/15/20) and the size in use, sorted - a size the backend chose stays visible. */
1806
+ sizeOptions(): number[];
1807
+ /** The classes the layout gives the bar (pagination.style.classes) - the app's style.css styles the bar through them. */
1808
+ get paginationClasses(): string;
1689
1809
  get paginationStyle(): Record<string, any>;
1690
1810
  get listStyle(): Record<string, any>;
1691
1811
  get sizeControlStyle(): Record<string, any>;
@@ -1928,6 +2048,14 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
1928
2048
  private destroyMobileLoginSubscription;
1929
2049
  private clearLoginUser;
1930
2050
  getUserInfoFromToken(token: string): any | null;
2051
+ /**
2052
+ * Whether a menu entry is hidden: sign-in (option.login) like before, and an entry with option.role only for a
2053
+ * user of that role. The role is the user's value under the app settings' roleKey (default userRole), compared
2054
+ * without case - Main says "ADMIN", a backend may answer "admin". hotel showed admin and customer entries to all.
2055
+ */
2056
+ itemHidden(item: any, submenu?: boolean): boolean;
2057
+ /** True without option.role, else when the signed-in user has that role (case does not matter). */
2058
+ private roleFits;
1931
2059
  setLoginedUser(user: any): void;
1932
2060
  /** The menu entry with action 'logout', at any depth of the menu. */
1933
2061
  private findLogoutMenu;
@@ -2408,13 +2536,20 @@ declare class RemoteListService {
2408
2536
  static ɵprov: i0.ɵɵInjectableDeclaration<RemoteListService>;
2409
2537
  }
2410
2538
 
2539
+ /** The app's environment (Configuration), set once by the app; the default for every call. */
2540
+ declare function setProxyEnvironment(environment: any): void;
2541
+ /** true: through the proxy. The call decides (option.proxy true/false), else the Configuration (environment.proxy). */
2542
+ declare function proxyFor(option?: any, environment?: any): boolean;
2543
+
2411
2544
  /** Prefix of the forwarding path on the app's own origin. */
2412
2545
  declare const BACKEND_PROXY_PREFIX = "/api/proxy";
2546
+
2413
2547
  /**
2414
- * The address to call for a backend URL: unchanged on the devices and for relative URLs; in the web
2415
- * https://p5w1.wilken.de/p5ws/x?y=1 becomes <origin>/api/proxy/p5w1.wilken.de/p5ws/x?y=1.
2548
+ * The address to call for a backend URL. Through the proxy only when the customer switched it on (proxyFor:
2549
+ * the call's option.proxy, else the Configuration) - never automatically (user decision 2026-10-25). Unchanged
2550
+ * on the devices (native HTTP, no CORS) and for relative URLs.
2416
2551
  */
2417
- declare function backendUrl(url: string): string;
2552
+ declare function backendUrl(url: string, proxy: boolean): string;
2418
2553
 
2419
2554
  declare class RecordStore {
2420
2555
  private utilityService;
@@ -2434,37 +2569,6 @@ declare class RecordStore {
2434
2569
  static ɵprov: i0.ɵɵInjectableDeclaration<RecordStore>;
2435
2570
  }
2436
2571
 
2437
- /** Values the placeholders of a call are taken from. */
2438
- interface CallContext {
2439
- userInfo?: any;
2440
- record?: any;
2441
- records?: any[];
2442
- filter?: any;
2443
- env?: any;
2444
- /** Further values a button hands in (purchase: form, cart, response); one more key is {{item.x}} inside $each. */
2445
- [key: string]: any;
2446
- }
2447
- /** A call ready to send. */
2448
- interface BackendCall {
2449
- url: string;
2450
- method: string;
2451
- params: Record<string, string>;
2452
- body: any;
2453
- }
2454
- /**
2455
- * A template with its placeholders filled in. A string that is only one placeholder gives the value
2456
- * itself (a list stays a list); inside a longer text a missing value becomes empty. Objects and
2457
- * lists are filled in deeply.
2458
- */
2459
- declare function resolveTemplate(template: any, context: CallContext): any;
2460
- /** True when the option describes a backend call (it has an address). */
2461
- declare function hasBackendCall(option: any): boolean;
2462
- /**
2463
- * The call of an option: address, method, URL parameters and content with the placeholders filled in.
2464
- * A relative address is put after env.apiUrl. Without an address there is no call (null).
2465
- */
2466
- declare function buildBackendCall(option: any, context: CallContext): BackendCall | null;
2467
-
2468
2572
  declare class BackendCallService {
2469
2573
  private readonly remoteLists;
2470
2574
  private readonly utilityService;
@@ -2971,7 +3075,6 @@ declare function sectionSticky(section: any): boolean;
2971
3075
  */
2972
3076
  declare function sectionVisible(section: any, propertySchema: any): boolean;
2973
3077
 
2974
- /** The terms part of the app settings as readAppSettings gives it. */
2975
3078
  interface TermsSettings {
2976
3079
  enabled: boolean;
2977
3080
  confirmOnStart: boolean;
@@ -3002,11 +3105,12 @@ declare function termsStamp(terms: TermsSettings): string;
3002
3105
  declare function termsStorageKey(project: string): string;
3003
3106
  /** Whether the browser's acceptance covers this state. */
3004
3107
  declare function acceptedLocally(stored: TermsAcceptance | null | undefined, stamp: string): boolean;
3005
- /** An address with {{user}}, {{version}} and {{env.x}} filled in (URL-encoded); a relative one goes after apiUrl. */
3108
+ /** An address with {{user}}, {{version}}, {{userInfo.x}} and {{env.x}} filled in (URL-encoded); a relative one goes after apiUrl. */
3006
3109
  declare function termsUrl(url: string, values: {
3007
3110
  user: string;
3008
3111
  version: string;
3009
3112
  env?: Record<string, any>;
3113
+ userInfo?: any;
3010
3114
  }): string;
3011
3115
  /**
3012
3116
  * The backend's answer to the status question: { version, accepted }. The backend's version is the state that
@@ -3044,5 +3148,5 @@ declare function sampleValue(type: string | undefined, name: string, index: numb
3044
3148
  */
3045
3149
  declare function sampleRecords(nodes: any[], propertySchema: any, count: number, image?: string): any[];
3046
3150
 
3047
- export { AppVersionResetService, Autocomplete, BACKEND_PROXY_PREFIX, BackendCallService, CardComponent, CardDesigner, CheckboxControl, ConfigService, ControlComponent, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, DEFAULT_DATE_FORMAT, DESIGN_TEXTS, DateFormatPipe, DateHintPipe, DateRangeControl, DateTextPipe, DateTimeControl, DesignBarComponent, DropMarkerComponent, DropdownControl, FormComponent, GRID_COLUMNS, GridComponent, HeaderMenuComponent, LogsComponent, MAX_FIELDS_PER_ROW, 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, SectionDesigner, SideMenuComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, ViewToolkitModule, VisiblePipe, acceptedLocally, addButton, addCardButton, addSection, applyLayoutDefaults, backendTermsState, backendUrl, buildBackendCall, buttonLocked, cardButton, clearHeader, cloneLayout, columnFromProperty, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, designDropIds, designTexts, displayDateValue, displayNumber, dropCardProperty, dropGridProperty, dropObjectName, dropProperty, dropTypeAt, elementFromProperty, fieldFromProperty, fieldInnerLayoutStyle, fieldModel, fieldRules, fieldSpan, fixedTimeText, formatDate, formatDates, fromStorageValue, hasBackendCall, headerButton, inputFormatHint, insertField, isBrowserSource, isNativeMobile, isNativePhone, isPropertyDrop, isSignedIn, isTarget, languageDatePattern, layoutPlaceholder, lockHint, lockReason, lockReasons, mediaKind, moveCardElement, moveColumn, moveField, moveSection, newButton, newSection, normalizeCard, normalizeCustomKeyboardType, normalizeSections, numberShape, numberStep, numberSuffix, parseRecords, parseStorageDate, primeDatePattern, rebalanceRow, recordOf, removeCardElement, removeColumn, removeField, removeHeaderElement, removeSection, replaceCardElement, replaceColumn, replaceField, replaceSection, resizeColumn, resolveCustomKeyboardType, resolvePlaceholder, resolveTemplate, ruleMessage, sampleRecords, sampleValue, 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, withAppPagination };
3151
+ export { AppVersionResetService, Autocomplete, BACKEND_PROXY_PREFIX, BackendCallService, CardComponent, CardDesigner, CheckboxControl, ConfigService, ControlComponent, Couchdb, CustomKeyboardComponent, CustomKeyboardDirective, CustomKeyboardService, DATA_KEY_ANSWER, DATA_KEY_NONE, DEFAULT_DATE_FORMAT, DESIGN_TEXTS, DateFormatPipe, DateHintPipe, DateRangeControl, DateTextPipe, DateTimeControl, DesignBarComponent, DropMarkerComponent, DropdownControl, FormComponent, GRID_COLUMNS, GridComponent, HeaderMenuComponent, LogsComponent, MAX_FIELDS_PER_ROW, 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, SectionDesigner, SideMenuComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, ViewToolkitModule, VisiblePipe, acceptedLocally, addButton, addCardButton, addSection, applyLayoutDefaults, backendTermsState, backendUrl, buildBackendCall, buttonLocked, cardButton, clearHeader, cloneLayout, columnFromProperty, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, designDropIds, designTexts, displayDateValue, displayNumber, dropCardProperty, dropGridProperty, dropObjectName, dropProperty, dropTypeAt, elementFromProperty, fieldFromProperty, fieldInnerLayoutStyle, fieldModel, fieldRules, fieldSpan, fillPlaceholders, fixedTimeText, formatDate, formatDates, fromStorageValue, hasBackendCall, headerButton, inputFormatHint, insertField, isBrowserSource, isNativeMobile, isNativePhone, isPropertyDrop, isSignedIn, isTarget, languageDatePattern, layoutPlaceholder, lockHint, lockReason, lockReasons, mediaKind, moveCardElement, moveColumn, moveField, moveSection, newButton, newSection, normalizeCard, normalizeCustomKeyboardType, normalizeSections, numberShape, numberStep, numberSuffix, parseRecords, parseStorageDate, primeDatePattern, proxyFor, rebalanceRow, recordOf, recordsFrom, removeCardElement, removeColumn, removeField, removeHeaderElement, removeSection, replaceCardElement, replaceColumn, replaceField, replaceSection, resizeColumn, resolveCustomKeyboardType, resolvePlaceholder, resolveTemplate, ruleMessage, sampleRecords, sampleValue, 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, withAppPagination };
3048
3152
  export type { BackendCall, CallContext, CardDesignerHost, CardDragData, CardDropSpot, CardDropType, CardPlace, ControlKind, CustomKeyboardTarget, CustomKeyboardType, DataSource, DesignAction, DesignDevice, DesignEvent, DesignPropertyDrop, DesignTarget, DesignTexts, DropSpot, DropType, FieldKind, FieldModel, FieldRules, LockHint, LockReason, MediaKind, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, NumberShape, OidcProvider, OidcRefresh, OidcTokens, PageDataDeps, RequestTimeoutMessages, SectionDesignerHost, SectionDragData, SectionKind, StagedReadOptions, StorageKind, TermsAcceptance, TermsDialogDocument, TermsSettings, VlDesign };