@yomotech/view-toolkit 1.0.68 → 1.0.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yomotech/view-toolkit",
3
- "version": "1.0.68",
3
+ "version": "1.0.70",
4
4
  "peerDependencies": {
5
5
  "@angular/cdk": "^21.0.0",
6
6
  "@angular/common": "^21.0.0",
@@ -48,7 +48,7 @@ declare const DATA_OBJECT_NAME_PLACES: Bag$1;
48
48
  * layout (changed in place). Returns how many values were changed.
49
49
  */
50
50
  declare function renameDataObject(layout: any, oldName: string, newName: string): number;
51
- declare const BASIC_TYPES: readonly ["string", "number", "integer", "bigdecimal", "boolean", "date", "time", "datetime", "dateRange", "media", "array"];
51
+ declare const BASIC_TYPES: readonly ["string", "number", "integer", "bigdecimal", "boolean", "date", "time", "duration", "datetime", "dateRange", "media", "array"];
52
52
  /** Older or other names of a data type and the type they mean. */
53
53
  declare const TYPE_ALIASES: Bag$1;
54
54
  /** The data type of a property, aliases resolved ("image" -> "media"). */
@@ -162,7 +162,7 @@ declare const OLD_DEVICE_NAMES: Record<string, string>;
162
162
  declare const ORIENTATIONS: readonly ["portrait", "landscape"];
163
163
  declare const STEP_KINDS: readonly ["open", "menu", "tap", "type", "pick", "press", "scroll", "openRecord", "ifRecords", "goToPage", "close", "cart", "rotate", "device", "wait", "language", "reload", "signIn", "signOut", "expect"];
164
164
  /** What an expect step can check - one of them per step. */
165
- declare const EXPECT_KINDS: readonly ["value", "shows", "keyboard", "list", "message", "visible", "hidden", "locked", "blocked", "inFrame", "page", "records", "recordsAtLeast", "listLoaded", "pdf", "samePlace", "cartCount", "toast", "checked", "unchecked", "cardRows", "formatted", "translated", "fieldVisible", "restored", "layout"];
165
+ declare const EXPECT_KINDS: readonly ["value", "shows", "keyboard", "list", "message", "visible", "hidden", "locked", "blocked", "inFrame", "page", "records", "recordsAtLeast", "listLoaded", "pdf", "samePlace", "cartCount", "toast", "checked", "unchecked", "cardRows", "formatted", "translated", "fieldVisible", "restored", "layout", "filled"];
166
166
  /** How a value is shown in the language's form (expect formatted). */
167
167
  declare const FORMATS: readonly ["date", "time", "datetime", "number", "currency"];
168
168
  /** Languages written right to left - not tested until right-to-left is supported (decision 2026-10-30). */
@@ -222,6 +222,8 @@ interface TestExpect {
222
222
  restored?: true;
223
223
  /** the page passes the layout rules (layoutProblems) */
224
224
  layout?: true;
225
+ /** the field (its key) holds something - whatever it is (a suggestion filled it from live data) */
226
+ filled?: string;
225
227
  }
226
228
  interface TestStep {
227
229
  open?: string;
@@ -232,7 +234,8 @@ interface TestStep {
232
234
  into?: string;
233
235
  /** with type: the field's n-th input (1-based) - the end of a period (daterange) is 2 */
234
236
  at?: number;
235
- pick?: string;
237
+ /** an entry of the field's list by its shown text, or by position (1 = first) - live data: the entries are not known */
238
+ pick?: string | number;
236
239
  in?: string;
237
240
  press?: string;
238
241
  /** pages to go on in the open list (swipe up / its end into view), 1-20 */
@@ -429,11 +432,19 @@ interface LayoutSnapshot {
429
432
  };
430
433
  /** card lists with aligned rows (card.alignRows): per row of cards, the tops of their button elements */
431
434
  cardRows?: number[][];
435
+ /** an open app keyboard / docked calendar: its background and the colour it should have (the page's, or the
436
+ * project's own keyboard colour) */
437
+ panels?: {
438
+ name: string;
439
+ background: string;
440
+ expected: string;
441
+ }[];
432
442
  }
433
443
  /**
434
444
  * The layout rules (OFFENE-PUNKTE 143), judged on what a runner measured: beyond (an element leaves the frame
435
445
  * sideways), sideways (the page scrolls sideways), overlap (two fields / buttons cover each other), narrow (a text
436
- * gets fewer than 3 characters a line), row (fields of one row do not stand on one line). Pixels tolerate 2.
446
+ * gets fewer than 3 characters a line), row (fields of one row do not stand on one line), colour (an open keyboard or
447
+ * calendar not in the page's colour). Pixels tolerate 2.
437
448
  */
438
449
  declare function layoutProblems(snap: LayoutSnapshot): {
439
450
  rule: string;
@@ -921,6 +932,7 @@ declare function probeLayoutSnapshot(): {
921
932
  scrollers: any[];
922
933
  header?: any;
923
934
  cardRows: number[][];
935
+ panels: any[];
924
936
  };
925
937
  /** Whether a field (data-vl-path with a dot, else data-vl-field) stands visible above an open keyboard: '' or why not. */
926
938
  declare function probeFieldVisible(key: string): string;
@@ -67,7 +67,8 @@ declare function fieldRules(field: any): FieldRules;
67
67
  /**
68
68
  * The message for the first error of a field: the layout's own (option.messages[rule], may be a
69
69
  * translation key), else the project's text (errorMessage_xx.json: required, pattern, email,
70
- * minlength, maxlength, min, max), else English. {{field}}, {{requiredLength}}, {{min}}, {{max}}
70
+ * minlength, maxlength, min, max, notBefore, notAfter, minDuration, maxDuration), else English. {{field}},
71
+ * {{requiredLength}}, {{min}}, {{max}}, {{other}} (the other field's caption), {{limit}}
71
72
  * are filled in.
72
73
  */
73
74
  declare function ruleMessage(field: any, errors: Record<string, any> | null | undefined, projectTexts?: Record<string, string> | null, translations?: Record<string, string> | null, caption?: string): string;
@@ -404,8 +405,8 @@ declare function resolveTemplate(template: any, context: CallContext): any;
404
405
  declare const PLACEHOLDER_SOURCES: string[];
405
406
  /**
406
407
  * An address or text with the placeholders filled in that the context can answer: a known source
407
- * ({{userInfo.x}}, {{env.x}}, {{record.x}}, {{form.x}}, {{filter.x}}, {{pageNumber}}, {{pageSize}}) - empty when the
408
- * value is missing - or a field the context or the signed-in user has ({{p5_backend_url}}). Anything else stays as
408
+ * ({{user.x}}, {{env.x}}, {{record.x}}, {{form.x}}, {{filter.x}}, {{pageNumber}}, {{pageSize}}) - empty when the
409
+ * value is missing - or a field the context has. Anything else stays as
409
410
  * written, so a caller can fill its own ({{id}} of a delete). encode: URL-encode the values (an address part).
410
411
  */
411
412
  declare function fillPlaceholders(text: string, context: CallContext, encode?: boolean): string;
@@ -416,6 +417,8 @@ declare function hasBackendCall(option: any): boolean;
416
417
  * A relative address is put after env.apiUrl. Without an address there is no call (null).
417
418
  */
418
419
  declare function buildBackendCall(option: any, context: CallContext): BackendCall | null;
420
+ /** An answer read as text: its JSON when it is JSON, else the text itself (an empty answer: null). */
421
+ declare function parseAnswer(data: unknown): unknown;
419
422
 
420
423
  declare class RequestService {
421
424
  private http;
@@ -478,7 +481,7 @@ declare class UtilityService {
478
481
  * The form's values as the body of a POST - a copy, nothing evaluated. It ran every {{…}} in the values as
479
482
  * JavaScript (new Function): whatever a person typed into a field or a page held was executed in the app
480
483
  * (OFFENE-PUNKTE 95). The content a backend wants comes from option.body with the safe placeholders
481
- * ({{form.x}}, {{record.x}}, {{userInfo.x}}, {{cart.x}}, {{env.x}} - resolveTemplate).
484
+ * ({{form.x}}, {{record.x}}, {{user.x}}, {{cart.x}}, {{env.x}} - resolveTemplate).
482
485
  */
483
486
  parseBodyObject(obj: any): any;
484
487
  /**
@@ -491,7 +494,7 @@ declare class UtilityService {
491
494
  getTotalQuantity(tableitemInfo: any): number;
492
495
  /**
493
496
  * A page's address with its placeholders: {{pageNumber}}, {{pageSize}} and - with a context - any field of the
494
- * signed-in user ({{userInfo.userId}}) or the Configuration ({{env.x}}). Only page number and size were filled
497
+ * signed-in user's record ({{user.userId}}) or the Configuration ({{env.x}}). Only page number and size were filled
495
498
  * before, so an address could not name the user (hotel Bookings asked for user 3 whoever was signed in).
496
499
  */
497
500
  replacePaginationParams(url: string, currentPage: number, pageSize: number, context?: CallContext): string;
@@ -731,6 +734,10 @@ declare class CustomKeyboardService {
731
734
  private openingSuspendedUntil;
732
735
  private tapsTracked;
733
736
  private lastPointerDownAt;
737
+ /** the element the last tap went to - a field opened by a tap keeps the cursor where it was tapped */
738
+ private lastPointerTarget;
739
+ private lastPointerX;
740
+ private measureCanvas;
734
741
  private lastClickAt;
735
742
  /** Set by DateTimePickerService: closes the open picker when another field is tapped. */
736
743
  private pickerCloser;
@@ -815,6 +822,18 @@ declare class CustomKeyboardService {
815
822
  closeIfTargetInside(container: HTMLElement): void;
816
823
  private updateTarget;
817
824
  private isValidValue;
825
+ /**
826
+ * Where the cursor stands once the keyboard is open: a field opened by a tap (finger, mouse) keeps it where it was
827
+ * tapped, so a date can be changed in the middle - its digit is overwritten (insertDateTimeDigit); before, the
828
+ * cursor always went behind the year (user 2026-11-13). Opened any other way (Tab, Next, a test that focuses the
829
+ * field) or with a selection: at the end, as before.
830
+ */
831
+ private placeCursorAfterOpen;
832
+ /**
833
+ * The cursor at the character a tap at clientX points to (the field's own font measured; left-aligned text) -
834
+ * true when set inside the value. A tap behind the text, or a field that cannot be measured: false (end).
835
+ */
836
+ private setCaretFromTap;
818
837
  private moveCursorToEnd;
819
838
  private readonly documentPointerDownHandler;
820
839
  private readonly activeTargetBlurHandler;
@@ -859,9 +878,9 @@ declare class CustomKeyboardService {
859
878
  */
860
879
  private followDialog;
861
880
  /**
862
- * Keyboard and calendar look like the page behind them: its background colour - from the
863
- * project's styles, the app or the theme - becomes --vl-page-background. Dialogs, masks and the
864
- * panels themselves are looked through; transparent elements pass on their parent's colour.
881
+ * Keyboard and calendar look like the page behind them: the page area's background colour - from
882
+ * the project's styles, the app or the theme - becomes --vl-page-background; a transparent page
883
+ * area passes on the colour above it. Content on the page (cells, cards, buttons) never counts.
865
884
  */
866
885
  applyPageBackground(): void;
867
886
  /** Keyboard: side or bottom, the same decision as the calendar's. */
@@ -971,7 +990,19 @@ interface DataSource {
971
990
  name: string;
972
991
  type?: string;
973
992
  }[];
993
+ /** a filter page opened again shows the filter values typed last and loads its list; default: empty like the first time */
994
+ keepFilter?: boolean;
995
+ /**
996
+ * records in the browser kept apart per signed-in user (shared devices): the key gets ".<value of a sign-in field>".
997
+ * true = preferred_username (Keycloak); a text names the field (Okta "uid", an own JWT "username" ...). Optional,
998
+ * needs a sign-in; a signed-in user without that field is an error, never a shared list (user 2026-11-12)
999
+ */
1000
+ perUser?: boolean | string;
974
1001
  }
1002
+ /** The sign-in field a perUser source is kept apart by; '' when the source is not kept per user. */
1003
+ declare function perUserField(source: DataSource | null | undefined): string;
1004
+ /** The browser key of a source: data_url, kept per user with ".<value>"; null when a per-user source has no value. */
1005
+ declare function storageKeyOf(source: DataSource | null | undefined, userValue?: string | null): string | null;
975
1006
  type StorageKind = 'localstorage' | 'sessionstorage' | 'filter' | 'database' | '';
976
1007
  /** The kind of a data source, lowercase - "localStorage" of older Designer versions counts as "localstorage". */
977
1008
  declare function storageKind(source: DataSource | null | undefined): StorageKind;
@@ -1000,6 +1031,15 @@ declare function parseRecords(value: unknown): any[];
1000
1031
  */
1001
1032
  declare function recordOf(propertySchema: Record<string, any> | null | undefined, fields?: string[]): Record<string, any>;
1002
1033
 
1034
+ /** A message text of an option (errorMessage, emptyMessage), trimmed; undefined when not set. */
1035
+ /**
1036
+ * A failed load as the list tells it: unreachable when no answer came (fetch failed - a browser refusing a server
1037
+ * without CORS, no network, a timeout), else the server's reason ("POST /x failed: 500 - <reason>").
1038
+ */
1039
+ declare function loadErrorOf(error: unknown): {
1040
+ unreachable: boolean;
1041
+ reason: string;
1042
+ };
1003
1043
  /** What PageData needs from the app: storage, backend, the question before deleting, a message. */
1004
1044
  /** dataKey: the answer itself is the list (or the one record, a detail page). */
1005
1045
  declare const DATA_KEY_ANSWER = "@answer";
@@ -1055,6 +1095,14 @@ declare class PageData {
1055
1095
  loading: boolean;
1056
1096
  /** the last load of the backend failed (a test tells an empty list from a broken one) */
1057
1097
  loadFailed: boolean;
1098
+ /**
1099
+ * Why the last load failed, for the list to say it as long as it stands (2026-11-13: the page stayed empty): the server
1100
+ * not reached at all (no answer, refused by the browser, no network) or its own error answer with the reason it gave.
1101
+ */
1102
+ loadError: {
1103
+ unreachable: boolean;
1104
+ reason: string;
1105
+ } | null;
1058
1106
  filter: Record<string, any>;
1059
1107
  /** The last backend answer as it came (its paging fields). */
1060
1108
  lastAnswer: any;
@@ -1069,7 +1117,11 @@ declare class PageData {
1069
1117
  private generation;
1070
1118
  /** The pages already added while scrolling (page 0 = the first). */
1071
1119
  private loadedUpTo;
1120
+ /** A server that answers the whole list at once (no page numbers in its answer): all its records, shown page by page. */
1121
+ private allAtOnce;
1072
1122
  constructor(source: DataSource & Record<string, any>, deps: PageDataDeps, pageSize?: number);
1123
+ /** A filter page: the server answered the whole list for the filter values - scrolling shows it a page at a time. */
1124
+ get wholeServerList(): boolean;
1073
1125
  /** Browser list and filter page: all records are here and paged in the app; a backend pages itself. */
1074
1126
  get clientPaging(): boolean;
1075
1127
  load(): Promise<void>;
@@ -1098,6 +1150,15 @@ declare class PageData {
1098
1150
  send(button: any, index: number | 'all'): Promise<boolean>;
1099
1151
  /** A button with a browser storage: its record goes into the button's list, or out again (toggleRecord). */
1100
1152
  keep(button: any, record: any): Promise<boolean>;
1153
+ /**
1154
+ * The first filter that breaks its rule against another filter (notBefore / notAfter: the other filter's name),
1155
+ * with both names - null while every rule is kept or a value is still missing.
1156
+ */
1157
+ get filterBroken(): {
1158
+ name: string;
1159
+ other: string;
1160
+ kind: 'notBefore' | 'notAfter';
1161
+ } | null;
1101
1162
  /** The page waits for its filters: a filter page with a filter still empty (the empty list says so). */
1102
1163
  get waitingForFilter(): boolean;
1103
1164
  /** Filter fields are the keys set by setFilter; a filter page loads only when none is empty. */
@@ -1248,18 +1309,37 @@ declare class CardComponent {
1248
1309
  /** A fixed text of the library in the app's language (the key is the English text). */
1249
1310
  fixedText(key: string): string;
1250
1311
  emptyText(): string | null;
1312
+ /** The caption of a filter's input in the header (option.filter), in the app's language; its name without one. */
1313
+ private filterCaption;
1251
1314
  /** The filters the page names (dataSource.filters), name -> type; empty for a page without them. */
1252
1315
  private declaredFilters;
1316
+ /** dataSource.keepFilter: the page opened again shows the filter values typed last and loads its list (default: empty). */
1317
+ private keepsFilter;
1253
1318
  private filterSchemaMemo;
1254
1319
  /** The page's schema with its own filters as the group vlFilter - the input knows its type without a data field. */
1255
1320
  filterSchema(): any;
1256
1321
  private filterFields;
1257
- /** The header element as an input of the group vlFilter (kept per element: the field pipe sees the same object). */
1322
+ /**
1323
+ * The header's elements keep their place in the page while they stay the same element: a filter by its name, the
1324
+ * rest by its position. The language pass hands new copies of them on every change - without this the inputs were
1325
+ * built anew when the list loaded, the filter being typed in lost its focus and the keyboard closed (2026-11-13).
1326
+ */
1327
+ trackHeaderElement(index: number, element: any): string | number;
1328
+ /** The header element as an input of the group vlFilter (kept per filter and content: the field pipe sees the same object). */
1258
1329
  filterField(element: any): any;
1259
1330
  private pageFilterValues;
1260
- /** A filter of the page changed: its value goes to {{filter.<name>}}; once all are set the keyboard closes. */
1331
+ /** filter values typed on the toolkit keyboard, not yet confirmed - they go to the page's data when it closes */
1332
+ private pendingFilter;
1333
+ /**
1334
+ * The toolkit keyboard closed (its ✓, a tap beside it): the filters typed meanwhile are confirmed, the search starts.
1335
+ * A jump to the next field opens the keyboard again at once - checked when the effect runs, so it waits for that.
1336
+ */
1337
+ private readonly confirmFilterOnClose;
1338
+ /** A filter typed on the toolkit keyboard waits for its confirmation; anything else (calendar, no keyboard) loads at once. */
1339
+ private setPageFilter;
1340
+ /** A filter of the page changed: its value goes to {{filter.<name>}} - on the toolkit keyboard once it is confirmed. */
1261
1341
  pageFilterChange(element: any, value: any): Promise<void>;
1262
- /** The filter values go to the page's data; it loads once every filter field is set. */
1342
+ /** The filter values go to the page's data; it loads once every filter field is set (typed: once confirmed). */
1263
1343
  applyDateFilter(filters: any): Promise<void>;
1264
1344
  /** Every filter field of the page, an unset one as null - the page loads only when none is empty. */
1265
1345
  extractFilterValues(schema: Record<string, any>): Record<string, any>;
@@ -1581,8 +1661,17 @@ declare class FormComponent implements OnInit, OnChanges, DoCheck, AfterViewInit
1581
1661
  */
1582
1662
  showMissing(form: NgForm | null): void;
1583
1663
  invokeFormBtnClick(option: any, propertySchema: any): void;
1664
+ /** The add-on's message without a field, and the button it stands under (check "addon:<name>", 225 B). */
1665
+ checkNotice: string;
1666
+ checkNoticeFor: any;
1667
+ private readonly addons;
1668
+ /** Runs the add-on's check on the form's record; without a finding the button does what it does without a check. */
1669
+ private checkThenEmit;
1584
1670
  /** A change of the form may change the address of a dependent dropdown ({{form.x}} in its data_url). */
1585
1671
  ngDoCheck(): void;
1672
+ /** The page's form, for the rules between fields (cross-rules-attach.ts). */
1673
+ formRef?: NgForm;
1674
+ private readonly crossRules;
1586
1675
  setformData(): void;
1587
1676
  setErroMessage(formField: any, errorMessages: any, field: any): string;
1588
1677
  setValidations(): void;
@@ -1954,15 +2043,21 @@ declare class LogsComponent {
1954
2043
  static ɵcmp: i0.ɵɵComponentDeclaration<LogsComponent, "vl-logs", never, {}, {}, never, never, true, never>;
1955
2044
  }
1956
2045
 
1957
- declare class ModelComponent implements OnChanges, OnDestroy {
2046
+ declare class ModelComponent implements OnChanges, OnDestroy, DoCheck {
1958
2047
  private cdr;
1959
2048
  private readonly dialogRef;
1960
2049
  private readonly dialogConfig;
1961
2050
  private utilityService;
2051
+ /** The dialog's form, for the rules between fields (cross-rules-attach.ts). */
2052
+ dynamicForm?: NgForm;
2053
+ private readonly crossRules;
2054
+ /** Rules between fields (notBefore, requiredWhen, duration limits): on the controls, checked again on a change. */
2055
+ ngDoCheck(): void;
1962
2056
  /** In the Designer's preview: the dialog's file and each field's place in it (designer links, worklist 25). */
1963
2057
  readonly linksOn: typeof designerLinksOn;
1964
2058
  vlPlace(section: any, field: any): string | null;
1965
2059
  private readonly pdfViewer;
2060
+ private readonly addons;
1966
2061
  /** Marks for the app's test runner (#166): field key and button action. */
1967
2062
  readonly vlFieldKey: typeof testFieldKey;
1968
2063
  readonly vlFieldPath: typeof testFieldPath;
@@ -2041,6 +2136,17 @@ declare class ModelComponent implements OnChanges, OnDestroy {
2041
2136
  applyDurationRule(rule: any, formField: any): void;
2042
2137
  invokeSetformData(): void;
2043
2138
  invokeFormBtnClick(option: any, propertySchema: any, form: NgForm): void;
2139
+ /** The add-on's message without a field, and the button it stands under (check "addon:<name>"). */
2140
+ checkNotice: string;
2141
+ checkNoticeFor: any;
2142
+ /**
2143
+ * Runs the add-on's check on the dialog's record: no finding - the dialog closes as without a check; a finding with a
2144
+ * field stands at that field (error "addon"), one without under the button. A check that cannot run refuses too -
2145
+ * an unchecked record is never saved quietly.
2146
+ */
2147
+ private checkThenClose;
2148
+ /** The layout field of a button by its option (the one clicked). */
2149
+ private buttonOf;
2044
2150
  /** A button grey and without click: needsLogin without a user, needsValid with a broken field rule. */
2045
2151
  isLocked(formField: any, form: NgForm | null): boolean;
2046
2152
  /** Why a button is locked: 'login' (needsLogin, nobody signed in) or 'valid' (needsValid, a field rule broken). */
@@ -2133,7 +2239,7 @@ declare class TermsDialog {
2133
2239
 
2134
2240
  /** What a project's login configuration has to say about its identity provider. */
2135
2241
  interface OidcProvider {
2136
- /** e.g. https://keycloak-poc.wilken.de/realms/p5, https://integrator-1772139.okta.com/oauth2/default */
2242
+ /** e.g. https://id.example.com/realms/app, https://integrator-1772139.okta.com/oauth2/default */
2137
2243
  issuer: string;
2138
2244
  clientId: string;
2139
2245
  redirectUri: string;
@@ -2298,6 +2404,8 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
2298
2404
  appVersionInfo: any;
2299
2405
  /** Languages to start in, best first (language codes "de", "en" ...); the first the project has wins. */
2300
2406
  startLanguages: string[];
2407
+ /** keep the chosen language on the device (the real app); false in the Designer's preview */
2408
+ keepLanguage: boolean;
2301
2409
  /** Main's start page area (center) - with appSettings the library adds the setting entries itself (OFFENE-PUNKTE 106/108). */
2302
2410
  mainCenter: any;
2303
2411
  /** The menu as the app hands it over, before the setting entries are added. */
@@ -2423,7 +2531,7 @@ declare class SideMenuComponent implements AfterViewInit, OnChanges, OnDestroy {
2423
2531
  private applyMenuTranslations;
2424
2532
  private applySettingTranslations;
2425
2533
  static ɵfac: i0.ɵɵFactoryDeclaration<SideMenuComponent, never>;
2426
- static ɵcmp: i0.ɵɵComponentDeclaration<SideMenuComponent, "vl-side-menu", never, { "design": { "alias": "design"; "required": false; }; "menuLayout": { "alias": "menuLayout"; "required": false; }; "menuItems": { "alias": "menuItems"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "settings": { "alias": "settings"; "required": false; }; "projects": { "alias": "projects"; "required": false; }; "tenantName": { "alias": "tenantName"; "required": false; }; "environment": { "alias": "environment"; "required": false; }; "projectSeleted": { "alias": "projectSeleted"; "required": false; }; "appVersionInfo": { "alias": "appVersionInfo"; "required": false; }; "startLanguages": { "alias": "startLanguages"; "required": false; }; "mainCenter": { "alias": "mainCenter"; "required": false; }; }, { "designChange": "designChange"; "languageChange": "languageChange"; "invokeMenu": "invokeMenu"; "menuToggle": "menuToggle"; "invokeProject": "invokeProject"; "errorMessage": "errorMessage"; "deleteProject": "deleteProject"; "paginationType": "paginationType"; }, never, never, true, never>;
2534
+ static ɵcmp: i0.ɵɵComponentDeclaration<SideMenuComponent, "vl-side-menu", never, { "design": { "alias": "design"; "required": false; }; "menuLayout": { "alias": "menuLayout"; "required": false; }; "menuItems": { "alias": "menuItems"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "settings": { "alias": "settings"; "required": false; }; "projects": { "alias": "projects"; "required": false; }; "tenantName": { "alias": "tenantName"; "required": false; }; "environment": { "alias": "environment"; "required": false; }; "projectSeleted": { "alias": "projectSeleted"; "required": false; }; "appVersionInfo": { "alias": "appVersionInfo"; "required": false; }; "startLanguages": { "alias": "startLanguages"; "required": false; }; "keepLanguage": { "alias": "keepLanguage"; "required": false; }; "mainCenter": { "alias": "mainCenter"; "required": false; }; }, { "designChange": "designChange"; "languageChange": "languageChange"; "invokeMenu": "invokeMenu"; "menuToggle": "menuToggle"; "invokeProject": "invokeProject"; "errorMessage": "errorMessage"; "deleteProject": "deleteProject"; "paginationType": "paginationType"; }, never, never, true, never>;
2427
2535
  }
2428
2536
 
2429
2537
  declare class Autocomplete implements OnChanges {
@@ -2458,9 +2566,13 @@ declare class Autocomplete implements OnChanges {
2458
2566
  /** the name of the field in the entries (the property's name, "workOrderNo") */
2459
2567
  get key(): string;
2460
2568
  get optionLabel(): string;
2569
+ /** option.openOnFocus: a tap into the field opens the whole list (default: only the arrow) */
2570
+ get openOnFocus(): boolean;
2571
+ /** option.search: "contains" keeps entries holding the text anywhere; default "startsWith" */
2572
+ get searchMode(): 'startsWith' | 'contains';
2461
2573
  get forceSelection(): boolean;
2462
2574
  get emptyText(): string;
2463
- /** (completeMethod): the entries that start with what was typed */
2575
+ /** (completeMethod): the entries that start with (or, option.search "contains", hold) what was typed */
2464
2576
  complete(event: {
2465
2577
  query?: string;
2466
2578
  }): void;
@@ -2576,6 +2688,10 @@ declare class Textbox {
2576
2688
  selectedLanguageInfo: any;
2577
2689
  constructor(cdr: ChangeDetectorRef, utilityService: UtilityService);
2578
2690
  ngOnInit(): void;
2691
+ /** a field without a place in the data keeps its value here (see slot) */
2692
+ private readonly ownSlot;
2693
+ /** The field's place in the data (propertySchema), or its own one when the data has none. */
2694
+ slot(formField: any): any;
2579
2695
  getScope(scope: any): string;
2580
2696
  getStyleWithoutClasses(styleObject: any): {
2581
2697
  classes: any;
@@ -2741,6 +2857,13 @@ declare function parseTimeText(text: string): {
2741
2857
  } | null;
2742
2858
  /** AM <-> PM of a typed 12-hour time ("08:30 AM" -> "08:30 PM"); a time without one gets PM. */
2743
2859
  declare function toggleMeridiem(text: string): string;
2860
+ /**
2861
+ * A duration (data type "duration") as text: hours and minutes, the same in every language, never AM/PM. Reads
2862
+ * "8:45" / "08:45:00" (computed), a date-time of a server ("1970-01-01T04:55:00…" - its wall time), a Date and a number
2863
+ * of minutes. Pattern HH:mm (04:55) unless option.displayFormat "custom" names H:mm or h:mm (4:55). Hours above 23 stay
2864
+ * (24:00). Anything else comes back unchanged.
2865
+ */
2866
+ declare function durationText(value: any, option?: any): string;
2744
2867
 
2745
2868
  /**
2746
2869
  * The placeholder of a field: only its layout (option.placeholder, set in the Designer), translated
@@ -2964,6 +3087,11 @@ declare function backendUrl(url: string, proxy: boolean): string;
2964
3087
  declare class RecordStore {
2965
3088
  private utilityService;
2966
3089
  constructor(utilityService: UtilityService);
3090
+ /**
3091
+ * The browser key of the source - kept per user, the value of the named sign-in field goes into it. A per-user
3092
+ * source without that value throws: the records would otherwise land in a list every user of the device shares.
3093
+ */
3094
+ private keyOf;
2967
3095
  /** The records of the source; an empty list when it has none or is not kept in the browser. */
2968
3096
  read(source: DataSource | null | undefined): Promise<any[]>;
2969
3097
  /**
@@ -2991,6 +3119,10 @@ interface AddonManifest {
2991
3119
  transforms?: Record<string, {
2992
3120
  handler: string;
2993
3121
  }>;
3122
+ /** checks (OFFENE-PUNKTE 225 B): a button names one with check "addon:<name>"; [] = fine, else what is wrong */
3123
+ checks?: Record<string, {
3124
+ handler: string;
3125
+ }>;
2994
3126
  hosts?: string[];
2995
3127
  limits?: {
2996
3128
  timeoutMs?: number;
@@ -3009,6 +3141,26 @@ declare function addonLimits(manifest: AddonManifest | null | undefined): AddonL
3009
3141
  declare function addonManifestProblem(manifest: AddonManifest | null | undefined): string | null;
3010
3142
  /** The function a transform name stands for (addon.json transforms), or null. */
3011
3143
  declare function transformHandler(manifest: AddonManifest | null | undefined, name: string): string | null;
3144
+ /** The function a check name stands for (addon.json checks), or null. */
3145
+ declare function checkHandler(manifest: AddonManifest | null | undefined, name: string): string | null;
3146
+ /** One thing a check found: the message, and the field it belongs to (a field of the record) when there is one. */
3147
+ interface AddonCheckFinding {
3148
+ message: string;
3149
+ field?: string;
3150
+ }
3151
+ /**
3152
+ * What a check gave back, checked: a list of { message, field? } - empty when the record is fine; else the reason.
3153
+ * A message is a text or a key of the app's language file.
3154
+ */
3155
+ declare function checkCheckResult(name: string, result: unknown): {
3156
+ findings?: AddonCheckFinding[];
3157
+ problem?: string;
3158
+ };
3159
+ /** A check refused the records: nothing is saved or sent; the findings say why. */
3160
+ declare class AddonCheckRefused extends Error {
3161
+ readonly findings: AddonCheckFinding[];
3162
+ constructor(findings: AddonCheckFinding[]);
3163
+ }
3012
3164
  /** What a transform gave back, checked: a list of records within the limits; else the reason. */
3013
3165
  declare function checkTransformResult(name: string, result: unknown, limits: AddonLimits): {
3014
3166
  records?: any[];
@@ -3061,6 +3213,8 @@ declare class AddonHostService {
3061
3213
  setValues(values: Record<string, any>): void;
3062
3214
  /** Records through the add-on's transform (addon.json transforms.<name>): records in, records out. */
3063
3215
  transform(name: string, records: any[], params?: Record<string, any>): Promise<any[]>;
3216
+ /** A record (or several) through the add-on's check (addon.json checks.<name>): [] when fine, else the findings. */
3217
+ check(name: string, records: any[], params?: Record<string, any>): Promise<AddonCheckFinding[]>;
3064
3218
  /**
3065
3219
  * The add-on's answer for an address of addon.json routes, null when no route means it: the page then loads from
3066
3220
  * its backend. page: the runtime's page number, from 0 - the add-on counts from 1. In the shape of a backend page
@@ -3137,6 +3291,11 @@ declare class BackendCallService {
3137
3291
  currentUser(): Promise<any>;
3138
3292
  /** The records after the option's conversion: "addon:<name>" runs the project's add-on (addon.json transforms). */
3139
3293
  transform(option: any, records: any[]): Promise<any[]>;
3294
+ /**
3295
+ * The option's check before anything is saved or sent: "addon:<name>" runs the project's add-on (addon.json checks).
3296
+ * A finding refuses the records (AddonCheckRefused - its message is the reason the card shows).
3297
+ */
3298
+ check(option: any, records: any[]): Promise<void>;
3140
3299
  /** Sends the records to the option's backend; true on success. */
3141
3300
  saveData(option: any, records: any[], extra?: CallContext): Promise<any>;
3142
3301
  /** Loads from the option's backend with the given context (e.g. filter values). */
@@ -3147,6 +3306,16 @@ declare class BackendCallService {
3147
3306
  static ɵprov: i0.ɵɵInjectableDeclaration<BackendCallService>;
3148
3307
  }
3149
3308
 
3309
+ /** Renews the sign-in; the new access token, or null when it cannot (no refresh token, refused, no network). */
3310
+ type RenewSignIn = () => Promise<string | null>;
3311
+ /** The app tells how its sign-in is renewed (null: it cannot be - an app without sign-in or with its own form). */
3312
+ declare function setSignInRenewal(renew: RenewSignIn | null): void;
3313
+ /**
3314
+ * Renews the sign-in once for every call that waits at the same moment: "Alle senden" refused several calls at
3315
+ * once and each would have asked the server for new tokens. null when the app cannot renew.
3316
+ */
3317
+ declare function renewSignIn(): Promise<string | null>;
3318
+
3150
3319
  declare const DEFAULT_DATE_FORMAT = "yyyy-MM-dd'T'HH:mm:ssxxx";
3151
3320
  /** The date written by the pattern, in the device's local time. */
3152
3321
  declare function formatDate(date: Date, pattern?: string): string;
@@ -3406,6 +3575,8 @@ declare class DateTimeControl {
3406
3575
  pattern(): string;
3407
3576
  /** Display style iso: the date as 2026-10-30 in every language (a test types year, month, day - data-vl-date-iso) */
3408
3577
  isIso(): boolean;
3578
+ /** data type "duration" (hours and minutes) */
3579
+ isDuration(): boolean;
3409
3580
  /** "12" (en, AM/PM) or "24" - by the app language */
3410
3581
  hourFormat(): '12' | '24';
3411
3582
  placeholder(): string;
@@ -3690,7 +3861,8 @@ declare class ControlComponent implements OnChanges {
3690
3861
  get contactKind(): string;
3691
3862
  /** a button's icon: its own (option.icon), else for a contact button the one of its kind */
3692
3863
  get buttonIcon(): string;
3693
- /** a button has no input; the field's style is the button's */
3864
+ /** a button has no input; the field's style is the button's - in a dialog the wrapper (vl-dialog-field) already
3865
+ * takes the field's width and margins, so the button fills its wrapper instead of being moved a second time */
3694
3866
  buttonStyle(): {
3695
3867
  classes: string;
3696
3868
  style: Record<string, any>;
@@ -3706,7 +3878,7 @@ declare class ControlComponent implements OnChanges {
3706
3878
  */
3707
3879
  declare function applyLayoutDefaults(schemas: Record<string, any>, layout: any, asValue: boolean): void;
3708
3880
  /**
3709
- * The start values from the signed-in user ({{userInfo.email}}, or {{email}} with option.fromUser) into the fields -
3881
+ * The start values from the signed-in user's record ({{user.email}}) into the fields -
3710
3882
  * when the form opens and again when the sign-in comes or goes. A locked field (protected / disabled) always shows the
3711
3883
  * user's value; an open field only while it is empty or still holds what the sign-in put there, so a typed value
3712
3884
  * stays. Without a sign-in the field is empty, never the placeholder text (user 2026-10-29, luv2shop checkout).
@@ -3773,7 +3945,7 @@ declare function termsStamp(terms: TermsSettings): string;
3773
3945
  declare function termsStorageKey(project: string): string;
3774
3946
  /** Whether the browser's acceptance covers this state. */
3775
3947
  declare function acceptedLocally(stored: TermsAcceptance | null | undefined, stamp: string): boolean;
3776
- /** An address with {{user}}, {{version}}, {{userInfo.x}} and {{env.x}} filled in (URL-encoded); a relative one goes after apiUrl. */
3948
+ /** An address with {{user}} (the user name), {{version}}, {{user.x}} and {{env.x}} filled in (URL-encoded); a relative one goes after apiUrl. */
3777
3949
  declare function termsUrl(url: string, values: {
3778
3950
  user: string;
3779
3951
  version: string;
@@ -3840,5 +4012,5 @@ declare class DesignTextPipe implements PipeTransform {
3840
4012
  static ɵpipe: i0.ɵɵPipeDeclaration<DesignTextPipe, "vlDesignText", true>;
3841
4013
  }
3842
4014
 
3843
- 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, SlideshowComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, VL_MEDIA_RESOLVER, ViewToolkitModule, VisiblePipe, acceptedLocally, addButton, addCardButton, addSection, addonHostAllowed, addonImports, addonLimits, addonManifestProblem, applyLayoutDefaults, applyMapping, backendTermsState, backendUrl, blankComments, buildBackendCall, buttonLocked, bytesOfBase64, cardButton, checkRouteResult, checkTransformResult, clearHeader, cloneLayout, columnFromProperty, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, dependsOnForm, designDropIds, designField, designText, designTexts, designerLinksOn, designerPlace, displayDateValue, displayNumber, dropCardProperty, dropGridProperty, dropObjectName, dropProperty, dropTypeAt, elementFromProperty, fieldFromProperty, fieldInnerLayoutStyle, fieldModel, fieldRules, fieldSpan, fillFromUser, fillPlaceholders, fixedTimeText, formValuesGiven, formatDate, formatDates, fromStorageValue, gridColumnCount, hasBackendCall, hasHeaderTarget, headerButton, inputFormatHint, insertField, isAddonCode, isAddonTestFile, isBrowserSource, isIsoDate, isNativeMobile, isNativePhone, isPropertyDrop, isSignedIn, isTarget, languageDatePattern, layoutPlaceholder, linkAddonModules, linkOfRecord, lockHint, lockReason, lockReasons, mappedValues, 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, sectionPlain, 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, useDesignerLinks, useDraftSource, userRecord, usesTwelveHours, validTreePath, valueAt, visibleFields, whenOnline, withAppPagination, withUserRecord, withoutMarks, wrapperStyleOf };
3844
- 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, DraftSource, 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 };
4015
+ export { ADDON_API_VERSION, ADDON_TEST_KIT, AddonCheckRefused, 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, SlideshowComponent, SwitchControl, TermsDialog, TextareaControl, Textbox, UtilityService, VL_MEDIA_RESOLVER, ViewToolkitModule, VisiblePipe, acceptedLocally, addButton, addCardButton, addSection, addonHostAllowed, addonImports, addonLimits, addonManifestProblem, applyLayoutDefaults, applyMapping, backendTermsState, backendUrl, blankComments, buildBackendCall, buttonLocked, bytesOfBase64, cardButton, checkCheckResult, checkHandler, checkRouteResult, checkTransformResult, clearHeader, cloneLayout, columnFromProperty, controlKind, controlProperty, currencyDigits, currentDateLanguage, dateDigitCount, dateInputPattern, dependsOnForm, designDropIds, designField, designText, designTexts, designerLinksOn, designerPlace, displayDateValue, displayNumber, dropCardProperty, dropGridProperty, dropObjectName, dropProperty, dropTypeAt, durationText, elementFromProperty, fieldFromProperty, fieldInnerLayoutStyle, fieldModel, fieldRules, fieldSpan, fillFromUser, fillPlaceholders, fixedTimeText, formValuesGiven, formatDate, formatDates, fromStorageValue, gridColumnCount, hasBackendCall, hasHeaderTarget, headerButton, inputFormatHint, insertField, isAddonCode, isAddonTestFile, isBrowserSource, isIsoDate, isNativeMobile, isNativePhone, isPropertyDrop, isSignedIn, isTarget, languageDatePattern, layoutPlaceholder, linkAddonModules, linkOfRecord, loadErrorOf, lockHint, lockReason, lockReasons, mappedValues, mediaKind, moveCardElement, moveColumn, moveField, moveSection, moveTreeNode, newButton, newSection, nextZoom, normalizeCard, normalizeCustomKeyboardType, normalizeSections, numberShape, numberStep, numberSuffix, parseAnswer, parseRecords, parseStorageDate, parseTimeText, perUserField, primeDatePattern, proxyFor, rebalanceRow, recordOf, recordsFrom, removeCardElement, removeColumn, removeField, removeHeaderElement, removeSection, removeTreeNode, renewSignIn, replaceCardElement, replaceColumn, replaceField, replaceSection, replaceTreeNode, requestDesignDelete, resizeColumn, resolveAddonPath, resolveCustomKeyboardType, resolvePlaceholder, resolveTemplate, routeOf, ruleMessage, runAddonTests, sampleRecords, sampleValue, sectionPlain, sectionSpan, sectionSticky, sectionTabletSpan, sectionVisible, sendErrorText, sendsForm, setDateLanguage, setInputHintLanguage, setProxyEnvironment, setSignInRenewal, setToolkitKeyboardOnWeb, shapeDateDigits, shapeTimeText, sideDockWidth, splitReference, stagedRead, stagedRequest, storageKeyOf, storageKind, storageValue, storedToTyped, styleParts, termsStamp, termsStorageKey, termsToConfirm, termsUrl, termsUser, testAction, testFieldKey, testFieldPath, testWrites, timeHourFormat, toggleMeridiem, toggleRecord, toolkitKeyboardActive, transformHandler, treeNode, treePaths, typedMeridiem, typedToStored, useDesignerLinks, useDraftSource, userRecord, usesTwelveHours, validTreePath, valueAt, visibleFields, whenOnline, withAppPagination, withUserRecord, withoutMarks, wrapperStyleOf };
4016
+ export type { AddonCheckFinding, AddonFiles, AddonLimits, AddonManifest, AddonTestResult, BackendCall, CallContext, CardDesignerHost, CardDragData, CardDropSpot, CardDropType, CardPlace, ControlKind, CustomKeyboardTarget, CustomKeyboardType, DataSource, DesignAction, DesignDeleteRequest, DesignDevice, DesignEvent, DesignPropertyDrop, DesignTarget, DesignTexts, DesignTranslations, DraftSource, DropSpot, DropType, FieldKind, FieldModel, FieldRules, LockHint, LockReason, LockState, MediaKind, MobileAuthTokens, MobileOktaRefresh, MobileOktaTokens, NumberShape, OidcProvider, OidcRefresh, OidcTokens, PageDataDeps, PdfSource, RenewSignIn, RequestTimeoutMessages, SectionDesignerHost, SectionDragData, SectionKind, SendResult, StagedReadOptions, StorageKind, TermsAcceptance, TermsDialogDocument, TermsSettings, TreeKey, VlDesign };