@yomotech/view-toolkit 1.0.50 → 1.0.56

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,5 +1,5 @@
1
1
  import * as i0 from '@angular/core';
2
- import { EventEmitter, ElementRef, ChangeDetectorRef, NgZone, SimpleChanges, OnInit, OnChanges, AfterViewInit, OnDestroy, Injector, PipeTransform } from '@angular/core';
2
+ import { EventEmitter, ElementRef, ChangeDetectorRef, NgZone, SimpleChanges, OnInit, OnChanges, DoCheck, AfterViewInit, OnDestroy, Injector, PipeTransform } from '@angular/core';
3
3
  import * as i1 from '@angular/common';
4
4
  import { CdkDragMove, CdkDragDrop } from '@angular/cdk/drag-drop';
5
5
  import * as rxjs from 'rxjs';
@@ -147,6 +147,11 @@ interface DesignDeleteRequest {
147
147
  remove: () => boolean;
148
148
  }
149
149
  type DesignEvent = DesignDeleteRequest
150
+ /** "+" was pressed: the Designer adds an element there (its dialog) - a menu entry at the top or into a folder */
151
+ | {
152
+ type: 'add';
153
+ target: DesignTarget;
154
+ }
150
155
  /** an element was chosen: the Designer opens its settings */
151
156
  | {
152
157
  type: 'select';
@@ -219,6 +224,10 @@ interface DesignTexts {
219
224
  editGrid: string;
220
225
  emptyGrid: string;
221
226
  button: string;
227
+ addMenuEntry: string;
228
+ userName: string;
229
+ addMenuChild: string;
230
+ emptyHeader: string;
222
231
  }
223
232
  declare const DESIGN_TEXTS: DesignTexts;
224
233
  /** The design texts with the Designer's own over the English ones. */
@@ -253,6 +262,13 @@ interface CardPlace {
253
262
  }
254
263
  /** How many columns a grid-template-columns names: "repeat(3, 34px)" three, "minmax(0, 1fr) repeat(3, 34px)" four. */
255
264
  declare function gridColumnCount(template: unknown): number;
265
+ /**
266
+ * A horizontal layout draws its elements in equal columns - unless its columns already fit its elements: widths
267
+ * set for them ("minmax(0, 1fr) repeat(3, 34px)": the order number wide, three narrow buttons) stay. Every edit of the
268
+ * card set them back to equal columns, which squeezed tm's order number (2026-10-28).
269
+ */
270
+ /** The most equal columns a row of a card gets; more elements wrap to the next line. */
271
+ declare const MAX_ROW_COLUMNS = 4;
256
272
  /**
257
273
  * The card layout as the Designer keeps it, changed in place: no empty classes on the card styles, the card's
258
274
  * columns are drawn by the container (no gridTemplateColumns in its style), no classes on the elements (the right
@@ -329,7 +345,7 @@ declare class CardDesigner {
329
345
  edit(index: number, parentIndex: number | null): void;
330
346
  }
331
347
 
332
- type DesignAction = 'drag' | 'add' | 'edit' | 'delete';
348
+ type DesignAction = 'drag' | 'add' | 'data' | 'edit' | 'delete';
333
349
  /**
334
350
  * The handles of one element. "drag" is the cdkDragHandle of the element it stands in; the others report their
335
351
  * action (act) without the click reaching the element.
@@ -339,6 +355,8 @@ declare class DesignBarComponent {
339
355
  /** the tooltip of each handle */
340
356
  titles: Partial<Record<DesignAction, string>>;
341
357
  act: EventEmitter<DesignAction>;
358
+ /** The handles in the one order, whatever order a container names them in. */
359
+ get ordered(): DesignAction[];
342
360
  icon(action: DesignAction): string;
343
361
  static ɵfac: i0.ɵɵFactoryDeclaration<DesignBarComponent, never>;
344
362
  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>;
@@ -418,11 +436,21 @@ declare class RequestService {
418
436
  static ɵprov: i0.ɵɵInjectableDeclaration<RequestService>;
419
437
  }
420
438
 
439
+ /** A data_url that names fields of the form ({{form.x}}) - it depends on them. */
440
+ declare function dependsOnForm(url: unknown): boolean;
441
+ /** Every {{form.x}} of the address has a value in the context (an empty one loads nothing). */
442
+ declare function formValuesGiven(url: string, context: {
443
+ form: Record<string, any>;
444
+ }): boolean;
421
445
  declare class UtilityService {
422
446
  private platform;
423
447
  private requestService;
424
448
  stripe: any;
425
449
  cardElement: any;
450
+ /** the Stripe key of the card field the page mounted - a test card is taken only with a test key */
451
+ private stripeKey;
452
+ /** a test run's Stripe test payment method (useTestCard) - paid with instead of the card frame */
453
+ private testPaymentMethod;
426
454
  /** Stripe says the card field holds a whole card (number, date, CVC) - a signal, so a locked button follows it */
427
455
  readonly cardComplete: i0.WritableSignal<boolean>;
428
456
  constructor(platform: Platform, requestService: RequestService);
@@ -512,6 +540,15 @@ declare class UtilityService {
512
540
  * the Angular form (Stripe's own frame), so the form's validity does not see it.
513
541
  */
514
542
  requiredCardMissing(layoutSchema: any, propertySchema: any): boolean;
543
+ /**
544
+ * A test run's card: the card number of the test data ("4242 4242 4242 4242") becomes Stripe's test payment method
545
+ * for it - nobody can type into Stripe's own frame. Only with a test key and a Stripe test card; the card then
546
+ * counts as whole. ok false with the reason otherwise.
547
+ */
548
+ useTestCard(cardNumber: string): {
549
+ ok: boolean;
550
+ error?: string;
551
+ };
515
552
  /**
516
553
  * Pays a payment intent with the card field of the page. ok false with the reason in error when the
517
554
  * field is not there yet or Stripe refuses the card; the card data never leaves Stripe's own frame.
@@ -522,6 +559,21 @@ declare class UtilityService {
522
559
  paymentIntent?: any;
523
560
  }>;
524
561
  formData(form: any, environment: any, cartInfo: any): Promise<void>;
562
+ /** The environment of the form loaded last - its dependent dropdowns load from env.apiUrl. */
563
+ private formEnvironment;
564
+ /** A dependent dropdown's address loading now - one call per address at a time. */
565
+ private dependentLoading;
566
+ /**
567
+ * The values of the form for its placeholders: {{form.<group>.<field>}}. A dropdown's value is its chosen option, so
568
+ * {{form.shipping.country.code}} names a field of it; on its own it reads as the chosen value.
569
+ */
570
+ formPlaceholderContext(form: any): Record<string, any>;
571
+ /**
572
+ * The dropdowns whose data_url names fields of the form: loaded with the values of now when the address changed;
573
+ * a field still empty loads nothing (an empty list), a choice the new list no longer offers is cleared. Called after
574
+ * the form loaded and on every change of the form (FormComponent.ngDoCheck) - cheap when nothing changed.
575
+ */
576
+ refreshDependentDropdowns(form: any): Promise<void>;
525
577
  normalizeDatesForStorage(obj: any): any;
526
578
  isDateLike(value: any): boolean;
527
579
  toLocalISOString(date: Date): string;
@@ -715,8 +767,23 @@ declare class CustomKeyboardService {
715
767
  * does not move.
716
768
  */
717
769
  private scrollTargetAboveKeyboard;
770
+ /** The area a page scrolls in while the keyboard is open: its own bottom padding, how far it was moved. */
771
+ private pageRoom;
772
+ /**
773
+ * A field on a page: the area the page scrolls in gets room at its foot (the keyboard's height) and is moved just
774
+ * far enough that the field stands above the keyboard. A field already above it does not move.
775
+ */
776
+ private pageFieldAboveKeyboard;
777
+ /** The keyboard closed: the page's area loses the room and stands where it stood before. */
778
+ private releasePageRoom;
718
779
  private canProcessKeyboardAction;
719
780
  insert(character: string): void;
781
+ /**
782
+ * The clipboard's text into the field at the cursor - the field is read-only while the keyboard is open (no system
783
+ * keyboard), so the browser's own paste does not reach it. The tap on the key is the person's own action, so the
784
+ * browser lets the clipboard be read (some ask first). Typed rules apply (insert); a refused read changes nothing.
785
+ */
786
+ paste(): Promise<void>;
720
787
  backspace(): void;
721
788
  clear(): void;
722
789
  /**
@@ -725,6 +792,15 @@ declare class CustomKeyboardService {
725
792
  * in custom-keyboard.component.css (#166, OFFENE-PUNKTE 43).
726
793
  */
727
794
  private markActiveField;
795
+ /**
796
+ * The key at the bottom right the field asks for (Designer: option.enterKey, data-vl-enter-key on the field or
797
+ * around it): done (default), search, next.
798
+ */
799
+ enterKey(): 'done' | 'search' | 'next';
800
+ /** Search: the field gets Enter (keydown, keyup - as a device's Search key sends it), its action runs, then the keyboard closes. */
801
+ submit(): void;
802
+ /** Next: on to the next field that can be typed in (same form or dialog, in reading order); none - the keyboard closes. */
803
+ next(): void;
728
804
  close(option?: {
729
805
  blurTarget?: boolean;
730
806
  restoreAccessoryBar?: boolean;
@@ -882,10 +958,22 @@ interface DataSource {
882
958
  /** older Designer versions: localStorage: true / sessionStorage: true instead of storageType */
883
959
  localStorage?: boolean;
884
960
  sessionStorage?: boolean;
961
+ /** with storageType database: the page starts empty and loads once every filter field has a value */
962
+ loadOnFilter?: boolean;
885
963
  }
886
964
  type StorageKind = 'localstorage' | 'sessionstorage' | 'filter' | 'database' | '';
887
965
  /** The kind of a data source, lowercase - "localStorage" of older Designer versions counts as "localstorage". */
888
966
  declare function storageKind(source: DataSource | null | undefined): StorageKind;
967
+ /**
968
+ * The list after a button that keeps one record: the record comes first; with key, a record of the same key
969
+ * value goes out instead (added: false). max: the oldest fall off the end.
970
+ */
971
+ declare function toggleRecord(records: any[], record: any, key?: string, max?: number): {
972
+ records: any[];
973
+ added: boolean;
974
+ };
975
+ /** The web address a button opens: the field option.propertyKey of the record, only http(s). */
976
+ declare function linkOfRecord(option: any, record: any): string | null;
889
977
  /** True when the records of the source live in the browser (local or session storage). */
890
978
  declare function isBrowserSource(source: DataSource | null | undefined): boolean;
891
979
  /**
@@ -922,10 +1010,14 @@ interface PageDataDeps {
922
1010
  sendBackend(option: any, records: any[], extra: any): Promise<any>;
923
1011
  /** The question before deleting; true = delete. */
924
1012
  confirmDelete(button: any): Promise<boolean>;
925
- /** A message to the user, by text key (saveFailed, deleteFailed, loadFailed). */
926
- failed(key: string, error: unknown): void;
927
- /** After sending: how many records the backend took and how many it refused (optional). */
928
- sent?(result: SendResult): void;
1013
+ /** A message to the user, by text key (saveFailed, deleteFailed, loadFailed); text: the page's / button's own
1014
+ * errorMessage, shown instead of the key's text when set. */
1015
+ failed(key: string, error: unknown, text?: string): void;
1016
+ /** After sending: how many records the backend took and how many it refused; option: the button (its
1017
+ * successMessage) (optional). */
1018
+ sent?(result: SendResult, option?: any): void;
1019
+ /** A hint to the user, e.g. the page's emptyMessage when a backend load found nothing (optional). */
1020
+ notice?(text: string): void;
929
1021
  /** Dates of browser records back to Date objects (optional). */
930
1022
  restoreDates?(records: any[]): any[];
931
1023
  /** The app's own work on records just loaded from the backend, e.g. pictures from Media (optional). */
@@ -991,6 +1083,8 @@ declare class PageData {
991
1083
  * sends all in one call (all taken or all refused). OFFENE-PUNKTE 131: a refused entry looked like one never sent.
992
1084
  */
993
1085
  send(button: any, index: number | 'all'): Promise<boolean>;
1086
+ /** A button with a browser storage: its record goes into the button's list, or out again (toggleRecord). */
1087
+ keep(button: any, record: any): Promise<boolean>;
994
1088
  /** Filter fields are the keys set by setFilter; a filter page loads only when none is empty. */
995
1089
  private filterComplete;
996
1090
  private loadBackendRecords;
@@ -1096,6 +1190,8 @@ declare class CardComponent {
1096
1190
  get displayedRecords(): any[];
1097
1191
  private setupScrollObserver;
1098
1192
  private loadNextScrollPage;
1193
+ /** No further page to load - the list's end marks itself for tests (data-vl-list-end). */
1194
+ listEnd(): boolean;
1099
1195
  private hasNextScrollPage;
1100
1196
  private refreshScrollObserver;
1101
1197
  private destroyScrollObserver;
@@ -1136,9 +1232,11 @@ declare class CardComponent {
1136
1232
  extractFilterValues(schema: Record<string, any>): Record<string, any>;
1137
1233
  invokeOnPageSizeChange(pageSize: any): void;
1138
1234
  invokeGoToPage(page: number): void;
1235
+ /** What an element does (action catalog) - for the template. */
1236
+ actionOf(option: any): string;
1139
1237
  invokeOnCardHeader(element: any): void;
1140
1238
  invokeOnCardFooter(element: any): void;
1141
- /** Delete (asks first) and save to a backend go to the page's data; anything else to the app. */
1239
+ /** Delete (asks first) and save (backend, or a browser list) go to the page's data; anything else to the app. */
1142
1240
  invokeButtonClick(layout: any, record: any, recordIndex: any): Promise<void>;
1143
1241
  /** The line above a refused record: "Not saved: <reason>" in the project's language (notSentReason, {reason}). */
1144
1242
  sendErrorText(record: any): string;
@@ -1156,6 +1254,10 @@ declare class CardComponent {
1156
1254
  classes: string;
1157
1255
  style: Record<string, any>;
1158
1256
  };
1257
+ /** The cards of a row equally high, their buttons at the bottom (center.option.alignRows, catalog alignRowsOf). */
1258
+ alignRows(): boolean;
1259
+ /** An element of the card that holds buttons (a button, or a row with one) - it goes to the bottom of an aligned card. */
1260
+ isActionLayout(layout: any): boolean;
1159
1261
  getCardContainerStyle(): Record<string, any>;
1160
1262
  getSingleCardStyle(): Record<string, any>;
1161
1263
  getHeaderStyle(): Record<string, any>;
@@ -1327,7 +1429,7 @@ declare function buttonLocked(option: any, state: LockState): boolean;
1327
1429
  */
1328
1430
  declare function lockHint(option: any, reason: LockReason, translations?: Record<string, string> | null): string;
1329
1431
 
1330
- declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestroy {
1432
+ declare class FormComponent implements OnInit, OnChanges, DoCheck, AfterViewInit, OnDestroy {
1331
1433
  /** Marks for the app's test runner (#166): field key and button action. */
1332
1434
  readonly vlFieldKey: typeof testFieldKey;
1333
1435
  readonly vlFieldPath: typeof testFieldPath;
@@ -1440,6 +1542,8 @@ declare class FormComponent implements OnInit, OnChanges, AfterViewInit, OnDestr
1440
1542
  */
1441
1543
  showMissing(form: NgForm | null): void;
1442
1544
  invokeFormBtnClick(option: any, propertySchema: any): void;
1545
+ /** A change of the form may change the address of a dependent dropdown ({{form.x}} in its data_url). */
1546
+ ngDoCheck(): void;
1443
1547
  setformData(): void;
1444
1548
  setErroMessage(formField: any, errorMessages: any, field: any): string;
1445
1549
  setValidations(): void;
@@ -1476,6 +1580,8 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1476
1580
  readonly picker: DateTimePickerService;
1477
1581
  private readonly host;
1478
1582
  private readonly cdr;
1583
+ /** No further page to load - the list's end marks itself for tests (data-vl-list-end). */
1584
+ listEnd(): boolean;
1479
1585
  /** Watches the element under the table; in view (with 250px ahead) it asks for the next page. */
1480
1586
  private observeEnd;
1481
1587
  ngOnDestroy(): void;
@@ -1517,6 +1623,10 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1517
1623
  }>;
1518
1624
  gridForm?: NgForm;
1519
1625
  /** The Designer's canvas: sample rows, every column with drag, edit, delete and resize, nothing loaded (design/design.ts). */
1626
+ readonly vlFieldKey: typeof testFieldKey;
1627
+ readonly vlFieldPath: typeof testFieldPath;
1628
+ readonly vlAction: typeof testAction;
1629
+ readonly vlWrites: typeof testWrites;
1520
1630
  get designTranslations(): Readonly<Record<string, string>> | undefined;
1521
1631
  design: VlDesign | null;
1522
1632
  /** What was chosen or changed on the Designer's canvas. */
@@ -1598,7 +1708,13 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1598
1708
  };
1599
1709
  onScrollEvent(event: any): void;
1600
1710
  showLinkDetails(option: any, data: any): void;
1711
+ /** A text of the layout in the app's language - its key in the language file, else as written. */
1712
+ private inLanguage;
1713
+ /** The empty list's text (layoutSchema.noRecordMessage) in the app's language. */
1714
+ get noRecordText(): string;
1601
1715
  invokeGridBtnClick(option: any, propertySchema: any): void;
1716
+ /** A row's button: its record goes along, like a card's button (add to cart, open, dialog …). */
1717
+ invokeRowBtnClick(option: any, record: any): void;
1602
1718
  /**
1603
1719
  * An action icon of a row (save / delete of an action column) calls its address. The address is filled per click
1604
1720
  * from the layout ({{field}} = the row's field) - the layout's own option stays as it is (it was overwritten, a
@@ -1683,6 +1799,10 @@ declare class GridComponent implements AfterViewInit, OnDestroy {
1683
1799
  /** The DTO type of a column ("boolean" or a text flag for the switch). */
1684
1800
  propertyType(col: any): string;
1685
1801
  /** The DTO type of a column as the data object declares it ("string", "quantity" ...). */
1802
+ /** A column that shows a value calculated from fields of the row (innerAction calculate, older { action: multiply }). */
1803
+ isCalculated(col: any): boolean;
1804
+ /** The calculated value of a row: the operator over the named fields (multiply when none is named). */
1805
+ calculatedValue(col: any, row: any): number;
1686
1806
  cellType(col: any): string;
1687
1807
  static ɵfac: i0.ɵɵFactoryDeclaration<GridComponent, never>;
1688
1808
  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>;
@@ -1696,6 +1816,11 @@ declare class HeaderMenuComponent implements AfterViewInit {
1696
1816
  private platform;
1697
1817
  /** Marks for the app's test runner (#166): field key and button action. */
1698
1818
  readonly vlFieldKey: typeof testFieldKey;
1819
+ readonly vlFieldPath: typeof testFieldPath;
1820
+ /** The search field's key at the bottom right (Designer: option.enterKey) - Search unless set otherwise. */
1821
+ searchEnterKey(element: any): string;
1822
+ /** The search field's keyboard by the rule of every field: its keyboardType, else a text field's (user 2026-10-31). */
1823
+ searchKeyboard(element: any): string | null;
1699
1824
  readonly vlAction: typeof testAction;
1700
1825
  readonly vlWrites: typeof testWrites;
1701
1826
  isLogined: boolean;
@@ -1784,6 +1909,7 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1784
1909
  private readonly dialogRef;
1785
1910
  private readonly dialogConfig;
1786
1911
  private utilityService;
1912
+ private readonly pdfViewer;
1787
1913
  /** Marks for the app's test runner (#166): field key and button action. */
1788
1914
  readonly vlFieldKey: typeof testFieldKey;
1789
1915
  readonly vlFieldPath: typeof testFieldPath;
@@ -1871,6 +1997,8 @@ declare class ModelComponent implements OnChanges, OnDestroy {
1871
1997
  private readonly lockHintCache;
1872
1998
  /** A click on a locked button: nothing is sent; every field shows its message, the first missing one comes into view. */
1873
1999
  showMissing(form: NgForm | null): void;
2000
+ /** A PDF button without an address in the record: nothing to show, the button stays away. */
2001
+ noPdf(formField: any): boolean;
1874
2002
  checkValidty(form: NgForm): boolean;
1875
2003
  onCancel(): void;
1876
2004
  /** Whether the element's settings are open in the Designer (it is marked). */
@@ -1930,6 +2058,7 @@ interface TermsDialogDocument {
1930
2058
  value: string;
1931
2059
  }
1932
2060
  declare class TermsDialog {
2061
+ private readonly pdfViewer;
1933
2062
  /** the documents; to confirm, the terms (agb) come first, imprint and privacy as links */
1934
2063
  set documents(docs: TermsDialogDocument[] | null);
1935
2064
  /** true: Accept / Decline before the sign-in; false: a document to read */
@@ -2048,6 +2177,7 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
2048
2177
  private dialogService;
2049
2178
  private notificationService;
2050
2179
  private injector;
2180
+ private readonly pdfViewer;
2051
2181
  isCollapsed: boolean;
2052
2182
  isMobile: boolean;
2053
2183
  projectsLayoutSchema: any;
@@ -2079,9 +2209,28 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
2079
2209
  designSelected(path: number[]): boolean;
2080
2210
  selectDesignEntry(path: number[], event?: Event): void;
2081
2211
  selectDesignMenu(): void;
2212
+ designMenuSelected(): boolean;
2213
+ /** the canvas menu folded like the app's (its handle) */
2214
+ designCollapsed: boolean;
2215
+ private designOpenPaths;
2216
+ designOpen(path: number[]): boolean;
2217
+ designFold(path: number[], open: boolean): void;
2218
+ designNode(path: number[]): any;
2219
+ /** the app has a sign-in (Main's app settings: at the start or at any time) - only then the app shows a user */
2220
+ designSignIn(): boolean;
2221
+ /** the menu's own logout entry (top level) - the app shows it as the sign-out beside the user */
2222
+ designLogoutPath(): number[] | null;
2223
+ /** "+": the Designer adds an entry at the top ([]) or into the folder of path */
2224
+ designAdd(path: number[]): void;
2225
+ /** What a menu entry does (action catalog): '' opens its page; login, logout, cart. */
2226
+ menuAction(item: any): string;
2082
2227
  menuText(item: any): string;
2228
+ /** The inline menu's indent of a level, as nz-menu gives it in the app (24px per level). */
2229
+ designIndent(parent: number[]): number;
2083
2230
  menuClasses(style: any): string;
2084
2231
  menuStyle(style: any): Record<string, any>;
2232
+ /** The area's style without its widths: the area (Main's left) is already that wide, the menu fills it. */
2233
+ designRootStyle(): Record<string, any>;
2085
2234
  private refreshDesignMenu;
2086
2235
  private applyDesignMenu;
2087
2236
  designEntryAction(action: DesignAction, path: number[]): void;
@@ -2102,6 +2251,12 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
2102
2251
  private rawMenuItems;
2103
2252
  /** The codes of the project's language files ("en", "de") for the entry Languages. */
2104
2253
  private projectLanguages;
2254
+ /** The page a menu entry opens as tests name it ("pages/sidemenu/books/layout_schema.json" -> "sidemenu/books"). */
2255
+ vlPage(item: any): string | null;
2256
+ /** The language codes the project has (its languages/<code>.json) - the test runner runs a flow in each. */
2257
+ languageCodes(): string[];
2258
+ /** The language shown now ("de"). */
2259
+ currentLanguageCode(): string;
2105
2260
  /** Set once the user picks a language in the menu - the start language then no longer applies. */
2106
2261
  private languageChosenByUser;
2107
2262
  languageChange: EventEmitter<any>;
@@ -2474,6 +2629,8 @@ declare function setToolkitKeyboardOnWeb(on: boolean): void;
2474
2629
  declare function toolkitKeyboardActive(): boolean;
2475
2630
 
2476
2631
  declare function setDateLanguage(languageCode: string | null | undefined): void;
2632
+ /** Display style iso (layout displayFormat): the date as 2026-10-30 and its time as 24 hours in every language. */
2633
+ declare function isIsoDate(option: any): boolean;
2477
2634
  declare function currentDateLanguage(): string;
2478
2635
  /** The numeric date pattern of a language in PrimeNG letters, year with four digits: de "dd.mm.yy". */
2479
2636
  declare function languageDatePattern(languageCode?: string): string;
@@ -2570,6 +2727,52 @@ declare class DateTextPipe implements PipeTransform {
2570
2727
  static ɵpipe: i0.ɵɵPipeDeclaration<DateTextPipe, "vlDateText", true>;
2571
2728
  }
2572
2729
 
2730
+ /** What to show: an address (http, data:, blob:), a title, the call's option (proxy), the app's texts. */
2731
+ interface PdfSource {
2732
+ url: string;
2733
+ title?: string;
2734
+ option?: any;
2735
+ translations?: Record<string, string> | null;
2736
+ }
2737
+ /** The bytes of a base64 text. */
2738
+ declare function bytesOfBase64(text: string): Uint8Array;
2739
+ /** The next zoom step, within the limits. */
2740
+ declare function nextZoom(zoom: number, step: number): number;
2741
+ declare class PdfViewerComponent implements OnInit, OnDestroy {
2742
+ source: PdfSource;
2743
+ private area?;
2744
+ /** set by the service: takes the layer away */
2745
+ closed: () => void;
2746
+ readonly pages: i0.WritableSignal<number[]>;
2747
+ readonly problem: i0.WritableSignal<boolean>;
2748
+ private doc;
2749
+ private zoom;
2750
+ private observer;
2751
+ private drawn;
2752
+ ngOnInit(): Promise<void>;
2753
+ ngOnDestroy(): void;
2754
+ t(key: string, english: string): string;
2755
+ close(): void;
2756
+ onEscape(): void;
2757
+ zoomBy(step: number): void;
2758
+ private canvases;
2759
+ /** Every page gets a size at once (the scroll bar is right), its content when it comes into view. */
2760
+ private prepare;
2761
+ /** The page as wide as the area, times the zoom. */
2762
+ private sizeOf;
2763
+ private draw;
2764
+ static ɵfac: i0.ɵɵFactoryDeclaration<PdfViewerComponent, never>;
2765
+ static ɵcmp: i0.ɵɵComponentDeclaration<PdfViewerComponent, "vl-pdf-viewer", never, { "source": { "alias": "source"; "required": false; }; }, {}, never, never, true, never>;
2766
+ }
2767
+ /** Opens a PDF inside the app. */
2768
+ declare class PdfViewerService {
2769
+ private readonly app;
2770
+ private readonly injector;
2771
+ open(source: PdfSource): void;
2772
+ static ɵfac: i0.ɵɵFactoryDeclaration<PdfViewerService, never>;
2773
+ static ɵprov: i0.ɵɵInjectableDeclaration<PdfViewerService>;
2774
+ }
2775
+
2573
2776
  /** [src]="source | vlMedia | async" - the same Promise for the same source, so no request loop. */
2574
2777
  declare class MediaSourcePipe implements PipeTransform {
2575
2778
  private couchdb;
@@ -2746,11 +2949,20 @@ declare function checkTransformResult(name: string, result: unknown, limits: Add
2746
2949
  records?: any[];
2747
2950
  problem?: string;
2748
2951
  };
2749
- /** What a route gave back, checked: { items, total } or a list; else the reason. */
2952
+ /**
2953
+ * The route of an address: its path against addon.json routes, the longest declared path first, so "/a/b" can have
2954
+ * its own handler beside "/a". The query is the handler's. An address with a host is never a route.
2955
+ */
2956
+ declare function routeOf(url: string, routes: Record<string, any> | undefined): {
2957
+ route: string;
2958
+ query: Record<string, string>;
2959
+ } | null;
2960
+ /** What a route gave back, checked: { items, total, notice } or a list; else the reason. notice: a hint for the user. */
2750
2961
  declare function checkRouteResult(path: string, result: any, limits: AddonLimits): {
2751
2962
  answer?: {
2752
2963
  items: any[];
2753
2964
  total: number;
2965
+ notice?: string;
2754
2966
  };
2755
2967
  problem?: string;
2756
2968
  };
@@ -2773,6 +2985,7 @@ declare class AddonHostService {
2773
2985
  private readonly urls;
2774
2986
  private readonly calls;
2775
2987
  private seq;
2988
+ private routes;
2776
2989
  private upstreamLeft;
2777
2990
  /**
2778
2991
  * The project whose add-on runs (its database, "<tenant>_<project>"), and the values a host "{{name}}" of
@@ -2783,10 +2996,19 @@ declare class AddonHostService {
2783
2996
  setValues(values: Record<string, any>): void;
2784
2997
  /** Records through the add-on's transform (addon.json transforms.<name>): records in, records out. */
2785
2998
  transform(name: string, records: any[], params?: Record<string, any>): Promise<any[]>;
2999
+ /**
3000
+ * The add-on's answer for an address of addon.json routes, null when no route means it: the page then loads from
3001
+ * its backend. page: the runtime's page number, from 0 - the add-on counts from 1. In the shape of a backend page
3002
+ * (totalElements, size), so the page reads it like any other answer.
3003
+ */
3004
+ answerFor(url: string, pageNumber?: number, size?: number): Promise<any | null>;
3005
+ /** The routes of addon.json, read once per project; an app without add-on has none. */
3006
+ private routeTable;
2786
3007
  /** Data of the add-on's route (addon.json routes, GET): { items, total }. */
2787
3008
  route(path: string, query: Record<string, any>, page?: number, size?: number): Promise<{
2788
3009
  items: any[];
2789
3010
  total: number;
3011
+ notice?: string;
2790
3012
  }>;
2791
3013
  private prepare;
2792
3014
  /** addon.json and the add-on's code files from the project, linked from the entry file on. */
@@ -3081,6 +3303,11 @@ declare class CheckboxControl {
3081
3303
  errorMessages: any;
3082
3304
  translations: Record<string, string> | null;
3083
3305
  inputStyle: any;
3306
+ /**
3307
+ * The input style without its widths: a field's "width: 100%" made the box as wide as the row and squeezed the
3308
+ * caption to a letter per line (tm-test Controls Dialog); a check box keeps its own size.
3309
+ */
3310
+ get boxStyle(): any;
3084
3311
  toggled: EventEmitter<any>;
3085
3312
  private control?;
3086
3313
  private get option();
@@ -3115,6 +3342,8 @@ declare class DateTimeControl {
3115
3342
  private control?;
3116
3343
  /** PrimeNG pattern of the date part (de dd.mm.yy = dd.mm.yyyy) */
3117
3344
  pattern(): string;
3345
+ /** Display style iso: the date as 2026-10-30 in every language (a test types year, month, day - data-vl-date-iso) */
3346
+ isIso(): boolean;
3118
3347
  /** "12" (en, AM/PM) or "24" - by the app language */
3119
3348
  hourFormat(): '12' | '24';
3120
3349
  placeholder(): string;
@@ -3170,6 +3399,7 @@ type MediaKind = 'image' | 'video' | 'audio' | 'pdf' | 'file';
3170
3399
  declare function mediaKind(source: string, ...names: any[]): MediaKind;
3171
3400
  declare class MediaControl {
3172
3401
  private readonly sanitizer;
3402
+ readonly pdfViewer: PdfViewerService;
3173
3403
  private trustedCache;
3174
3404
  field: any;
3175
3405
  /** the field's value: a URL, a file name of the project's Media/, or a data: URL */
@@ -3204,6 +3434,8 @@ declare function controlProperty(field: any, propertySchema: any): any;
3204
3434
  * - otherwise the control (option.control, or the field catalog's choice for the type)
3205
3435
  */
3206
3436
  declare function controlKind(field: any, property: any): ControlKind;
3437
+ /** The wrapper of a field keeps the layout's style; a button's look stays on the button, not around it too. */
3438
+ declare function wrapperStyleOf(field: any, style: Record<string, any>): Record<string, any>;
3207
3439
  /**
3208
3440
  * A style object of the layout split into its classes and its CSS: { classes: ['a', 'b'], color }
3209
3441
  * -> { classes: 'a b', style: { color } }. Every class counts, not only the first.
@@ -3241,6 +3473,11 @@ declare class ControlComponent implements OnChanges {
3241
3473
  */
3242
3474
  get hostFieldKey(): string | null;
3243
3475
  get hostFieldPath(): string | null;
3476
+ /** A shown text ends with … after the field's maxLines (Designer: Lines at most) - only where it is shown in a list. */
3477
+ get clamped(): boolean;
3478
+ get maxLines(): string | null;
3479
+ /** The key at the bottom right of the app keyboard (Designer: option.enterKey) - the keyboard reads it here. */
3480
+ get hostEnterKey(): string | null;
3244
3481
  /** display mode: the record whose value is shown (record[name]) */
3245
3482
  record: any;
3246
3483
  /** no label (a grid cell: the column's heading is the label) */
@@ -3287,6 +3524,12 @@ declare class ControlComponent implements OnChanges {
3287
3524
  /** the property's name in a record ("fromDate") */
3288
3525
  name: string;
3289
3526
  ngOnChanges(): void;
3527
+ /**
3528
+ * The values the text input shows. A locked field still holding its fixed start text (option.fieldData.default, e.g.
3529
+ * "FREE") shows that text in the language of the app when the language has it (de "FREI") - only shown: what the
3530
+ * form sends stays the stored value (luv2shop's Shipping on the checkout, 2026-11-02).
3531
+ */
3532
+ private shownSchema;
3290
3533
  get display(): boolean;
3291
3534
  /** a list: the value is shown, not typed in (protected in a form is a locked input, see ruleField) */
3292
3535
  get readonly(): boolean;
@@ -3475,5 +3718,5 @@ declare class DesignTextPipe implements PipeTransform {
3475
3718
  static ɵpipe: i0.ɵɵPipeDeclaration<DesignTextPipe, "vlDesignText", true>;
3476
3719
  }
3477
3720
 
3478
- export { ADDON_API_VERSION, ADDON_TEST_KIT, AddonHostService, 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, DesignFieldPipe, DesignTextPipe, 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, SEND_ERROR_KEY, SIDE_DOCK_CLASS, STORAGE_DATE_FORMAT, SectionDesigner, SideMenuComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, ViewToolkitModule, VisiblePipe, acceptedLocally, addButton, addCardButton, addSection, addonHostAllowed, addonImports, addonLimits, addonManifestProblem, applyLayoutDefaults, backendTermsState, backendUrl, blankComments, buildBackendCall, buttonLocked, cardButton, checkRouteResult, checkTransformResult, clearHeader, cloneLayout, columnFromProperty, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, designDropIds, designField, designText, designTexts, displayDateValue, displayNumber, dropCardProperty, dropGridProperty, dropObjectName, dropProperty, dropTypeAt, elementFromProperty, fieldFromProperty, fieldInnerLayoutStyle, fieldModel, fieldRules, fieldSpan, fillFromUser, fillPlaceholders, fixedTimeText, formatDate, formatDates, fromStorageValue, gridColumnCount, hasBackendCall, headerButton, inputFormatHint, insertField, isAddonCode, isAddonTestFile, isBrowserSource, isNativeMobile, isNativePhone, isPropertyDrop, isSignedIn, isTarget, languageDatePattern, layoutPlaceholder, linkAddonModules, lockHint, lockReason, lockReasons, mediaKind, moveCardElement, moveColumn, moveField, moveSection, moveTreeNode, newButton, newSection, normalizeCard, normalizeCustomKeyboardType, normalizeSections, numberShape, numberStep, numberSuffix, parseRecords, parseStorageDate, parseTimeText, primeDatePattern, proxyFor, rebalanceRow, recordOf, recordsFrom, removeCardElement, removeColumn, removeField, removeHeaderElement, removeSection, removeTreeNode, replaceCardElement, replaceColumn, replaceField, replaceSection, replaceTreeNode, requestDesignDelete, resizeColumn, resolveAddonPath, resolveCustomKeyboardType, resolvePlaceholder, resolveTemplate, ruleMessage, runAddonTests, sampleRecords, sampleValue, sectionSpan, sectionSticky, sectionTabletSpan, sectionVisible, sendErrorText, sendsForm, 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, transformHandler, treeNode, treePaths, typedMeridiem, typedToStored, usesTwelveHours, validTreePath, visibleFields, whenOnline, withAppPagination, withoutMarks };
3479
- export type { AddonFiles, AddonLimits, AddonManifest, AddonTestResult, BackendCall, CallContext, CardDesignerHost, CardDragData, CardDropSpot, CardDropType, CardPlace, ControlKind, CustomKeyboardTarget, CustomKeyboardType, DataSource, DesignAction, DesignDeleteRequest, DesignDevice, DesignEvent, DesignPropertyDrop, DesignTarget, DesignTexts, DesignTranslations, DropSpot, DropType, FieldKind, FieldModel, FieldRules, LockHint, LockReason, LockState, MediaKind, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, NumberShape, OidcProvider, OidcRefresh, OidcTokens, PageDataDeps, RequestTimeoutMessages, SectionDesignerHost, SectionDragData, SectionKind, SendResult, StagedReadOptions, StorageKind, TermsAcceptance, TermsDialogDocument, TermsSettings, TreeKey, VlDesign };
3721
+ export { ADDON_API_VERSION, ADDON_TEST_KIT, AddonHostService, 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, DesignFieldPipe, DesignTextPipe, DropMarkerComponent, DropdownControl, FormComponent, GRID_COLUMNS, GridComponent, HeaderMenuComponent, LogsComponent, MAX_FIELDS_PER_ROW, MAX_ROW_COLUMNS, MediaControl, MediaSourcePipe, MobileKeycloakService, MobileOidcService, MobileOktaService, ModelComponent, NetworkLogService, NotificationService, NumberControl, PLACEHOLDER_SOURCES, PageData, PaginationComponent, PasswordControl, PdfViewerComponent, PdfViewerService, PlaceholderPipe, READ_ATTEMPT_TIMEOUT, REQUEST_STAGES, RETRY_PAUSES, RETRY_STATUSES, RadioControl, RecordStore, RemoteListService, RequestService, RequestTimeoutError, RequestTimeoutService, RulesPipe, SEND_ERROR_KEY, SIDE_DOCK_CLASS, STORAGE_DATE_FORMAT, SectionDesigner, SideMenuComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, ViewToolkitModule, VisiblePipe, acceptedLocally, addButton, addCardButton, addSection, addonHostAllowed, addonImports, addonLimits, addonManifestProblem, applyLayoutDefaults, backendTermsState, backendUrl, blankComments, buildBackendCall, buttonLocked, bytesOfBase64, cardButton, checkRouteResult, checkTransformResult, clearHeader, cloneLayout, columnFromProperty, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, dependsOnForm, designDropIds, designField, designText, designTexts, displayDateValue, displayNumber, dropCardProperty, dropGridProperty, dropObjectName, dropProperty, dropTypeAt, elementFromProperty, fieldFromProperty, fieldInnerLayoutStyle, fieldModel, fieldRules, fieldSpan, fillFromUser, fillPlaceholders, fixedTimeText, formValuesGiven, formatDate, formatDates, fromStorageValue, gridColumnCount, hasBackendCall, headerButton, inputFormatHint, insertField, isAddonCode, isAddonTestFile, isBrowserSource, isIsoDate, isNativeMobile, isNativePhone, isPropertyDrop, isSignedIn, isTarget, languageDatePattern, layoutPlaceholder, linkAddonModules, linkOfRecord, lockHint, lockReason, lockReasons, mediaKind, moveCardElement, moveColumn, moveField, moveSection, moveTreeNode, newButton, newSection, nextZoom, normalizeCard, normalizeCustomKeyboardType, normalizeSections, numberShape, numberStep, numberSuffix, parseRecords, parseStorageDate, parseTimeText, primeDatePattern, proxyFor, rebalanceRow, recordOf, recordsFrom, removeCardElement, removeColumn, removeField, removeHeaderElement, removeSection, removeTreeNode, replaceCardElement, replaceColumn, replaceField, replaceSection, replaceTreeNode, requestDesignDelete, resizeColumn, resolveAddonPath, resolveCustomKeyboardType, resolvePlaceholder, resolveTemplate, routeOf, ruleMessage, runAddonTests, sampleRecords, sampleValue, sectionSpan, sectionSticky, sectionTabletSpan, sectionVisible, sendErrorText, sendsForm, 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, toggleRecord, toolkitKeyboardActive, transformHandler, treeNode, treePaths, typedMeridiem, typedToStored, usesTwelveHours, validTreePath, visibleFields, whenOnline, withAppPagination, withoutMarks, wrapperStyleOf };
3722
+ export type { AddonFiles, AddonLimits, AddonManifest, AddonTestResult, BackendCall, CallContext, CardDesignerHost, CardDragData, CardDropSpot, CardDropType, CardPlace, ControlKind, CustomKeyboardTarget, CustomKeyboardType, DataSource, DesignAction, DesignDeleteRequest, DesignDevice, DesignEvent, DesignPropertyDrop, DesignTarget, DesignTexts, DesignTranslations, DropSpot, DropType, FieldKind, FieldModel, FieldRules, LockHint, LockReason, LockState, MediaKind, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, NumberShape, OidcProvider, OidcRefresh, OidcTokens, PageDataDeps, PdfSource, RequestTimeoutMessages, SectionDesignerHost, SectionDragData, SectionKind, SendResult, StagedReadOptions, StorageKind, TermsAcceptance, TermsDialogDocument, TermsSettings, TreeKey, VlDesign };