@yomotech/view-toolkit 1.0.44 → 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.
@@ -1,7 +1,6 @@
1
1
  import * as i0 from '@angular/core';
2
2
  import { EventEmitter, ElementRef, ChangeDetectorRef, NgZone, SimpleChanges, OnInit, OnChanges, AfterViewInit, OnDestroy, Injector, PipeTransform } from '@angular/core';
3
3
  import * as i1 from '@angular/common';
4
- import { CdkDragMove, CdkDragDrop } from '@angular/cdk/drag-drop';
5
4
  import * as rxjs from 'rxjs';
6
5
  import { Platform } from '@angular/cdk/platform';
7
6
  import { HttpClient, HttpHeaders } from '@angular/common/http';
@@ -80,6 +79,11 @@ declare function fieldInnerLayoutStyle(formField: any, container?: 'dialog' | 'f
80
79
  * its action - the same in every language, whatever the caption says. data-vl-field / data-vl-action.
81
80
  */
82
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;
83
87
  declare function testAction(option: any): string | null;
84
88
  /**
85
89
  * Whether a button writes real data: to the backend (storageType database - the card's disk icon,
@@ -88,246 +92,53 @@ declare function testAction(option: any): string | null;
88
92
  */
89
93
  declare function testWrites(option: any): 'true' | 'false';
90
94
 
91
- /** The device the Designer shows the page on (its Desktop / Tablet / Mobile switch). */
92
- type DesignDevice = 'desktop' | 'tablet' | 'mobile';
93
- /** What the Designer hands a container in design mode. Without it the container is the app's container. */
94
- interface VlDesign {
95
- /** the element whose settings are open in the Designer - shown marked */
96
- selected?: DesignTarget | null;
97
- /** the device the page is shown on; the containers that choose by the window (card columns) follow it */
98
- device?: DesignDevice;
99
- /** texts of the design handles in the Designer's language; English for every text not given */
100
- texts?: Partial<DesignTexts>;
101
- /** how many sample records card and grid show (the page's page size when not given) */
102
- sampleCount?: number;
103
- /** the picture a media field shows in a sample record */
104
- sampleImage?: string;
105
- /** the project's Main layout - the page bar of card and grid takes its values where the page has none */
106
- main?: any;
107
- }
108
- /** One element of a layout the Designer can open the settings of. */
109
- interface DesignTarget {
110
- /**
111
- * container: the layout itself (card, grid); section / field: a section and its field (form, dialog);
112
- * element: a card element, parentIndex the horizontal layout holding it; header / headerElement: the card's
113
- * header and one of its buttons; column: a grid column
114
- */
115
- kind: 'container' | 'section' | 'field' | 'element' | 'header' | 'headerElement' | 'column';
116
- sectionIndex?: number;
117
- fieldIndex?: number;
118
- index?: number;
119
- parentIndex?: number | null;
120
- /** the part that was clicked: the field itself (input) or its edit button (none) */
121
- part?: 'input';
122
- }
123
- /** What a container in design mode tells the Designer. */
124
- type DesignEvent =
125
- /** an element was chosen: the Designer opens its settings */
126
- {
127
- type: 'select';
128
- target: DesignTarget;
129
- }
130
- /** nothing is chosen any more (a drag started) */
131
- | {
132
- type: 'deselect';
133
- }
134
- /** the container's layout changed (drop, move, add, delete): the Designer saves it */
135
- | {
136
- type: 'layout';
137
- layoutSchema: any;
138
- }
95
+ type CustomKeyboardType = 'email' | 'numeric' | 'alpha' | 'string' | 'date' | 'time';
96
+ declare function normalizeCustomKeyboardType(value: unknown): CustomKeyboardType | null;
139
97
  /**
140
- * the page header the card shows changed (it belongs to the whole page: the Designer keeps it and hands it back
141
- * in itemInfo.header); added: the button that was added to it
98
+ * Keyboard for a field: option.keyboardType (or the older option.keyboard) when the layout sets one, otherwise derived from the
99
+ * attribute (property schema) type. Returns null where the system keyboard stays in charge.
142
100
  */
143
- | {
144
- type: 'header';
145
- header: any;
146
- added?: any;
147
- };
148
- /** A field dragged from the Designer's data objects onto a container. */
149
- interface DesignPropertyDrop {
150
- kind: 'object-property';
151
- objectName?: string;
152
- objectNode?: {
153
- name?: string;
154
- };
155
- name: string;
156
- type?: string;
157
- }
158
- /** The texts of the design handles. */
159
- interface DesignTexts {
160
- dragSection: string;
161
- addButton: string;
162
- editSection: string;
163
- deleteSection: string;
164
- section: string;
165
- addSection: string;
166
- dragField: string;
167
- editField: string;
168
- deleteField: string;
169
- emptySection: string;
170
- dropHere: string;
171
- placeAbove: string;
172
- placeBelow: string;
173
- placeLeft: string;
174
- placeRight: string;
175
- hiddenInApp: string;
176
- edit: string;
177
- delete: string;
178
- editLayout: string;
179
- addCard: string;
180
- deleteCard: string;
181
- addHeaderButton: string;
182
- editHeader: string;
183
- clearHeader: string;
184
- editHeaderButton: string;
185
- deleteHeaderButton: string;
186
- emptyCardTitle: string;
187
- emptyCardText: string;
188
- dropCardItem: string;
189
- dragColumn: string;
190
- editColumn: string;
191
- deleteColumn: string;
192
- resizeWidth: string;
193
- resizeHeight: string;
194
- editGrid: string;
195
- emptyGrid: string;
196
- button: string;
197
- }
198
- declare const DESIGN_TEXTS: DesignTexts;
199
- /** The design texts with the Designer's own over the English ones. */
200
- declare function designTexts(design: VlDesign | null | undefined): DesignTexts;
201
- /** Whether the target is the element (same kind and place) - the selection mark. */
202
- declare function isTarget(selected: DesignTarget | null | undefined, target: DesignTarget): boolean;
203
- /** A drop from the Designer's data objects (not an element moved inside the container). */
204
- declare function isPropertyDrop(data: any): data is DesignPropertyDrop;
205
- /** The data object a dropped property belongs to ("orders.json" -> "orders"). */
206
- declare function dropObjectName(drop: DesignPropertyDrop): string;
207
- /** A copy of a layout (layouts are JSON). */
208
- declare function cloneLayout<T>(value: T): T;
209
- /** The ids of every drop list of the containers in design mode on the page (the Designer's data objects drop on them). */
210
- declare function designDropIds(): string[];
211
-
212
- type CardDropType = 'before' | 'after' | 'left' | 'right' | 'empty';
213
- /** Where a dragged element lands: at a card element (index), or inside the horizontal layout parentIndex at innerIndex. */
214
- interface CardDropSpot {
215
- type: CardDropType;
216
- /** the card element the drop is placed at; null: at the end */
217
- index: number | null;
218
- /** the horizontal layout the drop goes into; null: the card's own list */
219
- parentIndex: number | null;
220
- innerIndex: number | null;
221
- }
222
- /** An element of the card's list (parentIndex null) or of a horizontal layout in it. */
223
- interface CardPlace {
224
- index: number;
225
- parentIndex: number | null;
101
+ declare function resolveCustomKeyboardType(option: any, property: any): CustomKeyboardType | null;
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;
226
119
  }
227
120
  /**
228
- * The card layout as the Designer keeps it, changed in place: no empty classes on the card styles, the card's
229
- * columns are drawn by the container (no gridTemplateColumns in its style), no classes on the elements (the right
230
- * panel sets styles only), horizontal layouts in shape.
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.
231
124
  */
232
- declare function normalizeCard(layout: any): any;
233
- /** A button as the Designer adds it to a card. */
234
- declare function cardButton(caption?: string): any;
235
- /** The card element a data object's property becomes when it is dropped: its value, read only. */
236
- declare function elementFromProperty(drop: DesignPropertyDrop, caption?: string): any;
237
- /** A data object's field dropped at the spot. */
238
- declare function dropCardProperty(layout: any, drop: DesignPropertyDrop, spot: CardDropSpot, buttonCaption?: string): any;
239
- /** An element moved from its place to the spot. */
240
- declare function moveCardElement(layout: any, from: CardPlace, spot: CardDropSpot): any;
241
- declare function removeCardElement(layout: any, place: CardPlace): any;
242
- /** A button added after the element (in its horizontal layout when it stands in one). */
243
- declare function addCardButton(layout: any, after: CardPlace, caption?: string): any;
244
- /** The settings of a card element changed in the Designer's right panel. */
245
- declare function replaceCardElement(layout: any, place: CardPlace, element: any): any;
246
- /** A button as the Designer adds it to the page header (it opens the page's dialog). */
247
- declare function headerButton(caption?: string): any;
248
- declare function removeHeaderElement(header: any, index: number): any;
249
- declare function clearHeader(header: any): any;
250
-
251
- interface CardDesignerHost {
252
- layout(): any;
253
- apply(next: any): void;
254
- select(target: DesignTarget): void;
255
- deselect(): void;
256
- /** the view is drawn again (the apps run without zone.js: a change after a timer is not seen otherwise) */
257
- refresh(): void;
258
- }
259
- /** The data an element carries while it is dragged inside the card. */
260
- interface CardDragData {
261
- vlDesign: 'cardElement';
262
- index: number;
263
- parentIndex: number | null;
264
- }
265
- declare class CardDesigner {
266
- private readonly host;
267
- hint: CardDropSpot | null;
268
- private dragging;
269
- private moving;
270
- readonly prefix: string;
271
- constructor(host: CardDesignerHost);
272
- /** The drop list of the card's elements. */
273
- listId(): string;
274
- /** The drop list of the horizontal layout at index. */
275
- innerListId(index: number): string;
276
- /** The card's list and every horizontal layout's list, so an element can go from one into another. */
277
- listIds(): string[];
278
- dragData(index: number, parentIndex: number | null): CardDragData;
279
- private rowsOf;
280
- private inside;
281
- /** The drop spot at a point of the first card: inside a horizontal layout first, else among the card's elements. */
282
- spotAt(x: number, y: number): CardDropSpot;
283
- private setHint;
284
- entered(): void;
285
- pointerMove(event: MouseEvent): void;
286
- exited(): void;
287
- dragStarted(): void;
288
- dragMoved(event: CdkDragMove<any>): void;
289
- dragEnded(): void;
290
- clear(): void;
291
- /** An empty card list (parentIndex null) or an empty horizontal layout under the pointer. */
292
- isEmptyHint(parentIndex: number | null): boolean;
293
- /** The element the hint is drawn at: a card element (parentIndex null) or an element of a horizontal layout. */
294
- isTargetHint(index: number, parentIndex: number | null): boolean;
295
- hintText(texts: DesignTexts): string;
296
- dropped(event: CdkDragDrop<any>, buttonCaption?: string): void;
297
- addButton(index: number, parentIndex: number | null, caption?: string): void;
298
- remove(index: number, parentIndex: number | null): void;
299
- edit(index: number, parentIndex: number | null): void;
300
- }
301
-
302
- type DesignAction = 'drag' | 'add' | 'edit' | 'delete';
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[];
303
128
  /**
304
- * The handles of one element. "drag" is the cdkDragHandle of the element it stands in; the others report their
305
- * action (act) without the click reaching the element.
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).
306
133
  */
307
- declare class DesignBarComponent {
308
- actions: DesignAction[];
309
- /** the tooltip of each handle */
310
- titles: Partial<Record<DesignAction, string>>;
311
- act: EventEmitter<DesignAction>;
312
- icon(action: DesignAction): string;
313
- static ɵfac: i0.ɵɵFactoryDeclaration<DesignBarComponent, never>;
314
- static ɵcmp: i0.ɵɵComponentDeclaration<DesignBarComponent, "vl-design-bar", never, { "actions": { "alias": "actions"; "required": false; }; "titles": { "alias": "titles"; "required": false; }; }, { "act": "act"; }, never, never, true, never>;
315
- }
316
- /** Where a dragged element lands: a line above, below, left or right of an element, or a box in an empty place. */
317
- declare class DropMarkerComponent {
318
- type: 'before' | 'after' | 'left' | 'right' | 'empty';
319
- text: string;
320
- static ɵfac: i0.ɵɵFactoryDeclaration<DropMarkerComponent, never>;
321
- static ɵcmp: i0.ɵɵComponentDeclaration<DropMarkerComponent, "vl-drop-marker", never, { "type": { "alias": "type"; "required": false; }; "text": { "alias": "text"; "required": false; }; }, {}, never, never, true, never>;
322
- }
323
-
324
- type CustomKeyboardType = 'email' | 'numeric' | 'alpha' | 'string' | 'date' | 'time';
325
- declare function normalizeCustomKeyboardType(value: unknown): CustomKeyboardType | null;
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;
326
137
  /**
327
- * Keyboard for a field: option.keyboardType (or the older option.keyboard) when the layout sets one, otherwise derived from the
328
- * attribute (property schema) type. Returns null where the system keyboard stays in charge.
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).
329
140
  */
330
- declare function resolveCustomKeyboardType(option: any, property: any): CustomKeyboardType | null;
141
+ declare function buildBackendCall(option: any, context: CallContext): BackendCall | null;
331
142
 
332
143
  declare class RequestService {
333
144
  private http;
@@ -337,11 +148,11 @@ declare class RequestService {
337
148
  constructor(http: HttpClient);
338
149
  getAllProject(): rxjs.Observable<Object>;
339
150
  getEnvironmet(selectedProject: any): rxjs.Observable<Object>;
340
- 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>;
341
152
  readFile(projectName: any, path: any): rxjs.Observable<Object>;
342
153
  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>;
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>;
345
156
  createAuthorizationHeader(userInfo: any, tokenExist?: boolean): HttpHeaders;
346
157
  getLoginUser(token: any, issuer: string): rxjs.Observable<Object>;
347
158
  static ɵfac: i0.ɵɵFactoryDeclaration<RequestService, never>;
@@ -379,7 +190,12 @@ declare class UtilityService {
379
190
  parseBodyObject(obj: any): any;
380
191
  getTotalPrice(tableitemInfo: any): number;
381
192
  getTotalQuantity(tableitemInfo: any): number;
382
- 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;
383
199
  customButton(option: any, propertySchema: any, projectSeleted: any, environment: any): void;
384
200
  /**
385
201
  * The page an entry opens for this user. The app settings form (Main with center.appSettings,
@@ -395,7 +211,6 @@ declare class UtilityService {
395
211
  * the roles there. The user's own fields win over a claim of the same name.
396
212
  */
397
213
  userClaims(userInfo: any): any;
398
- setTableData(data: any, option: any | undefined, tableitemInfo: any, projectSeleted: any): any;
399
214
  setOktaWebCredential(environment: any, projectName: any): {
400
215
  logo: string;
401
216
  baseUrl: any;
@@ -809,6 +624,17 @@ declare function parseRecords(value: unknown): any[];
809
624
  declare function recordOf(propertySchema: Record<string, any> | null | undefined, fields?: string[]): Record<string, any>;
810
625
 
811
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[];
812
638
  interface PageDataDeps {
813
639
  readRecords(source: DataSource): Promise<any[]>;
814
640
  writeRecords(source: DataSource, records: any[]): Promise<boolean>;
@@ -822,6 +648,8 @@ interface PageDataDeps {
822
648
  failed(key: string, error: unknown): void;
823
649
  /** Dates of browser records back to Date objects (optional). */
824
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[]>;
825
653
  }
826
654
  declare class PageData {
827
655
  records: any[];
@@ -832,14 +660,30 @@ declare class PageData {
832
660
  totalItems: number;
833
661
  loading: boolean;
834
662
  filter: Record<string, any>;
663
+ /** The last backend answer as it came (its paging fields). */
664
+ lastAnswer: any;
835
665
  /** Called after every change of the state above - the container redraws. */
836
666
  onChange: () => void;
837
667
  readonly source: DataSource & Record<string, any>;
838
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;
839
676
  constructor(source: DataSource & Record<string, any>, deps: PageDataDeps, pageSize?: number);
840
677
  /** Browser list and filter page: all records are here and paged in the app; a backend pages itself. */
841
678
  get clientPaging(): boolean;
842
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;
843
687
  /** Records the app loaded itself (a backend page with images, its own paging). */
844
688
  useRecords(records: any[]): void;
845
689
  setFilter(values: Record<string, any>): Promise<void>;
@@ -878,6 +722,7 @@ declare class CardComponent {
878
722
  private requestService;
879
723
  /** Marks for the app's test runner (#166): field key and button action. */
880
724
  readonly vlFieldKey: typeof testFieldKey;
725
+ readonly vlFieldPath: typeof testFieldPath;
881
726
  readonly vlAction: typeof testAction;
882
727
  readonly vlWrites: typeof testWrites;
883
728
  private readonly remoteLists;
@@ -914,26 +759,6 @@ declare class CardComponent {
914
759
  onPageChange: EventEmitter<any>;
915
760
  paginationMode: 'client' | 'server';
916
761
  paginationLoading: boolean;
917
- /** The Designer's canvas: sample records, every element with drag, edit and delete, nothing loaded (design/design.ts). */
918
- design: VlDesign | null;
919
- /** What was chosen or changed on the Designer's canvas. */
920
- designChange: EventEmitter<DesignEvent>;
921
- /** The texts of the design handles. */
922
- dt: DesignTexts;
923
- /** How many sample cards the canvas shows (Add card / Delete card). */
924
- designCount: number;
925
- /** The page of sample cards the canvas shows. */
926
- designPage: number;
927
- designPageSize: number;
928
- /** The sample records, the area with its page bar and the pages of the canvas, renewed when the layout changes. */
929
- designAll: any[];
930
- designInfo: any;
931
- designPages: number[];
932
- /** Drag and drop of the card's elements in design mode. */
933
- readonly designer: CardDesigner;
934
- /** The device the Designer shows the page on. */
935
- get designMobile(): boolean;
936
- get designTablet(): boolean;
937
762
  scrollPaginationSentinel?: ElementRef<HTMLElement>;
938
763
  private scrollObserver?;
939
764
  private requestedScrollPage;
@@ -945,6 +770,8 @@ declare class CardComponent {
945
770
  footerSchemaCopy: any;
946
771
  constructor(utilityService: UtilityService, platform: Platform, http: HttpClient, configService: ConfigService, cdr: ChangeDetectorRef, zone: NgZone, modalService: NzModalService, notificationService: NotificationService, oauthService: OAuthService, requestService: RequestService);
947
772
  ngOnInit(): void;
773
+ /** The layout this card wrote last (translated) - any other is a new page's layout. */
774
+ private translatedLayout;
948
775
  ngOnChanges(changes: SimpleChanges): void;
949
776
  onWindowResize(): void;
950
777
  get displayedRecords(): any[];
@@ -955,25 +782,6 @@ declare class CardComponent {
955
782
  private destroyScrollObserver;
956
783
  ngOnDestroy(): void;
957
784
  ngAfterViewInit(): void;
958
- /** The sample records, the page bar and its pages of the canvas, from the layout as it is now. */
959
- refreshDesign(): void;
960
- /** The sample cards of the page shown, the first one with the handles - the same list while nothing changed. */
961
- get designRecords(): any[];
962
- private recordsMemo;
963
- isSelected(target: DesignTarget): boolean;
964
- /** A card element hidden in the app (the card shows an element only with option.visible). */
965
- hiddenInApp(element: any): boolean;
966
- /**
967
- * The card's own handles: a button for the page header, the settings of the card layout. The header belongs to
968
- * the whole page: its changes are told to the Designer (type header), which keeps and hands it back.
969
- */
970
- containerAction(action: DesignAction): void;
971
- headerAction(action: DesignAction): void;
972
- headerElementAction(action: DesignAction, index: number): void;
973
- elementAction(action: DesignAction, index: number, parentIndex: number | null): void;
974
- /** Add card / Delete card: more or fewer sample cards, the layout stays. */
975
- cardAction(action: DesignAction): void;
976
- designGoToPage(page: number): void;
977
785
  getRecordIndex(record: any): number;
978
786
  private updateDeviceMode;
979
787
  private safeUpdate;
@@ -1002,6 +810,8 @@ declare class CardComponent {
1002
810
  key: any;
1003
811
  productSchema: any;
1004
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;
1005
815
  getStyleWithoutClasses(styleObject: any): {
1006
816
  classes: string;
1007
817
  style: Record<string, any>;
@@ -1023,120 +833,7 @@ declare class CardComponent {
1023
833
  */
1024
834
  keyboardTypeFor(field: any, propertySchema: any): CustomKeyboardType | null;
1025
835
  static ɵfac: i0.ɵɵFactoryDeclaration<CardComponent, never>;
1026
- static ɵcmp: i0.ɵɵComponentDeclaration<CardComponent, "vl-card", never, { "itemInfo": { "alias": "itemInfo"; "required": false; }; "pageData": { "alias": "pageData"; "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; }; "design": { "alias": "design"; "required": false; }; }, { "cardButtonClick": "cardButtonClick"; "cardHeaderButtonClick": "cardHeaderButtonClick"; "linkDetails": "linkDetails"; "imageDetails": "imageDetails"; "onPageSizeChange": "onPageSizeChange"; "onPageChange": "onPageChange"; "designChange": "designChange"; }, never, never, true, never>;
1027
- }
1028
-
1029
- /** form: vl-form; dialog: vl-model. Both lay out formSections with formFields. */
1030
- type SectionKind = 'form' | 'dialog';
1031
- /** Where a dragged field lands: above or below a field (its own row), beside it (its row), or in an empty section. */
1032
- type DropType = 'before' | 'after' | 'left' | 'right' | 'empty';
1033
- interface DropSpot {
1034
- sectionIndex: number;
1035
- type: DropType;
1036
- /** the field the drop is placed at; null: at the end of the section */
1037
- targetIndex: number | null;
1038
- }
1039
- declare const GRID_COLUMNS = 12;
1040
- declare const MAX_FIELDS_PER_ROW = 4;
1041
- /** The upper quarter of a field puts the drop above, the lower quarter below, the middle beside it (left or right half). */
1042
- declare function dropTypeAt(rect: {
1043
- left: number;
1044
- top: number;
1045
- width: number;
1046
- height: number;
1047
- }, x: number, y: number): DropType;
1048
- /** How many of the section's 12 columns a field takes (gridSpan, else its style's "span N", else by its label position). */
1049
- declare function fieldSpan(field: any): number;
1050
- /** The fields of one row share the 12 columns (at most four; more go to rows of their own). */
1051
- declare function rebalanceRow(fields: any[], id: string, kind: SectionKind): void;
1052
- /** Puts a field into a section's fields at the drop spot. */
1053
- declare function insertField(fields: any[], field: any, spot: Pick<DropSpot, 'type' | 'targetIndex'>, kind: SectionKind): void;
1054
- /** An empty section as the Designer adds it. */
1055
- declare function newSection(kind: SectionKind): any;
1056
- /** A button as the Designer adds it to a section. */
1057
- declare function newButton(kind: SectionKind, caption?: string): any;
1058
- /** The field a data object's property becomes when it is dropped (label: the property's name, changed afterwards). */
1059
- declare function fieldFromProperty(drop: DesignPropertyDrop, kind: SectionKind): any;
1060
- /**
1061
- * The layout as the Designer keeps it, changed in place: every section has its fields list; in a form the
1062
- * classes go (the right panel sets styles only), the section's grid is drawn by the container (no display or
1063
- * columns in its style) and every field belongs to a row.
1064
- */
1065
- declare function normalizeSections(layout: any, kind: SectionKind): any;
1066
- /** A data object's field dropped at the spot. */
1067
- declare function dropProperty(layout: any, drop: DesignPropertyDrop, spot: DropSpot, kind: SectionKind): any;
1068
- /** A field moved from its place to the spot (same or another section). */
1069
- declare function moveField(layout: any, from: {
1070
- sectionIndex: number;
1071
- fieldIndex: number;
1072
- }, spot: DropSpot, kind: SectionKind): any;
1073
- declare function removeField(layout: any, sectionIndex: number, fieldIndex: number, kind: SectionKind): any;
1074
- /** A section deleted; a form keeps one empty section to drop fields into. */
1075
- declare function removeSection(layout: any, sectionIndex: number, kind: SectionKind): any;
1076
- declare function moveSection(layout: any, from: number, to: number): any;
1077
- declare function addSection(layout: any, kind: SectionKind): any;
1078
- declare function addButton(layout: any, sectionIndex: number, kind: SectionKind, caption?: string): any;
1079
- /** The settings of a section or field changed in the Designer's right panel. */
1080
- declare function replaceSection(layout: any, sectionIndex: number, section: any, kind: SectionKind): any;
1081
- declare function replaceField(layout: any, sectionIndex: number, fieldIndex: number, field: any, kind: SectionKind): any;
1082
-
1083
- /** What the container gives the designer: its layout, how a new layout is taken over, and what is told to the Designer. */
1084
- interface SectionDesignerHost {
1085
- layout(): any;
1086
- apply(next: any): void;
1087
- select(target: DesignTarget): void;
1088
- deselect(): void;
1089
- /** the view is drawn again (the apps run without zone.js: a change after a timer is not seen otherwise) */
1090
- refresh(): void;
1091
- }
1092
- /** The data a field carries while it is dragged inside its container. */
1093
- interface SectionDragData {
1094
- vlDesign: 'field';
1095
- sectionIndex: number;
1096
- fieldIndex: number;
1097
- }
1098
- declare class SectionDesigner {
1099
- private readonly kind;
1100
- private readonly host;
1101
- /** where a drop would land now; null while nothing is dragged over the container */
1102
- hint: DropSpot | null;
1103
- private dragging;
1104
- private dragged;
1105
- /** the ids of this container's drop lists start with it (several containers may be on one page) */
1106
- readonly prefix: string;
1107
- constructor(kind: SectionKind, host: SectionDesignerHost);
1108
- listId(sectionIndex: number): string;
1109
- /** Every section list of the container, so a field can go from one section to another. */
1110
- listIds(): string[];
1111
- private sectionOf;
1112
- dragData(sectionIndex: number, fieldIndex: number): SectionDragData;
1113
- /** The drop spot at a point of a section: on a field, above the first, below the last, or into the empty section. */
1114
- spotAt(x: number, y: number, sectionIndex: number): DropSpot;
1115
- private setHint;
1116
- /** A drag came over a section (a field of this container or a data object's field). */
1117
- entered(sectionIndex: number): void;
1118
- /** The pointer moves over a section while something is dragged over it. */
1119
- pointerMove(event: MouseEvent, sectionIndex: number): void;
1120
- exited(): void;
1121
- /** A section is dragged to another place: its settings close, no field hint is shown. */
1122
- sectionDragStarted(): void;
1123
- dragStarted(sectionIndex: number, fieldIndex: number): void;
1124
- /** A field of this container moves: the section under the pointer decides. */
1125
- dragMoved(event: CdkDragMove<any>): void;
1126
- dragEnded(): void;
1127
- clear(): void;
1128
- isEmptyHint(sectionIndex: number): boolean;
1129
- isTargetHint(sectionIndex: number, fieldIndex: number): boolean;
1130
- hintText(texts: DesignTexts): string;
1131
- dropped(event: CdkDragDrop<any>, sectionIndex: number): void;
1132
- /** The sections were reordered (from and to: places in the layout). */
1133
- sectionMoved(from: number, to: number): void;
1134
- removeField(sectionIndex: number, fieldIndex: number): void;
1135
- removeSection(sectionIndex: number): void;
1136
- addSection(): void;
1137
- addButton(sectionIndex: number, caption?: string): void;
1138
- editSection(sectionIndex: number): void;
1139
- editField(sectionIndex: number, fieldIndex: number, part?: 'input'): void;
836
+ static ɵcmp: i0.ɵɵComponentDeclaration<CardComponent, "vl-card", never, { "itemInfo": { "alias": "itemInfo"; "required": false; }; "pageData": { "alias": "pageData"; "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"; }, never, never, true, never>;
1140
837
  }
1141
838
 
1142
839
  /**
@@ -1177,6 +874,7 @@ declare function lockHint(option: any, reason: LockReason, translations?: Record
1177
874
  declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestroy {
1178
875
  /** Marks for the app's test runner (#166): field key and button action. */
1179
876
  readonly vlFieldKey: typeof testFieldKey;
877
+ readonly vlFieldPath: typeof testFieldPath;
1180
878
  private readonly remoteLists;
1181
879
  /** Loaded lists by field reference. */
1182
880
  remoteData: Record<string, any[]>;
@@ -1213,18 +911,6 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
1213
911
  checkBoxChangeEvent: EventEmitter<any>;
1214
912
  /** the hint of a button locked for a missing sign-in was clicked: the app starts its sign-in */
1215
913
  signIn: EventEmitter<void>;
1216
- /** The Designer's canvas: every section and field with drag, edit and delete, nothing loaded (design/design.ts). */
1217
- design: VlDesign | null;
1218
- /** What was chosen or changed on the Designer's canvas. */
1219
- designChange: EventEmitter<DesignEvent>;
1220
- /** The texts of the design handles. */
1221
- dt: DesignTexts;
1222
- /** Drag and drop of the sections and fields in design mode. */
1223
- readonly designer: SectionDesigner;
1224
- private readonly cdr;
1225
- /** The device the Designer shows the page on: the form follows it like the app follows the window. */
1226
- get designMobile(): boolean;
1227
- get designTablet(): boolean;
1228
914
  ngOnInit(): void;
1229
915
  ngOnChanges(changes: SimpleChanges): void;
1230
916
  ngAfterViewInit(): void;
@@ -1246,16 +932,6 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
1246
932
  private sectionSplit;
1247
933
  /** The width of the sticky column: the widest of its sections (gridSpan), 4 when none says. */
1248
934
  stickySpan(): number;
1249
- /** A section that stays in view while the page scrolls (layout sticky). */
1250
- sectionStickyOf(formSection: any): boolean;
1251
- /** A section's place in the layout (the canvas shows the sticky ones after the others). */
1252
- sectionIndexOf(formSection: any): number;
1253
- /** Whether the element's settings are open in the Designer (it is marked). */
1254
- isSelected(target: DesignTarget): boolean;
1255
- /** A section dropped at another place of the canvas: the canvas shows the sticky ones last, the layout keeps its order. */
1256
- sectionDropped(event: CdkDragDrop<any>): void;
1257
- sectionAction(action: DesignAction, sectionIndex: number): void;
1258
- fieldAction(action: DesignAction, sectionIndex: number, fieldIndex: number): void;
1259
935
  /** A section with visibleWhen is shown only while its field holds the value. */
1260
936
  sectionShown(formSection: any): boolean;
1261
937
  getSectionBodyStyle(formSection: any): any;
@@ -1294,7 +970,7 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
1294
970
  saveTried: boolean;
1295
971
  showError(control: any): boolean;
1296
972
  static ɵfac: i0.ɵɵFactoryDeclaration<FormComponent, never>;
1297
- 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; }; "userInfo": { "alias": "userInfo"; "required": false; }; "design": { "alias": "design"; "required": false; }; }, { "formButtonClick": "formButtonClick"; "checkBoxChangeEvent": "checkBoxChangeEvent"; "signIn": "signIn"; "designChange": "designChange"; }, never, never, true, never>;
973
+ 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; }; "userInfo": { "alias": "userInfo"; "required": false; }; }, { "formButtonClick": "formButtonClick"; "checkBoxChangeEvent": "checkBoxChangeEvent"; "signIn": "signIn"; }, never, never, true, never>;
1298
974
  }
1299
975
 
1300
976
  interface GridColumnFilterState {
@@ -1319,6 +995,13 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1319
995
  readonly picker: DateTimePickerService;
1320
996
  private readonly host;
1321
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;
1322
1005
  ngOnDestroy(): void;
1323
1006
  private sideHintObserver?;
1324
1007
  /** Marks the table's scroll area while columns lie beyond its left or right edge. */
@@ -1341,6 +1024,12 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1341
1024
  pageSize: number;
1342
1025
  currentPage: number;
1343
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;
1344
1033
  userInfo: any;
1345
1034
  /** A page from browser storage or a filter (A4): its records, delete and paging go through PageData. */
1346
1035
  pageData: PageData | null;
@@ -1351,22 +1040,6 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1351
1040
  recordIndex: number;
1352
1041
  }>;
1353
1042
  gridForm?: NgForm;
1354
- /** The Designer's canvas: sample rows, every column with drag, edit, delete and resize, nothing loaded (design/design.ts). */
1355
- design: VlDesign | null;
1356
- /** What was chosen or changed on the Designer's canvas. */
1357
- designChange: EventEmitter<DesignEvent>;
1358
- /** The texts of the design handles. */
1359
- dt: DesignTexts;
1360
- /** The sample rows, the area with its page bar and the pages of the canvas, renewed when the layout changes. */
1361
- designAll: any[];
1362
- designInfo: any;
1363
- designPages: number[];
1364
- designPage: number;
1365
- designPageSize: number;
1366
- /** The drop list of the column heads (a data object's field dropped on it becomes a column). */
1367
- readonly designListId: string;
1368
- get designMobile(): boolean;
1369
- get designTablet(): boolean;
1370
1043
  /** The row being edited ("row" mode), its own copy of the data objects with the row's values. */
1371
1044
  editingRow: any;
1372
1045
  rowSchema: any;
@@ -1390,47 +1063,24 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1390
1063
  ngAfterViewInit(): void;
1391
1064
  ngOnChanges(changes: SimpleChanges): void;
1392
1065
  get gridDisplayData(): any[];
1393
- searchText: string;
1394
- private searchMemo;
1395
- get showSearch(): boolean;
1396
- get searchPositionClass(): string;
1397
- searchPlaceholder(): string;
1398
- /** The rows holding the searched text in one of their shown columns - the same list while nothing changed. */
1399
- private searched;
1400
- /** The style of row number index (0, 1, …): odd and even rows as the page sets them. */
1401
- rowStyleOf(index: number): Record<string, any>;
1402
- /** A column's width and height as the page sets them. */
1403
- columnSize(column: any): Record<string, any>;
1404
- /** A cell: the column's scope style, the row's stripe, the column's size. */
1405
- cellStyle(column: any, index: number): Record<string, any>;
1406
- /** The sample rows and the page bar of the canvas, from the layout as it is now. */
1407
- refreshDesign(): void;
1408
- /** The sample rows of the page shown - the same list while nothing changed (the table draws its rows anew otherwise). */
1409
- get designRows(): any[];
1410
- private rowsMemo;
1411
- designGoToPage(page: number): void;
1412
- isSelected(target: DesignTarget): boolean;
1413
- private applyDesign;
1414
- selectGrid(): void;
1415
- columnAction(action: DesignAction, index: number): void;
1416
- /** A column moved along the heads, or a data object's field dropped on them (a new column at that place). */
1417
- columnDropped(event: CdkDragDrop<any>): void;
1418
- columnDragStarted(): void;
1419
- private resizing;
1420
- /** Dragging a column head's right or lower edge sets its width or height. */
1421
- startResize(event: MouseEvent, index: number, type: 'width' | 'height'): void;
1422
- private onResize;
1423
- private endResize;
1424
- private stopResize;
1425
1066
  translateSchema(schema: any, SelectedLanguage: any): any;
1426
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;
1427
1070
  getStyleWithoutClasses(styleObject: any): {
1428
- classes: any;
1071
+ classes: string;
1429
1072
  style: any;
1430
1073
  };
1431
1074
  onScrollEvent(event: any): void;
1432
1075
  showLinkDetails(option: any, data: any): void;
1433
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
+ */
1434
1084
  upsertAction(option: any, data: any): void;
1435
1085
  setActionColumn(option: any, data: any): boolean;
1436
1086
  findDynamicKeyAndValue(object: Record<string, any>): {
@@ -1510,7 +1160,7 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1510
1160
  /** The DTO type of a column as the data object declares it ("string", "quantity" ...). */
1511
1161
  cellType(col: any): string;
1512
1162
  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>;
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>;
1514
1164
  }
1515
1165
 
1516
1166
  declare class HeaderMenuComponent implements AfterViewInit {
@@ -1530,6 +1180,8 @@ declare class HeaderMenuComponent implements AfterViewInit {
1530
1180
  environment: any;
1531
1181
  tenantName: any;
1532
1182
  projectSeleted: any;
1183
+ /** The signed-in user - its name for the user element. */
1184
+ userInfo: any;
1533
1185
  cartInfo: any;
1534
1186
  buttonClick: EventEmitter<any>;
1535
1187
  showTableContent: EventEmitter<any>;
@@ -1539,14 +1191,26 @@ declare class HeaderMenuComponent implements AfterViewInit {
1539
1191
  ngOnChanges(changes: SimpleChanges): void;
1540
1192
  ngAfterViewInit(): void;
1541
1193
  getStyle(styleObject: any): Record<string, any>;
1194
+ /** The classes of a style (style.classes), for [ngClass] beside getStyle. */
1195
+ classNames(styleObject: any): string;
1542
1196
  isVisible(header: any): boolean;
1543
- 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;
1544
1208
  invokeSearchedItems(option: any, search: any): void;
1545
1209
  invokeHeaderButtonClick(option: any): void;
1546
1210
  invokeShowtableContent(option: any): void;
1547
1211
  setHeaderItems(items: any[]): Promise<any[]>;
1548
1212
  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>;
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>;
1550
1214
  }
1551
1215
 
1552
1216
  declare class NetworkLogService {
@@ -1577,6 +1241,7 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1577
1241
  private utilityService;
1578
1242
  /** Marks for the app's test runner (#166): field key and button action. */
1579
1243
  readonly vlFieldKey: typeof testFieldKey;
1244
+ readonly vlFieldPath: typeof testFieldPath;
1580
1245
  private readonly remoteLists;
1581
1246
  /** Date and time picker behaviour shared by all containers. */
1582
1247
  readonly picker: DateTimePickerService;
@@ -1588,17 +1253,6 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1588
1253
  selectedLanguageInfo: any;
1589
1254
  userInfo: any;
1590
1255
  setFormDataHandler?: () => void | Promise<void>;
1591
- /** The Designer's canvas: every field with drag, edit and delete, nothing loaded or sent (design/design.ts). */
1592
- design: VlDesign | null;
1593
- /** What was chosen or changed on the Designer's canvas. */
1594
- designChange: EventEmitter<DesignEvent>;
1595
- /** The texts of the design handles. */
1596
- dt: DesignTexts;
1597
- /** Drag and drop of the sections and fields in design mode. */
1598
- readonly designer: SectionDesigner;
1599
- /** The device the Designer shows the page on: the dialog follows it like the app follows the window. */
1600
- get designMobile(): boolean;
1601
- get designTablet(): boolean;
1602
1256
  copyLayoutSchema: any;
1603
1257
  isLoading: boolean;
1604
1258
  projectLanguage: any;
@@ -1655,10 +1309,6 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1655
1309
  showMissing(form: NgForm | null): void;
1656
1310
  checkValidty(form: NgForm): boolean;
1657
1311
  onCancel(): void;
1658
- /** Whether the element's settings are open in the Designer (it is marked). */
1659
- isSelected(target: DesignTarget): boolean;
1660
- sectionAction(action: DesignAction, sectionIndex: number): void;
1661
- fieldAction(action: DesignAction, sectionIndex: number, fieldIndex: number): void;
1662
1312
  /**
1663
1313
  * A field's message shows once the user typed in it and left it, or after a save attempt - not
1664
1314
  * when an empty field was only passed through (the message then pushed the row and its label out
@@ -1666,8 +1316,8 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1666
1316
  */
1667
1317
  saveTried: boolean;
1668
1318
  showError(control: any): boolean;
1669
- static ɵfac: i0.ɵɵFactoryDeclaration<ModelComponent, [null, { optional: true; }, { optional: true; }, null]>;
1670
- 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; }; "design": { "alias": "design"; "required": false; }; }, { "designChange": "designChange"; }, never, never, true, never>;
1319
+ static ɵfac: i0.ɵɵFactoryDeclaration<ModelComponent, never>;
1320
+ 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>;
1671
1321
  }
1672
1322
 
1673
1323
  declare class PaginationComponent implements OnInit {
@@ -1686,6 +1336,10 @@ declare class PaginationComponent implements OnInit {
1686
1336
  private updateDeviceMode;
1687
1337
  get isFirstPage(): boolean;
1688
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;
1689
1343
  get paginationStyle(): Record<string, any>;
1690
1344
  get listStyle(): Record<string, any>;
1691
1345
  get sizeControlStyle(): Record<string, any>;
@@ -1928,6 +1582,14 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
1928
1582
  private destroyMobileLoginSubscription;
1929
1583
  private clearLoginUser;
1930
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;
1931
1593
  setLoginedUser(user: any): void;
1932
1594
  /** The menu entry with action 'logout', at any depth of the menu. */
1933
1595
  private findLogoutMenu;
@@ -2408,13 +2070,20 @@ declare class RemoteListService {
2408
2070
  static ɵprov: i0.ɵɵInjectableDeclaration<RemoteListService>;
2409
2071
  }
2410
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
+
2411
2078
  /** Prefix of the forwarding path on the app's own origin. */
2412
2079
  declare const BACKEND_PROXY_PREFIX = "/api/proxy";
2080
+
2413
2081
  /**
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.
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.
2416
2085
  */
2417
- declare function backendUrl(url: string): string;
2086
+ declare function backendUrl(url: string, proxy: boolean): string;
2418
2087
 
2419
2088
  declare class RecordStore {
2420
2089
  private utilityService;
@@ -2434,37 +2103,6 @@ declare class RecordStore {
2434
2103
  static ɵprov: i0.ɵɵInjectableDeclaration<RecordStore>;
2435
2104
  }
2436
2105
 
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
2106
  declare class BackendCallService {
2469
2107
  private readonly remoteLists;
2470
2108
  private readonly utilityService;
@@ -2971,7 +2609,6 @@ declare function sectionSticky(section: any): boolean;
2971
2609
  */
2972
2610
  declare function sectionVisible(section: any, propertySchema: any): boolean;
2973
2611
 
2974
- /** The terms part of the app settings as readAppSettings gives it. */
2975
2612
  interface TermsSettings {
2976
2613
  enabled: boolean;
2977
2614
  confirmOnStart: boolean;
@@ -3002,11 +2639,12 @@ declare function termsStamp(terms: TermsSettings): string;
3002
2639
  declare function termsStorageKey(project: string): string;
3003
2640
  /** Whether the browser's acceptance covers this state. */
3004
2641
  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. */
2642
+ /** An address with {{user}}, {{version}}, {{userInfo.x}} and {{env.x}} filled in (URL-encoded); a relative one goes after apiUrl. */
3006
2643
  declare function termsUrl(url: string, values: {
3007
2644
  user: string;
3008
2645
  version: string;
3009
2646
  env?: Record<string, any>;
2647
+ userInfo?: any;
3010
2648
  }): string;
3011
2649
  /**
3012
2650
  * The backend's answer to the status question: { version, accepted }. The backend's version is the state that
@@ -3019,30 +2657,5 @@ declare function backendTermsState(answer: any, stamp: string): {
3019
2657
  /** The user the acceptance belongs to: e-mail, user name or subject of the sign-in. */
3020
2658
  declare function termsUser(userInfo: any): string;
3021
2659
 
3022
- /** The page's area (center) with the page bar it is shown with; unchanged without app settings or without a bar. */
3023
- declare function withAppPagination(mainCenter: any, center: any): any;
3024
-
3025
- /** The column a data object's property becomes when it is dropped on the grid: its values, read only. */
3026
- declare function columnFromProperty(drop: DesignPropertyDrop): any;
3027
- /** A data object's field dropped at place index of the columns (at the end when index is out of range). */
3028
- declare function dropGridProperty(layout: any, drop: DesignPropertyDrop, index: number): any;
3029
- declare function moveColumn(layout: any, from: number, to: number): any;
3030
- declare function removeColumn(layout: any, index: number): any;
3031
- /** A column's width or height (option.width / option.height, in px) as dragged on its edge. */
3032
- declare function resizeColumn(layout: any, index: number, size: {
3033
- width?: number;
3034
- height?: number;
3035
- }): any;
3036
- /** The settings of a column changed in the Designer's right panel. */
3037
- declare function replaceColumn(layout: any, index: number, column: any): any;
3038
-
3039
- /** A sample value of a property for record number index (0, 1, …). */
3040
- declare function sampleValue(type: string | undefined, name: string, index: number, node?: any, image?: string): any;
3041
- /**
3042
- * count sample records for the fields of the layout nodes: each field gets a value of its property's type, a
3043
- * list field (dropdown, radio buttons) the value of its list's entry.
3044
- */
3045
- declare function sampleRecords(nodes: any[], propertySchema: any, count: number, image?: string): any[];
3046
-
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 };
3048
- 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 };
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 };
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 };