@wix/public-editor-platform-interfaces 1.37.0 → 1.38.0

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.
@@ -49,7 +49,9 @@ export interface DataItem extends DataItemDataValueOneOf {
49
49
  data?: Data;
50
50
  /** Array of data items. */
51
51
  arrayItems?: ArrayItems;
52
- /** The type of this data item, indicating how to interpret the value. */
52
+ /** Function definition with parameters, return value, and async flag. */
53
+ function?: _Function;
54
+ /** Data type of this item. Uses the app-service `DataTypeEnum.DataType` enum. */
53
55
  dataType?: DataType;
54
56
  }
55
57
  export interface DataItemDataValueOneOf {
@@ -103,85 +105,98 @@ export interface DataItemDataValueOneOf {
103
105
  data?: Data;
104
106
  /** Array of data items. */
105
107
  arrayItems?: ArrayItems;
108
+ /** Function definition with parameters, return value, and async flag. */
109
+ function?: _Function;
106
110
  }
107
111
  export declare enum DataType {
108
- /** Unknown or unspecified data type. */
109
- UNKNOWN_DATA_TYPE = "UNKNOWN_DATA_TYPE",
110
- /** Plain text string. */
111
- TEXT = "TEXT",
112
- /** Text value from a predefined set of options. */
113
- TEXT_ENUM = "TEXT_ENUM",
114
- /** Numeric value (integer or decimal). */
115
- NUMBER = "NUMBER",
116
- /** Boolean true/false value. */
117
- BOOLEAN_VALUE = "BOOLEAN_VALUE",
118
- /** Accessibility-related data. */
119
- A11Y = "A11Y",
120
- /** Hyperlink reference. */
121
- LINK = "LINK",
122
- /** Image reference with metadata. */
123
- IMAGE = "IMAGE",
124
- /** Video reference with metadata. */
125
- VIDEO = "VIDEO",
126
- /** Vector art/SVG reference. */
127
- VECTOR_ART = "VECTOR_ART",
128
- /** Audio file reference. */
129
- AUDIO = "AUDIO",
130
- /** Schema definition (deprecated). */
131
- SCHEMA = "SCHEMA",
132
- /** Date without time component (YYYY-MM-DD). */
133
- LOCAL_DATE = "LOCAL_DATE",
134
- /** Time without date component (HH:MM:SS). */
135
- LOCAL_TIME = "LOCAL_TIME",
136
- /** Combined date and time. */
137
- LOCAL_DATE_TIME = "LOCAL_DATE_TIME",
138
- /** Web URL reference. */
139
- WEB_URL = "WEB_URL",
140
- /** Email address. */
141
- EMAIL = "EMAIL",
142
- /** Phone number. */
143
- PHONE = "PHONE",
144
- /** Hostname/domain name. */
145
- HOSTNAME = "HOSTNAME",
146
- /** Regular expression pattern. */
147
- REGEX = "REGEX",
148
- /** Globally unique identifier. */
149
- GUID = "GUID",
150
- /** Rich text with formatting. */
151
- RICH_TEXT = "RICH_TEXT",
152
- /** Container for nested components. */
153
- CONTAINER = "CONTAINER",
154
- /** Array of items. */
155
- ARRAY_ITEMS = "ARRAY_ITEMS",
156
- /** Text direction (LTR/RTL). */
157
- DIRECTION = "DIRECTION",
158
- /** Menu items collection. */
159
- MENU_ITEMS = "MENU_ITEMS",
160
- /** Nested data structure containing typed values. */
161
- DATA = "DATA"
112
+ UNKNOWN_DataType = "UNKNOWN_DataType",
113
+ /** A simple text value */
114
+ text = "text",
115
+ /** A list of predefined textual values to choose from */
116
+ textEnum = "textEnum",
117
+ /** Any number */
118
+ number = "number",
119
+ /** true / false value */
120
+ booleanValue = "booleanValue",
121
+ /** An object containing the selected A11Y fields chosen */
122
+ a11y = "a11y",
123
+ /** A Wix Link object type */
124
+ link = "link",
125
+ /** A Wix Image object type */
126
+ image = "image",
127
+ /** A Wix Video object type */
128
+ video = "video",
129
+ /** A Wix Sanitized Vector Art object */
130
+ vectorArt = "vectorArt",
131
+ /** A Wix Audio object */
132
+ audio = "audio",
133
+ /** DEPRECATED - use the `data` dataType instead. A [JSON Schema definition](https://json-schema.org/specification) the developer understands in his code (useful for complex props). Some limitation may apply. */
134
+ schema = "schema",
135
+ /** Local date output ISO-8601 extended local date format (YYYY-MM-DD) */
136
+ localDate = "localDate",
137
+ /** Local time output ISO-8601 extended local time format (hh:mm[:ss][.sss]) */
138
+ localTime = "localTime",
139
+ /** Local Date Time output ISO-8601 extended local date-time format (YYYY-MM-DDThh:mm[:ss][.sss]) */
140
+ localDateTime = "localDateTime",
141
+ /** a URL with scheme http or https */
142
+ webUrl = "webUrl",
143
+ /** standard email address according to [RFC 5321, section 4.1.2](https://datatracker.ietf.org/doc/html/rfc5321#section-4.1.2) */
144
+ email = "email",
145
+ /** a validation format designed to match phone numbers with a variety of common characters, including digits (0-9), spaces, parentheses, plus sign, hyphens, and periods */
146
+ phone = "phone",
147
+ /** hostname according to IANA */
148
+ hostname = "hostname",
149
+ /** A valid `regex` pattern supplied by the User */
150
+ regex = "regex",
151
+ /** A unique identifier */
152
+ guid = "guid",
153
+ /** a HTML text with css inline styling */
154
+ richText = "richText",
155
+ /** A container place in the component that will be passed in as {children} or a function prop, depending on the case */
156
+ container = "container",
157
+ /** An array type of data */
158
+ arrayItems = "arrayItems",
159
+ /** selected `direction` for the component according to (HTML `dir` attribute)[https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir] */
160
+ direction = "direction",
161
+ /** A list of menu-items */
162
+ menuItems = "menuItems",
163
+ /** A complex data type that can be used to define a data structure, such as an object or a map */
164
+ data = "data",
165
+ /** A custom function that can be used to call a function from a custom library */
166
+ 'function' = "function",
167
+ /** Standard [onClick handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event), can also handle: `()=>void` */
168
+ onClick = "onClick",
169
+ /** Standard input event [onChange](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event) for text inputs, can also handle: `(value: string) => void` */
170
+ onChange = "onChange",
171
+ /** Standard [onKeyPress handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/keypress_event), can also handle: `(event: KeyboardEvent) => void` */
172
+ onKeyPress = "onKeyPress",
173
+ /** Standard [onKeyUp handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/keyup_event), can also handle: `(event: KeyboardEvent) => void` */
174
+ onKeyUp = "onKeyUp",
175
+ /** Standard [onSubmit handler](https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/submit_event), can also handle: `() => void` */
176
+ onSubmit = "onSubmit"
162
177
  }
163
178
  export interface Text {
164
179
  /**
165
- * The text content.
180
+ * Text content.
166
181
  * @maxLength 50000
167
182
  */
168
183
  value?: string;
169
184
  }
170
185
  export interface RichText {
171
186
  /**
172
- * The text content.
187
+ * Rich text content in HTML format.
173
188
  * @maxLength 50000
174
189
  */
175
190
  text?: string;
176
191
  /**
177
- * Links embedded within the rich text.
192
+ * Links embedded within the rich text content.
178
193
  * @maxSize 1000
179
194
  */
180
195
  linkList?: Link[];
181
196
  }
182
197
  export interface TextEnum {
183
198
  /**
184
- * The selected enum value as a string identifier.
199
+ * Selected enum value as a string identifier.
185
200
  * @maxLength 500
186
201
  */
187
202
  value?: string;
@@ -225,80 +240,80 @@ export interface _Number {
225
240
  }
226
241
  export interface LocalDate {
227
242
  /**
228
- * The date value in YYYY-MM-DD format.
243
+ * Date value in YYYY-MM-DD format.
229
244
  * @format LOCAL_DATE
230
245
  */
231
246
  value?: string;
232
247
  }
233
248
  export interface LocalTime {
234
249
  /**
235
- * The time value in HH:MM:SS format.
250
+ * Time value in HH:MM:SS format.
236
251
  * @format LOCAL_TIME
237
252
  */
238
253
  value?: string;
239
254
  }
240
255
  export interface LocalDateTime {
241
256
  /**
242
- * The date-time value in ISO 8601 format.
257
+ * Date-time value in ISO 8601 format.
243
258
  * @format LOCAL_DATE_TIME
244
259
  */
245
260
  value?: string;
246
261
  }
247
262
  export interface WebUrl {
248
263
  /**
249
- * The web URL.
264
+ * Web URL.
250
265
  * @format WEB_URL
251
266
  */
252
267
  value?: string;
253
268
  }
254
269
  export interface Email {
255
270
  /**
256
- * The email address.
271
+ * Email address.
257
272
  * @format EMAIL
258
273
  */
259
274
  value?: string;
260
275
  }
261
276
  export interface Phone {
262
277
  /**
263
- * The phone number.
278
+ * Phone number.
264
279
  * @format PHONE
265
280
  */
266
281
  value?: string;
267
282
  }
268
283
  export interface Hostname {
269
284
  /**
270
- * The hostname.
285
+ * Hostname.
271
286
  * @format HOSTNAME
272
287
  */
273
288
  value?: string;
274
289
  }
275
290
  export interface Regex {
276
291
  /**
277
- * The regular expression pattern.
292
+ * Regular expression pattern.
278
293
  * @maxLength 5000
279
294
  */
280
295
  value?: string;
281
296
  }
282
297
  export interface Guid {
283
298
  /**
284
- * The GUID value.
299
+ * GUID value.
285
300
  * @format GUID
286
301
  */
287
302
  value?: string;
288
303
  }
289
304
  export interface BooleanValue {
290
- /** The boolean value. */
305
+ /** Boolean value. */
291
306
  value?: boolean;
292
307
  }
293
308
  export interface Container {
294
309
  /**
295
- * The container value.
310
+ * Component ID of the parent container.
296
311
  * @maxLength 1000
297
312
  */
298
313
  value?: string;
299
314
  }
300
315
  export interface Direction {
301
- /** The direction value. */
316
+ /** Direction value. */
302
317
  value?: DirectionValue;
303
318
  }
304
319
  export declare enum DirectionValue {
@@ -322,28 +337,36 @@ export interface ArrayItems {
322
337
  */
323
338
  items?: Data[];
324
339
  }
340
+ export interface _Function {
341
+ /** Ordered list of typed parameter values. */
342
+ parameters?: DataItem[];
343
+ /** Typed return value. */
344
+ returnValue?: DataItem;
345
+ /** Whether the function is asynchronous. */
346
+ isAsync?: boolean | null;
347
+ }
325
348
  export interface MenuItems {
326
349
  /**
327
- * Name of the menu.
350
+ * Menu name.
328
351
  * @maxLength 500
329
352
  */
330
353
  name?: string | null;
331
354
  /**
332
- * App definition ID.
355
+ * ID of the app that owns this menu.
333
356
  * @maxLength 100
334
357
  */
335
- appDefinitionId?: string | null;
358
+ appId?: string | null;
336
359
  /**
337
- * List of menu items.
360
+ * Menu items.
338
361
  * @maxSize 100
339
362
  */
340
363
  items?: MenuItem[];
341
364
  }
342
365
  export interface MenuItem {
343
- /** Link associated with this menu item. */
366
+ /** Link for this menu item. */
344
367
  link?: Link;
345
368
  /**
346
- * Nested menu items (sub-menu).
369
+ * Nested sub-menu items.
347
370
  * @maxSize 100
348
371
  */
349
372
  items?: MenuItem[];
@@ -353,7 +376,7 @@ export interface MenuItem {
353
376
  */
354
377
  container?: string | null;
355
378
  /**
356
- * Display label for the menu item.
379
+ * Display label.
357
380
  * @maxLength 1000
358
381
  */
359
382
  label?: string | null;
@@ -362,7 +385,7 @@ export interface MenuItem {
362
385
  }
363
386
  export interface Video {
364
387
  /**
365
- * Unique identifier for the video media.
388
+ * URI to access the video file.
366
389
  * @maxLength 1000
367
390
  */
368
391
  uri?: string;
@@ -372,45 +395,45 @@ export interface Video {
372
395
  */
373
396
  sources?: VideoSource[];
374
397
  /**
375
- * Sources for adaptive streaming formats.
398
+ * Adaptive streaming sources.
376
399
  * @maxSize 10
377
400
  */
378
401
  adaptiveSources?: AdaptiveSource[];
379
402
  /** Whether the video contains an audio track. */
380
403
  hasAudio?: boolean | null;
381
- /** Frames per second of the video. */
404
+ /** Frames per second. */
382
405
  fps?: number | null;
383
406
  /**
384
- * Poster image reference for the video.
407
+ * Poster image URI displayed before the video plays.
385
408
  * @maxLength 2000
386
409
  */
387
410
  poster?: string | null;
388
- /** Duration of the video in seconds. */
411
+ /** Duration in seconds. */
389
412
  duration?: number | null;
390
413
  /**
391
- * Human-readable name for the video.
414
+ * Display name of the video.
392
415
  * @maxLength 100
393
416
  */
394
417
  name?: string | null;
395
418
  }
396
419
  export interface VideoSource {
397
- /** Quality level of the video source. */
420
+ /** Quality level. */
398
421
  quality?: VideoQuality;
399
- /** Width of the video in pixels. */
422
+ /** Width in pixels. */
400
423
  width?: number | null;
401
- /** Height of the video in pixels. */
424
+ /** Height in pixels. */
402
425
  height?: number | null;
403
426
  /**
404
- * Available format types and their URIs for this quality.
427
+ * Available format types for this quality.
405
428
  * @maxSize 10
406
429
  */
407
430
  types?: VideoSourceType[];
408
431
  }
409
432
  export interface VideoSourceType {
410
- /** Video format type. */
433
+ /** Video format. */
411
434
  format?: VideoFormat;
412
435
  /**
413
- * URI to access the video file.
436
+ * URI to the video file.
414
437
  * @maxLength 2000
415
438
  */
416
439
  uri?: string | null;
@@ -439,7 +462,7 @@ export interface AdaptiveSource {
439
462
  /** Adaptive streaming format. */
440
463
  format?: AdaptiveFormat;
441
464
  /**
442
- * URI to access the stream manifest.
465
+ * URI to the stream manifest.
443
466
  * @maxLength 2000
444
467
  */
445
468
  uri?: string | null;
@@ -454,30 +477,30 @@ export declare enum AdaptiveFormat {
454
477
  }
455
478
  export interface Audio {
456
479
  /**
457
- * URI pointing to the audio resource.
480
+ * URI of the audio resource.
458
481
  * @maxLength 2000
459
482
  */
460
483
  uri?: string;
461
- /** Whether the audio should play automatically. */
484
+ /** Whether the audio plays automatically. */
462
485
  autoPlay?: boolean | null;
463
- /** Whether the audio should loop when finished. */
486
+ /** Whether the audio loops when finished. */
464
487
  loop?: boolean | null;
465
488
  /** Whether the audio player is visible. */
466
489
  visible?: boolean | null;
467
490
  /** Volume level (0-100). */
468
491
  volume?: number | null;
469
492
  /**
470
- * Title of the audio track.
493
+ * Audio track title.
471
494
  * @maxLength 1000
472
495
  */
473
496
  title?: string | null;
474
497
  /**
475
- * Description of the audio.
498
+ * Audio description.
476
499
  * @maxLength 2000
477
500
  */
478
501
  description?: string | null;
479
502
  /**
480
- * Original file name of the audio file.
503
+ * Original file name.
481
504
  * @maxLength 2000
482
505
  */
483
506
  originalFileName?: string | null;
@@ -490,10 +513,10 @@ export interface VectorArt {
490
513
  uri?: string | null;
491
514
  }
492
515
  export interface ComponentData {
493
- /** Component-specific data properties keyed by property name. */
516
+ /** Data properties keyed by property name. Available properties depend on the component type. */
494
517
  properties?: Record<string, DataItem>;
495
518
  /**
496
- * Conditional data overrides that apply when specific conditions are met.
519
+ * Data overrides that apply different property values per repeater item.
497
520
  * @maxSize 100
498
521
  */
499
522
  overrides?: ComponentDataOverride[];
@@ -508,48 +531,63 @@ export interface ComponentDataOverrideComponentOverrideOneOf {
508
531
  }
509
532
  export interface RepeaterOverride {
510
533
  /**
511
- * ID of the variant to use for this repeater override.
534
+ * Repeater item ID.
512
535
  * @maxLength 100
513
536
  */
514
537
  id?: string;
515
- /** Component data properties that are applied for this repeated component instance. */
538
+ /** Data properties to apply for this repeater item. */
516
539
  properties?: Record<string, DataItem>;
517
540
  }
518
541
  export interface ComponentStyle extends ComponentStyleStylePropertiesOneOf {
519
- /** CSS-based styling for new Editor React components. */
542
+ /** CSS-based styling. */
520
543
  css?: CssStyleProperties;
521
- /** Legacy styling for components in studio or classic sites. */
544
+ /** Legacy styling for classic and Studio site components. */
522
545
  legacy?: LegacyStyleProperties;
523
- /** Reference to a theme style (TopLevelStyle). */
546
+ /** Reference to a theme style. Applicable only for components built before the Wix Editor's builder platform. */
524
547
  theme?: ThemeStyleReference;
525
548
  /**
526
- * Conditional style overrides (not applicable for theme references).
549
+ * Type of style applied to the component.
550
+ * @readonly
551
+ */
552
+ styleType?: StyleType;
553
+ /**
554
+ * Conditional style overrides that apply when all specified conditions are met. Not applicable for theme style references.
527
555
  * @maxSize 100
528
556
  */
529
557
  overrides?: ComponentStyleOverride[];
530
558
  }
531
559
  export interface ComponentStyleStylePropertiesOneOf {
532
- /** CSS-based styling for new Editor React components. */
560
+ /** CSS-based styling. */
533
561
  css?: CssStyleProperties;
534
- /** Legacy styling for components in studio or classic sites. */
562
+ /** Legacy styling for classic and Studio site components. */
535
563
  legacy?: LegacyStyleProperties;
536
- /** Reference to a theme style (TopLevelStyle). */
564
+ /** Reference to a theme style. Applicable only for components built before the Wix Editor's builder platform. */
537
565
  theme?: ThemeStyleReference;
538
566
  }
567
+ export declare enum StyleType {
568
+ /** Unknown style type. */
569
+ UNKNOWN_STYLE_TYPE = "UNKNOWN_STYLE_TYPE",
570
+ /** CSS-based styling. */
571
+ CSS = "CSS",
572
+ /** Legacy styling for classic and Studio site components. */
573
+ LEGACY = "LEGACY",
574
+ /** Reference to a theme style. */
575
+ THEME = "THEME"
576
+ }
539
577
  export interface CssStyleProperties {
540
- /** Standard CSS properties (e.g., backgroundColor, borderWidth). */
541
- cssProperties?: Record<string, string>;
542
- /** CSS custom properties/variables (e.g., content-horizontal-alignment). */
543
- cssCustomProperties?: Record<string, string>;
578
+ /** CSS properties keyed by property name. For example, `backgroundColor`, `borderWidth`. */
579
+ properties?: Record<string, string>;
580
+ /** CSS custom properties (variables) keyed by variable name. For example, `--primary-color`, `--spacing-unit`. */
581
+ customProperties?: Record<string, string>;
544
582
  }
545
583
  export interface LegacyStyleProperties {
546
- /** Style properties (e.g., bg, align, $st-css). */
584
+ /** Style properties keyed by property name. For example, `bg`, `align`. */
547
585
  properties?: Record<string, string>;
548
- /** Source of each property (theme or value). */
586
+ /** Source of each property value, indicating whether the value comes from a theme or is explicitly set. */
549
587
  propertiesSource?: Record<string, PropertySource>;
550
- /** Style groups (arbitrary structure). */
588
+ /** Style groups organizing related style properties into logical units such as fills, borders, and shadows. */
551
589
  groups?: Record<string, any> | null;
552
- /** Text theme overrides per property (e.g., fnt). */
590
+ /** Text theme overrides keyed by property name. */
553
591
  propertiesOverride?: Record<string, PartialTextTheme>;
554
592
  }
555
593
  export declare enum PropertySource {
@@ -624,130 +662,144 @@ export interface PartialTextTheme {
624
662
  }
625
663
  export interface ThemeStyleReference {
626
664
  /**
627
- * The theme style ID (e.g., "txtTheme").
665
+ * Theme style ID. For example, `txtTheme`.
628
666
  * @maxLength 100
629
667
  */
630
668
  referenceId?: string;
631
669
  }
632
670
  export interface ComponentStyleOverride extends ComponentStyleOverrideStylePropertiesOneOf {
633
- /** CSS-based override. */
671
+ /** CSS-based style override. */
634
672
  css?: CssStyleProperties;
635
- /**
636
- * Legacy style override.
637
- * @deprecated
638
- * @targetRemovalDate 2040-01-01
639
- */
673
+ /** Legacy style override. */
640
674
  legacy?: LegacyStyleProperties;
641
675
  /**
642
- * Conditions (variant IDs) that must ALL be met.
676
+ * Conditions that must all be met for this override to apply.
643
677
  * @maxSize 100
644
678
  */
645
679
  conditions?: ConditionalTrigger[];
646
680
  }
647
681
  export interface ComponentStyleOverrideStylePropertiesOneOf {
648
- /** CSS-based override. */
682
+ /** CSS-based style override. */
649
683
  css?: CssStyleProperties;
650
- /**
651
- * Legacy style override.
652
- * @deprecated
653
- * @targetRemovalDate 2040-01-01
654
- */
684
+ /** Legacy style override. */
655
685
  legacy?: LegacyStyleProperties;
656
686
  }
657
- /**
658
- * Condition that determines when a style override should be applied.
659
- *
660
- * Supports various UI and interaction-based conditions such as display width breakpoints,
661
- * hover states, and user interactions. All conditions in an override are evaluated
662
- * with AND logic, and apply the override only when all conditions are met.
663
- */
664
687
  export interface ConditionalTrigger {
665
688
  /**
666
- * Unique identifier for the condition.
689
+ * ID of the condition that triggers this override. Examples include responsive breakpoint IDs and interaction states such as hover.
667
690
  * @maxLength 100
668
691
  */
669
692
  conditionId?: string;
670
693
  }
671
- export interface Link extends LinkLinkTypeOneOf {
694
+ export interface Link extends LinkLinkDataOneOf {
695
+ /** Link to a page on the same site. */
672
696
  pageLink?: PageLink;
697
+ /** Link to an external URL. */
673
698
  externalLink?: ExternalLink;
699
+ /** Link that opens an email client. */
674
700
  emailLink?: EmailLink;
701
+ /** Link to an anchor on a page. */
675
702
  anchorLink?: AnchorLink;
703
+ /** Link to a downloadable document. */
676
704
  documentLink?: DocumentLink;
705
+ /** Link that initiates a phone call. */
677
706
  phoneLink?: PhoneLink;
707
+ /** Link to a dynamic page route. */
678
708
  dynamicPageLink?: DynamicPageLink;
709
+ /** Text-based link. */
679
710
  textLink?: TextLink;
711
+ /** Link that opens a login or signup dialog. */
680
712
  loginToWixLink?: LoginToWixLink;
713
+ /** Link that opens WhatsApp. */
681
714
  whatsAppLink?: WhatsAppLink;
715
+ /** Link to a physical address on a map. */
682
716
  addressLink?: AddressLink;
683
- tpaPageLink?: TpaPageLink;
717
+ /** Link to an app page. */
718
+ appPageLink?: AppPageLink;
719
+ /**
720
+ * The type of link.
721
+ * @readonly
722
+ */
723
+ linkType?: LinkType;
684
724
  }
685
- export interface LinkLinkTypeOneOf {
725
+ export interface LinkLinkDataOneOf {
726
+ /** Link to a page on the same site. */
686
727
  pageLink?: PageLink;
728
+ /** Link to an external URL. */
687
729
  externalLink?: ExternalLink;
730
+ /** Link that opens an email client. */
688
731
  emailLink?: EmailLink;
732
+ /** Link to an anchor on a page. */
689
733
  anchorLink?: AnchorLink;
734
+ /** Link to a downloadable document. */
690
735
  documentLink?: DocumentLink;
736
+ /** Link that initiates a phone call. */
691
737
  phoneLink?: PhoneLink;
738
+ /** Link to a dynamic page route. */
692
739
  dynamicPageLink?: DynamicPageLink;
740
+ /** Text-based link. */
693
741
  textLink?: TextLink;
742
+ /** Link that opens a login or signup dialog. */
694
743
  loginToWixLink?: LoginToWixLink;
744
+ /** Link that opens WhatsApp. */
695
745
  whatsAppLink?: WhatsAppLink;
746
+ /** Link to a physical address on a map. */
696
747
  addressLink?: AddressLink;
697
- tpaPageLink?: TpaPageLink;
748
+ /** Link to an app page. */
749
+ appPageLink?: AppPageLink;
698
750
  }
699
751
  export interface PageLink {
700
752
  /**
701
- * ID of the target page within the same document.
753
+ * ID of the target page on the same site.
702
754
  * @maxLength 100
703
755
  */
704
756
  pageId?: string | null;
705
- /** Specifies where to open the linked document. */
757
+ /** Where to open the linked page. */
706
758
  target?: LinkTarget;
707
759
  /** Relationship attributes for the link. */
708
760
  rel?: LinkRel;
709
761
  }
710
762
  export interface ExternalLink {
711
763
  /**
712
- * URL of the external link.
764
+ * External URL.
713
765
  * @maxLength 2000
714
766
  */
715
767
  url?: string;
716
- /** Specifies where to open the linked document. */
768
+ /** Where to open the linked URL. */
717
769
  target?: LinkTarget;
718
770
  /** Relationship attributes for the link. */
719
771
  rel?: LinkRel;
720
772
  }
721
773
  export interface EmailLink {
722
774
  /**
723
- * Email address of the recipient.
775
+ * Recipient's email address.
724
776
  * @maxLength 320
725
777
  */
726
- recipient?: string;
778
+ email?: string;
727
779
  /**
728
- * Subject of the email.
780
+ * Email subject line.
729
781
  * @maxLength 500
730
782
  */
731
783
  subject?: string;
732
784
  /**
733
- * Body or content of the email.
785
+ * Email body text.
734
786
  * @maxLength 5000
735
787
  */
736
788
  body?: string;
737
789
  }
738
790
  export interface AnchorLink {
739
791
  /**
740
- * Name of the anchor.
792
+ * Display name of the anchor.
741
793
  * @maxLength 200
742
794
  */
743
- anchorName?: string;
795
+ name?: string;
744
796
  /**
745
- * ID of the anchor data or "SCROLL_TO_TOP".
797
+ * ID of the anchor element on the page. Use `SCROLL_TO_TOP` instead of an element ID to scroll to the top of the page.
746
798
  * @maxLength 100
747
799
  */
748
- anchorDataId?: string | null;
800
+ dataId?: string | null;
749
801
  /**
750
- * ID of the target page.
802
+ * ID of the page containing the anchor.
751
803
  * @maxLength 100
752
804
  */
753
805
  pageId?: string | null;
@@ -756,16 +808,16 @@ export interface AnchorLink {
756
808
  }
757
809
  export interface DocumentLink {
758
810
  /**
759
- * ID of the document.
811
+ * Document ID.
760
812
  * @maxLength 100
761
813
  */
762
- docId?: string;
814
+ documentId?: string;
763
815
  /**
764
- * Name of the document.
816
+ * Document name.
765
817
  * @maxLength 500
766
818
  */
767
819
  name?: string;
768
- /** Whether the document is indexable. */
820
+ /** Whether the document is indexable by search engines. */
769
821
  indexable?: boolean;
770
822
  }
771
823
  export interface PhoneLink {
@@ -773,92 +825,87 @@ export interface PhoneLink {
773
825
  * Phone number to call.
774
826
  * @maxLength 100
775
827
  */
776
- phoneNumber?: string;
828
+ phone?: string;
777
829
  }
778
830
  export interface DynamicPageLink {
779
831
  /**
780
- * ID of the router.
832
+ * Router ID.
781
833
  * @maxLength 100
782
834
  */
783
835
  routerId?: string;
784
836
  /**
785
- * Inner route path.
837
+ * Inner route path within the router.
786
838
  * @maxLength 500
787
839
  */
788
840
  innerRoute?: string;
789
841
  /**
790
- * ID of the anchor data.
842
+ * Anchor data ID.
791
843
  * @maxLength 100
792
844
  */
793
845
  anchorDataId?: string | null;
794
- /** Whether this is a TPA route. */
795
- tpaRoute?: boolean;
796
- /** Specifies where to open the linked document. */
846
+ /** Whether this is an app route. */
847
+ appRoute?: boolean;
848
+ /** Where to open the linked page. */
797
849
  target?: LinkTarget;
798
850
  /** Relationship attributes for the link. */
799
851
  rel?: LinkRel;
800
852
  }
801
853
  export interface TextLink {
802
- /** Type of the text link. */
803
- linkType?: LinkType;
854
+ /** Text link type. */
855
+ textLinkType?: TextLinkType;
804
856
  /**
805
- * URL or destination of the link.
857
+ * Link destination URL.
806
858
  * @maxLength 2000
807
859
  */
808
860
  href?: string;
809
861
  /**
810
- * Display text for the link.
862
+ * Display text.
811
863
  * @maxLength 1200
812
864
  */
813
865
  text?: string;
814
866
  /**
815
- * Target attribute for the link.
867
+ * Link target attribute. For example, `_blank` to open in a new tab.
816
868
  * @maxLength 50
817
869
  */
818
870
  target?: string;
819
- /**
820
- * Icon identifier for the link.
821
- * @maxLength 200
822
- */
823
- icon?: string;
824
871
  }
825
872
  export interface LoginToWixLink {
826
873
  /**
827
- * URL to redirect after login.
874
+ * URL to redirect to after login.
828
875
  * @maxLength 2000
829
876
  */
830
877
  postLoginUrl?: string;
831
878
  /**
832
- * URL to redirect after signup.
879
+ * URL to redirect to after signup.
833
880
  * @maxLength 2000
834
881
  */
835
882
  postSignupUrl?: string;
836
- /** Type of login dialog to show. */
883
+ /** Type of dialog to show. */
837
884
  dialog?: LoginDialog;
838
- /** Whether to send email notification. */
839
- sendMail?: boolean;
885
+ /** Whether to send an email notification after login or signup. */
886
+ emailNotificationEnabled?: boolean;
840
887
  /**
841
- * Mail template identifier.
888
+ * Email template identifier.
842
889
  * @maxLength 500
843
890
  */
844
- mailTemplate?: string;
891
+ emailTemplate?: string;
845
892
  /**
846
- * User color preference.
893
+ * Accent color for the login or signup dialog, used to style buttons and highlights. For example, `#3899EC`.
847
894
  * @maxLength 50
848
895
  */
849
- userColor?: string;
896
+ loginDialogAccentColor?: string;
850
897
  /**
851
- * Login component name.
898
+ * Name of the login component that triggered this link. Used for analytics and tracking purposes.
852
899
  * @maxLength 200
853
900
  */
854
- loginCompName?: string;
901
+ loginComponentName?: string;
855
902
  }
856
903
  export interface WhatsAppLink {
857
904
  /**
858
905
  * WhatsApp phone number.
859
906
  * @maxLength 100
860
907
  */
861
- phoneNumber?: string;
908
+ phone?: string;
862
909
  }
863
910
  export interface AddressLink {
864
911
  /**
@@ -867,39 +914,39 @@ export interface AddressLink {
867
914
  */
868
915
  address?: string;
869
916
  }
870
- export interface TpaPageLink {
917
+ export interface AppPageLink {
871
918
  /**
872
- * Type identifier of the item.
919
+ * Item type identifier.
873
920
  * @maxLength 200
874
921
  */
875
922
  itemTypeIdentifier?: string;
876
923
  /**
877
- * ID of the item.
924
+ * Item ID.
878
925
  * @maxLength 100
879
926
  */
880
927
  itemId?: string;
881
928
  /**
882
- * ID of the target page.
929
+ * Target page ID.
883
930
  * @maxLength 100
884
931
  */
885
932
  pageId?: string | null;
886
933
  /**
887
- * App definition ID.
934
+ * App ID.
888
935
  * @maxLength 100
889
936
  */
890
- appDefinitionId?: string;
937
+ appId?: string;
891
938
  /**
892
- * Path within the TPA page.
939
+ * Path within the app page.
893
940
  * @maxLength 500
894
941
  */
895
942
  path?: string;
896
- /** Specifies where to open the linked document. */
943
+ /** Where to open the linked page. */
897
944
  target?: LinkTarget;
898
945
  /** Relationship attributes for the link. */
899
946
  rel?: LinkRel;
900
947
  }
901
948
  export declare enum LinkTarget {
902
- UNSPECIFIED = "UNSPECIFIED",
949
+ UNKNOWN_LINK_TARGET = "UNKNOWN_LINK_TARGET",
903
950
  /** Opens the linked document in the same frame as it was clicked (default). */
904
951
  SELF = "SELF",
905
952
  /** Opens the linked document in a new window or tab. */
@@ -913,7 +960,7 @@ export interface LinkRel {
913
960
  items?: LinkRelEnumLinkRel[];
914
961
  }
915
962
  export declare enum LinkRelEnumLinkRel {
916
- UNSPECIFIED = "UNSPECIFIED",
963
+ UNKNOWN_LINK_REL = "UNKNOWN_LINK_REL",
917
964
  /** Instructs search engines not to follow the link. */
918
965
  NOFOLLOW = "NOFOLLOW",
919
966
  /** Prevents the new page from being able to access the window.opener property. */
@@ -924,118 +971,163 @@ export declare enum LinkRelEnumLinkRel {
924
971
  SPONSORED = "SPONSORED"
925
972
  }
926
973
  export declare enum LinkType {
927
- UNSPECIFIED = "UNSPECIFIED",
974
+ /** Unknown link type. */
975
+ UNKNOWN_LINK_TYPE = "UNKNOWN_LINK_TYPE",
976
+ /** Link to a page on the same site. */
977
+ PAGE_LINK = "PAGE_LINK",
978
+ /** Link to an external URL. */
979
+ EXTERNAL_LINK = "EXTERNAL_LINK",
980
+ /** Link that opens an email client. */
981
+ EMAIL_LINK = "EMAIL_LINK",
982
+ /** Link to an anchor on a page. */
983
+ ANCHOR_LINK = "ANCHOR_LINK",
984
+ /** Link to a downloadable document. */
985
+ DOCUMENT_LINK = "DOCUMENT_LINK",
986
+ /** Link that initiates a phone call. */
987
+ PHONE_LINK = "PHONE_LINK",
988
+ /** Link to a dynamic page route. */
989
+ DYNAMIC_PAGE_LINK = "DYNAMIC_PAGE_LINK",
990
+ /** Text-based link. */
991
+ TEXT_LINK = "TEXT_LINK",
992
+ /** Link that opens a login or signup dialog. */
993
+ LOGIN_TO_WIX_LINK = "LOGIN_TO_WIX_LINK",
994
+ /** Link that opens WhatsApp. */
995
+ WHATS_APP_LINK = "WHATS_APP_LINK",
996
+ /** Link to a physical address on a map. */
997
+ ADDRESS_LINK = "ADDRESS_LINK",
998
+ /** Link to an app page. */
999
+ APP_PAGE_LINK = "APP_PAGE_LINK"
1000
+ }
1001
+ export declare enum TextLinkType {
1002
+ /** Unknown text link type. */
1003
+ UNKNOWN_TEXT_LINK_TYPE = "UNKNOWN_TEXT_LINK_TYPE",
1004
+ /** SMS message link. */
928
1005
  SMS = "SMS",
1006
+ /** Phone call link. */
929
1007
  CALL = "CALL",
1008
+ /** Skype link. */
930
1009
  SKYPE = "SKYPE",
1010
+ /** Map link. */
931
1011
  MAP = "MAP",
1012
+ /** Email link. */
932
1013
  EMAIL = "EMAIL",
1014
+ /** Facebook link. */
933
1015
  FACEBOOK = "FACEBOOK",
1016
+ /** Flickr link. */
934
1017
  FLICKR = "FLICKR",
935
- BLOGGER = "BLOGGER",
936
- MYSPACE = "MYSPACE",
1018
+ /** LinkedIn link. */
937
1019
  LINKEDIN = "LINKEDIN",
1020
+ /** Twitter link. */
938
1021
  TWITTER = "TWITTER",
1022
+ /** Tumblr link. */
939
1023
  TUMBLR = "TUMBLR",
1024
+ /** YouTube link. */
940
1025
  YOUTUBE = "YOUTUBE",
1026
+ /** Vimeo link. */
941
1027
  VIMEO = "VIMEO",
1028
+ /** Internal page link. */
942
1029
  PAGE = "PAGE",
943
- /** Default value. */
1030
+ /** Custom URL link. */
944
1031
  FREE_LINK = "FREE_LINK",
1032
+ /** Text link. */
945
1033
  TEXT = "TEXT",
946
- DELICIOUS = "DELICIOUS",
1034
+ /** External website link. */
947
1035
  WEBSITE = "WEBSITE",
1036
+ /** Document link. */
948
1037
  DOCUMENT = "DOCUMENT",
1038
+ /** Admin login link. */
949
1039
  ADMIN_LOGIN = "ADMIN_LOGIN",
1040
+ /** Login link. */
950
1041
  LOGIN = "LOGIN"
951
1042
  }
952
1043
  export declare enum LoginDialog {
953
- UNSPECIFIED = "UNSPECIFIED",
954
- /** Show create user dialog. */
1044
+ /** Unknown login dialog type. */
1045
+ UNKNOWN_LOGIN_DIALOG = "UNKNOWN_LOGIN_DIALOG",
1046
+ /** Shows the signup registration form directly. */
955
1047
  CREATE_USER = "CREATE_USER",
956
- /** Show login dialog (default). */
1048
+ /** Shows a login-only dialog without a signup option. This is the default value. */
957
1049
  LOGIN = "LOGIN",
958
- /** Show login dialog. */
959
- SHOW_LOGIN = "SHOW_LOGIN"
1050
+ /** Shows a login dialog that also includes an option to switch to signup. */
1051
+ LOGIN_WITH_SIGNUP = "LOGIN_WITH_SIGNUP"
960
1052
  }
961
1053
  export interface A11y {
962
- /** Number attributes */
1054
+ /** Value of the `tabindex` attribute. */
963
1055
  tabIndex?: number | null;
964
- /** The value used for aria-level (1 to 6). */
1056
+ /** Value of the `aria-level` attribute. */
965
1057
  ariaLevel?: number | null;
966
- /** Boolean attributes */
1058
+ /** Value of the `aria-expanded` attribute. */
967
1059
  ariaExpanded?: boolean | null;
968
- /** The value used for aria-disabled. */
1060
+ /** Value of the `aria-disabled` attribute. */
969
1061
  ariaDisabled?: boolean | null;
970
- /** The value used for aria-atomic. */
1062
+ /** Value of the `aria-atomic` attribute. */
971
1063
  ariaAtomic?: boolean | null;
972
- /** The value used for aria-hidden. */
1064
+ /** Value of the `aria-hidden` attribute. */
973
1065
  ariaHidden?: boolean | null;
974
- /** The value used for aria-busy. */
1066
+ /** Value of the `aria-busy` attribute. */
975
1067
  ariaBusy?: boolean | null;
976
- /** Indicates if should add Multiline instructions to aria-label. */
977
- multiline?: boolean | null;
978
- /** Indicates if should add Autocomplete instructions to aria-label. */
979
- ariaAutocomplete?: boolean | null;
980
- /** The value used for aria-multiline. */
1068
+ /** Whether to include multiline instructions in the `aria-label`. Not the same as the standard `aria-multiline` attribute (see field 10). */
1069
+ includeMultilineInstructions?: boolean | null;
1070
+ /** Whether to include autocomplete instructions in the `aria-label`. Not the same as the standard `aria-autocomplete` attribute, which accepts string values. */
1071
+ includeAutocompleteInstructions?: boolean | null;
1072
+ /** Value of the `aria-multiline` attribute. */
981
1073
  ariaMultiline?: boolean | null;
982
- /** Enum attributes */
1074
+ /** Value of the `aria-pressed` attribute. */
983
1075
  ariaPressed?: AriaPressed;
984
- /** The value used for aria-haspopup (true, false, dialog, menu). */
1076
+ /** Value of the `aria-haspopup` attribute. */
985
1077
  ariaHaspopup?: AriaHaspopup;
986
- /** The value used for aria-relevant (additions, additions text, all, removals, text). */
1078
+ /** Value of the `aria-relevant` attribute. */
987
1079
  ariaRelevant?: AriaRelevant;
988
- /** The value used for role attribute. */
1080
+ /** Value of the `role` attribute. */
989
1081
  role?: AriaRole;
990
- /** The value used for aria-live (polite, assertive). */
1082
+ /** Value of the `aria-live` attribute. */
991
1083
  ariaLive?: AriaLive;
992
- /** The value used for aria-current (page, step, location, date, time, true, false). */
1084
+ /** Value of the `aria-current` attribute. */
993
1085
  ariaCurrent?: AriaCurrent;
994
- /** The value used for aria-invalid (grammar, spelling, false, true). */
1086
+ /** Value of the `aria-invalid` attribute. */
995
1087
  ariaInvalid?: AriaInvalid;
996
1088
  /**
997
- * Free text string attributes
1089
+ * Value of the `aria-label` attribute.
998
1090
  * @maxLength 1000
999
1091
  */
1000
1092
  ariaLabel?: string | null;
1001
1093
  /**
1002
- * The text used for aria-roledescription.
1094
+ * Value of the `aria-roledescription` attribute.
1003
1095
  * @maxLength 1000
1004
1096
  */
1005
1097
  ariaRoledescription?: string | null;
1006
1098
  /**
1007
- * The value used for aria-describedby.
1099
+ * Value of the `aria-describedby` attribute.
1008
1100
  * @maxLength 1000
1009
1101
  */
1010
1102
  ariaDescribedby?: string | null;
1011
1103
  /**
1012
- * The value used for aria-labelledby.
1104
+ * Value of the `aria-labelledby` attribute.
1013
1105
  * @maxLength 1000
1014
1106
  */
1015
1107
  ariaLabelledby?: string | null;
1016
1108
  /**
1017
- * The text used for aria-errormessage.
1109
+ * Value of the `aria-errormessage` attribute.
1018
1110
  * @maxLength 1000
1019
1111
  */
1020
1112
  ariaErrormessage?: string | null;
1021
1113
  /**
1022
- * The text used for aria-owns.
1114
+ * Value of the `aria-owns` attribute.
1023
1115
  * @maxLength 1000
1024
1116
  */
1025
1117
  ariaOwns?: string | null;
1026
1118
  /**
1027
- * The text used for aria-controls.
1119
+ * Value of the `aria-controls` attribute.
1028
1120
  * @maxLength 1000
1029
1121
  */
1030
1122
  ariaControls?: string | null;
1031
1123
  /**
1032
- * The HTML tag to use for the element.
1124
+ * HTML tag to render the element with. For example, `h1`, `section`.
1033
1125
  * @maxLength 1000
1034
1126
  */
1035
1127
  tag?: string | null;
1036
1128
  }
1037
1129
  export declare enum AriaPressed {
1038
- UNSPECIFIED = "UNSPECIFIED",
1130
+ UNKNOWN_ARIA_PRESSED = "UNKNOWN_ARIA_PRESSED",
1039
1131
  /** The element is not pressed. */
1040
1132
  FALSE = "FALSE",
1041
1133
  /** The element is pressed. */
@@ -1044,7 +1136,7 @@ export declare enum AriaPressed {
1044
1136
  MIXED = "MIXED"
1045
1137
  }
1046
1138
  export declare enum AriaHaspopup {
1047
- UNSPECIFIED = "UNSPECIFIED",
1139
+ UNKNOWN_ARIA_HASPOPUP = "UNKNOWN_ARIA_HASPOPUP",
1048
1140
  /** The element has a popup. */
1049
1141
  TRUE = "TRUE",
1050
1142
  /** The element does not have a popup. */
@@ -1055,7 +1147,7 @@ export declare enum AriaHaspopup {
1055
1147
  MENU = "MENU"
1056
1148
  }
1057
1149
  export declare enum AriaRelevant {
1058
- UNSPECIFIED = "UNSPECIFIED",
1150
+ UNKNOWN_ARIA_RELEVANT = "UNKNOWN_ARIA_RELEVANT",
1059
1151
  /** Element nodes added to the accessibility tree. */
1060
1152
  ADDITIONS = "ADDITIONS",
1061
1153
  /** Both additions and text changes. */
@@ -1068,7 +1160,7 @@ export declare enum AriaRelevant {
1068
1160
  TEXT = "TEXT"
1069
1161
  }
1070
1162
  export declare enum AriaRole {
1071
- UNSPECIFIED = "UNSPECIFIED",
1163
+ UNKNOWN_ARIA_ROLE = "UNKNOWN_ARIA_ROLE",
1072
1164
  REGION = "REGION",
1073
1165
  GROUP = "GROUP",
1074
1166
  TABLIST = "TABLIST",
@@ -1088,14 +1180,14 @@ export declare enum AriaRole {
1088
1180
  NAV = "NAV"
1089
1181
  }
1090
1182
  export declare enum AriaLive {
1091
- UNSPECIFIED = "UNSPECIFIED",
1183
+ UNKNOWN_ARIA_LIVE = "UNKNOWN_ARIA_LIVE",
1092
1184
  /** Updates are announced when the user is idle. */
1093
1185
  POLITE = "POLITE",
1094
1186
  /** Updates are announced immediately. */
1095
1187
  ASSERTIVE = "ASSERTIVE"
1096
1188
  }
1097
1189
  export declare enum AriaCurrent {
1098
- UNSPECIFIED = "UNSPECIFIED",
1190
+ UNKNOWN_ARIA_CURRENT = "UNKNOWN_ARIA_CURRENT",
1099
1191
  /** Represents the current page within a set of pages. */
1100
1192
  PAGE = "PAGE",
1101
1193
  /** Represents the current step within a process. */
@@ -1112,7 +1204,7 @@ export declare enum AriaCurrent {
1112
1204
  FALSE = "FALSE"
1113
1205
  }
1114
1206
  export declare enum AriaInvalid {
1115
- UNSPECIFIED = "UNSPECIFIED",
1207
+ UNKNOWN_ARIA_INVALID = "UNKNOWN_ARIA_INVALID",
1116
1208
  /** A grammatical error was detected. */
1117
1209
  GRAMMAR = "GRAMMAR",
1118
1210
  /** A spelling error was detected. */