@emabuild/types 0.4.0 → 0.7.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.
@@ -0,0 +1,1830 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "https://unpkg.com/@emabuild/types/schema/mail-editor-config.schema.json",
4
+ "title": "Emabuild editor configuration",
5
+ "description": "Options for the <mail-editor> web component (config-url / config attribute / loadConfig()).",
6
+ "$ref": "#/definitions/MailEditorConfig",
7
+ "definitions": {
8
+ "MailEditorConfig": {
9
+ "type": "object",
10
+ "properties": {
11
+ "$schema": {
12
+ "type": "string",
13
+ "description": "JSON Schema reference (ignored by the editor)"
14
+ },
15
+ "displayMode": {
16
+ "$ref": "#/definitions/DisplayMode"
17
+ },
18
+ "projectId": {
19
+ "type": "number"
20
+ },
21
+ "locale": {
22
+ "type": "string"
23
+ },
24
+ "appearance": {
25
+ "$ref": "#/definitions/AppearanceConfig"
26
+ },
27
+ "tools": {
28
+ "type": "object",
29
+ "additionalProperties": {
30
+ "$ref": "#/definitions/ToolConfig"
31
+ },
32
+ "description": "Per-tool configuration (legacy-compatible): enabled, usageLimit, position, property defaults"
33
+ },
34
+ "allowedTools": {
35
+ "type": "array",
36
+ "items": {
37
+ "type": "string"
38
+ },
39
+ "description": "Whitelist: when set, ONLY these tools appear (e.g. ['text','image','button'])"
40
+ },
41
+ "disabledTools": {
42
+ "type": "array",
43
+ "items": {
44
+ "type": "string"
45
+ },
46
+ "description": "Blacklist: these tools never appear (applied after the whitelist)"
47
+ },
48
+ "blocks": {
49
+ "type": "array",
50
+ "items": {
51
+ "$ref": "#/definitions/SavedBlock"
52
+ }
53
+ },
54
+ "fonts": {
55
+ "$ref": "#/definitions/FontConfig"
56
+ },
57
+ "mergeTags": {
58
+ "anyOf": [
59
+ {
60
+ "type": "array",
61
+ "items": {
62
+ "$ref": "#/definitions/MergeTagGroup"
63
+ }
64
+ },
65
+ {
66
+ "type": "array",
67
+ "items": {
68
+ "$ref": "#/definitions/MergeTagDefinition"
69
+ }
70
+ }
71
+ ]
72
+ },
73
+ "designTags": {
74
+ "type": "object",
75
+ "additionalProperties": {
76
+ "type": "string"
77
+ }
78
+ },
79
+ "designTagsConfig": {
80
+ "type": "object",
81
+ "additionalProperties": {
82
+ "$ref": "#/definitions/DesignTagConfig"
83
+ }
84
+ },
85
+ "customCSS": {
86
+ "anyOf": [
87
+ {
88
+ "type": "string"
89
+ },
90
+ {
91
+ "type": "array",
92
+ "items": {
93
+ "type": "string"
94
+ }
95
+ }
96
+ ]
97
+ },
98
+ "customJS": {
99
+ "anyOf": [
100
+ {
101
+ "type": "string"
102
+ },
103
+ {
104
+ "type": "array",
105
+ "items": {
106
+ "type": "string"
107
+ }
108
+ }
109
+ ]
110
+ },
111
+ "tabs": {
112
+ "$ref": "#/definitions/TabConfig"
113
+ },
114
+ "editor": {
115
+ "$ref": "#/definitions/EditorBehaviorConfig"
116
+ },
117
+ "features": {
118
+ "$ref": "#/definitions/FeaturesConfig"
119
+ },
120
+ "design": {
121
+ "$ref": "#/definitions/EmailDesign"
122
+ },
123
+ "ai": {
124
+ "$ref": "#/definitions/AIConfig",
125
+ "description": "AI connector: generate/edit templates from a prompt + business context"
126
+ },
127
+ "linkTypes": {
128
+ "type": "array",
129
+ "items": {
130
+ "$ref": "#/definitions/LinkTypeConfig"
131
+ },
132
+ "description": "Custom link types for the link widget (legacy-compatible)"
133
+ },
134
+ "specialLinks": {
135
+ "type": "array",
136
+ "items": {
137
+ "$ref": "#/definitions/SpecialLink"
138
+ },
139
+ "description": "Special links (unsubscribe, view online…), optionally nested in groups"
140
+ },
141
+ "title": {
142
+ "type": "string",
143
+ "description": "Exported document <title> (empty when not set)"
144
+ },
145
+ "translations": {
146
+ "type": "object",
147
+ "additionalProperties": {
148
+ "type": "object",
149
+ "additionalProperties": {
150
+ "type": "string"
151
+ }
152
+ },
153
+ "description": "UI string overrides, keyed by locale then by message key"
154
+ },
155
+ "colorPicker": {
156
+ "$ref": "#/definitions/ColorPickerConfig",
157
+ "description": "Brand color swatches shown above the native color picker (alias of `features.colorPicker`)"
158
+ },
159
+ "columns": {
160
+ "$ref": "#/definitions/ColumnsConfig",
161
+ "description": "Row layouts offered in the sidebar \"Rows\" section and the canvas quick-add menu"
162
+ },
163
+ "mergeTagsConfig": {
164
+ "$ref": "#/definitions/MergeTagsConfig",
165
+ "description": "Merge tag menu behavior (`mergeTagsConfig`)"
166
+ },
167
+ "brand": {
168
+ "$ref": "#/definitions/BrandKit",
169
+ "description": "Brand kit: colors, fonts, logo and button/heading styles. Becomes the default of new blocks, the first color swatches, a \"Logo\" block, the AI brand context and the \"Apply brand\" action of the Body tab."
170
+ }
171
+ },
172
+ "additionalProperties": false
173
+ },
174
+ "DisplayMode": {
175
+ "type": "string",
176
+ "enum": [
177
+ "email",
178
+ "web",
179
+ "popup"
180
+ ]
181
+ },
182
+ "AppearanceConfig": {
183
+ "type": "object",
184
+ "properties": {
185
+ "theme": {
186
+ "anyOf": [
187
+ {
188
+ "type": "string"
189
+ },
190
+ {
191
+ "type": "string",
192
+ "enum": [
193
+ "light",
194
+ "dark"
195
+ ]
196
+ }
197
+ ],
198
+ "description": "'light' (default) | 'dark'"
199
+ },
200
+ "variant": {
201
+ "type": "string",
202
+ "enum": [
203
+ "classic",
204
+ "glass"
205
+ ],
206
+ "description": "'classic' (default) | 'glass': floating frosted panels over a soft backdrop (works with both themes)"
207
+ },
208
+ "layout": {
209
+ "type": "string",
210
+ "enum": [
211
+ "auto",
212
+ "desktop",
213
+ "mobile"
214
+ ],
215
+ "description": "'auto' (default): the compact touch layout (full-screen canvas, floating bottom bar, bottom sheets) when the editor is narrower than `compactBreakpoint`; 'desktop' / 'mobile' force one layout."
216
+ },
217
+ "compactBreakpoint": {
218
+ "type": "number",
219
+ "description": "Editor width (px) below which `layout: 'auto'` goes compact (default 720)"
220
+ },
221
+ "panels": {
222
+ "type": "object",
223
+ "properties": {
224
+ "tools": {
225
+ "type": "object",
226
+ "properties": {
227
+ "dock": {
228
+ "type": "string",
229
+ "enum": [
230
+ "left",
231
+ "right"
232
+ ]
233
+ },
234
+ "collapsible": {
235
+ "type": "boolean"
236
+ },
237
+ "layout": {
238
+ "type": "string",
239
+ "enum": [
240
+ "tabs",
241
+ "rail"
242
+ ]
243
+ }
244
+ },
245
+ "additionalProperties": false,
246
+ "description": "layout 'rail' = icon bar + flyout panel (default with variant 'glass'), 'tabs' = classic header tabs"
247
+ }
248
+ },
249
+ "additionalProperties": false
250
+ },
251
+ "loader": {
252
+ "type": "object",
253
+ "properties": {
254
+ "url": {
255
+ "type": "string"
256
+ },
257
+ "html": {
258
+ "type": "string"
259
+ },
260
+ "css": {
261
+ "type": "string"
262
+ }
263
+ },
264
+ "additionalProperties": false,
265
+ "description": "Custom loading indicator: an image `url`, or `html` + `css` (`appearance.loader`)"
266
+ },
267
+ "colors": {
268
+ "$ref": "#/definitions/AppearanceColors",
269
+ "description": "Editor UI colors (any CSS color). Applied on top of the theme/variant preset, so a host can match its own brand: `{ primary: '#e11d48', panel: '#fff' }`."
270
+ },
271
+ "radius": {
272
+ "type": [
273
+ "number",
274
+ "string"
275
+ ],
276
+ "description": "Corner radius of controls, e.g. 6 or '6px'"
277
+ },
278
+ "fontFamily": {
279
+ "type": "string",
280
+ "description": "Font stack of the editor UI (not of the email)"
281
+ },
282
+ "cssVars": {
283
+ "type": "object",
284
+ "additionalProperties": {
285
+ "type": "string"
286
+ },
287
+ "description": "Any other `--me-*` design token, e.g. `{ 'sheet-radius': '0px' }` or `{ '--me-surface-radius': '12px' }`"
288
+ }
289
+ },
290
+ "additionalProperties": false
291
+ },
292
+ "AppearanceColors": {
293
+ "type": "object",
294
+ "properties": {
295
+ "primary": {
296
+ "type": "string",
297
+ "description": "Accent: selection outlines, active tabs, buttons, focus (tints are derived)"
298
+ },
299
+ "backdrop": {
300
+ "type": "string",
301
+ "description": "Page behind the panels (glass variant; gradients allowed)"
302
+ },
303
+ "canvas": {
304
+ "type": "string",
305
+ "description": "Area around the email sheet"
306
+ },
307
+ "panel": {
308
+ "type": "string",
309
+ "description": "Sidebar and property panel background"
310
+ },
311
+ "input": {
312
+ "type": "string",
313
+ "description": "Inputs and selects"
314
+ },
315
+ "text": {
316
+ "type": "string",
317
+ "description": "Main text"
318
+ },
319
+ "textMuted": {
320
+ "type": "string",
321
+ "description": "Secondary text, labels, icons"
322
+ },
323
+ "border": {
324
+ "type": "string",
325
+ "description": "Borders and dividers"
326
+ },
327
+ "hover": {
328
+ "type": "string",
329
+ "description": "Hover / subtle fill"
330
+ },
331
+ "toolbar": {
332
+ "type": "string",
333
+ "description": "Floating canvas toolbars"
334
+ },
335
+ "danger": {
336
+ "type": "string"
337
+ },
338
+ "warning": {
339
+ "type": "string"
340
+ },
341
+ "success": {
342
+ "type": "string"
343
+ }
344
+ },
345
+ "additionalProperties": false,
346
+ "description": "Brandable color tokens of the editor UI"
347
+ },
348
+ "ToolConfig": {
349
+ "type": "object",
350
+ "properties": {
351
+ "enabled": {
352
+ "type": "boolean"
353
+ },
354
+ "usageLimit": {
355
+ "type": "number"
356
+ },
357
+ "position": {
358
+ "type": "number"
359
+ },
360
+ "properties": {
361
+ "type": "object",
362
+ "additionalProperties": {
363
+ "$ref": "#/definitions/ToolPropertyOverride"
364
+ }
365
+ }
366
+ },
367
+ "additionalProperties": false
368
+ },
369
+ "ToolPropertyOverride": {
370
+ "type": "object",
371
+ "properties": {
372
+ "value": {},
373
+ "hidden": {
374
+ "type": "boolean",
375
+ "description": "Hide this property editor in the panel"
376
+ },
377
+ "editor": {
378
+ "type": "object",
379
+ "properties": {
380
+ "data": {
381
+ "type": "object",
382
+ "additionalProperties": {}
383
+ }
384
+ },
385
+ "additionalProperties": false
386
+ }
387
+ },
388
+ "additionalProperties": false
389
+ },
390
+ "SavedBlock": {
391
+ "type": "object",
392
+ "properties": {
393
+ "id": {
394
+ "type": "string"
395
+ },
396
+ "name": {
397
+ "type": "string"
398
+ },
399
+ "category": {
400
+ "type": "string"
401
+ },
402
+ "tags": {
403
+ "type": "array",
404
+ "items": {
405
+ "type": "string"
406
+ }
407
+ },
408
+ "data": {},
409
+ "displayMode": {
410
+ "$ref": "#/definitions/DisplayMode"
411
+ },
412
+ "synced": {
413
+ "type": "boolean",
414
+ "description": "Synced block: rows inserted from it stay linked (`row.values.synced`). Editing any instance updates the block and all other instances, and emits `block:updated` so the host can persist it."
415
+ }
416
+ },
417
+ "required": [
418
+ "id",
419
+ "name",
420
+ "data"
421
+ ],
422
+ "additionalProperties": false
423
+ },
424
+ "FontConfig": {
425
+ "type": "object",
426
+ "properties": {
427
+ "showDefaultFonts": {
428
+ "type": "boolean",
429
+ "description": "Show the built-in email-safe + Google fonts (default true)"
430
+ },
431
+ "customFonts": {
432
+ "type": "array",
433
+ "items": {
434
+ "$ref": "#/definitions/FontFamily"
435
+ },
436
+ "description": "Extra fonts; `url` (a CSS stylesheet, e.g. Google Fonts) is loaded in the editor and the export"
437
+ },
438
+ "allowed": {
439
+ "type": "array",
440
+ "items": {
441
+ "type": "string"
442
+ },
443
+ "description": "Whitelist of fonts by label or value (case-insensitive). When set, only these appear"
444
+ },
445
+ "disabled": {
446
+ "type": "array",
447
+ "items": {
448
+ "type": "string"
449
+ },
450
+ "description": "Blacklist of fonts by label or value (case-insensitive)"
451
+ }
452
+ },
453
+ "additionalProperties": false
454
+ },
455
+ "FontFamily": {
456
+ "type": "object",
457
+ "properties": {
458
+ "label": {
459
+ "type": "string"
460
+ },
461
+ "value": {
462
+ "type": "string"
463
+ },
464
+ "url": {
465
+ "type": "string"
466
+ },
467
+ "weights": {
468
+ "type": "array",
469
+ "items": {
470
+ "type": "number"
471
+ }
472
+ }
473
+ },
474
+ "required": [
475
+ "label",
476
+ "value"
477
+ ],
478
+ "additionalProperties": false
479
+ },
480
+ "MergeTagGroup": {
481
+ "type": "object",
482
+ "properties": {
483
+ "name": {
484
+ "type": "string"
485
+ },
486
+ "mergeTags": {
487
+ "type": "object",
488
+ "additionalProperties": {
489
+ "$ref": "#/definitions/MergeTagDefinition"
490
+ }
491
+ }
492
+ },
493
+ "required": [
494
+ "name",
495
+ "mergeTags"
496
+ ],
497
+ "additionalProperties": false
498
+ },
499
+ "MergeTagDefinition": {
500
+ "type": "object",
501
+ "properties": {
502
+ "name": {
503
+ "type": "string"
504
+ },
505
+ "value": {
506
+ "type": "string"
507
+ },
508
+ "sample": {
509
+ "type": "string"
510
+ },
511
+ "mergeTags": {
512
+ "type": "object",
513
+ "additionalProperties": {
514
+ "$ref": "#/definitions/MergeTagDefinition"
515
+ }
516
+ }
517
+ },
518
+ "required": [
519
+ "name",
520
+ "value"
521
+ ],
522
+ "additionalProperties": false
523
+ },
524
+ "DesignTagConfig": {
525
+ "type": "object",
526
+ "properties": {
527
+ "delimiter": {
528
+ "type": "array",
529
+ "items": {
530
+ "type": "string"
531
+ },
532
+ "minItems": 2,
533
+ "maxItems": 2
534
+ }
535
+ },
536
+ "required": [
537
+ "delimiter"
538
+ ],
539
+ "additionalProperties": false
540
+ },
541
+ "TabConfig": {
542
+ "type": "object",
543
+ "properties": {
544
+ "content": {
545
+ "$ref": "#/definitions/TabItemConfig"
546
+ },
547
+ "blocks": {
548
+ "$ref": "#/definitions/TabItemConfig"
549
+ },
550
+ "body": {
551
+ "$ref": "#/definitions/TabItemConfig"
552
+ },
553
+ "images": {
554
+ "$ref": "#/definitions/TabItemConfig"
555
+ },
556
+ "uploads": {
557
+ "$ref": "#/definitions/TabItemConfig"
558
+ }
559
+ },
560
+ "additionalProperties": {
561
+ "anyOf": [
562
+ {
563
+ "$ref": "#/definitions/TabItemConfig"
564
+ },
565
+ {
566
+ "not": {}
567
+ }
568
+ ]
569
+ }
570
+ },
571
+ "TabItemConfig": {
572
+ "type": "object",
573
+ "properties": {
574
+ "enabled": {
575
+ "type": "boolean"
576
+ },
577
+ "position": {
578
+ "type": "number"
579
+ },
580
+ "icon": {
581
+ "type": "string",
582
+ "description": "Tab icon: inline SVG markup or an image URL"
583
+ }
584
+ },
585
+ "additionalProperties": false
586
+ },
587
+ "EditorBehaviorConfig": {
588
+ "type": "object",
589
+ "properties": {
590
+ "confirmOnDelete": {
591
+ "type": "boolean",
592
+ "description": "Ask before deleting rows/content"
593
+ },
594
+ "designMode": {
595
+ "type": "string",
596
+ "enum": [
597
+ "live",
598
+ "edit"
599
+ ],
600
+ "description": "'live' (default): template lock flags are enforced. 'edit': template-author mode — locks are ignored and can be set in the panel."
601
+ },
602
+ "minRows": {
603
+ "type": "number"
604
+ },
605
+ "maxRows": {
606
+ "type": "number"
607
+ },
608
+ "autoSelectOnDrop": {
609
+ "type": "boolean"
610
+ },
611
+ "historyLimit": {
612
+ "type": "number",
613
+ "description": "Max undo steps (default 50)"
614
+ },
615
+ "readOnly": {
616
+ "type": "boolean",
617
+ "description": "Disable all editing (preview mode)"
618
+ },
619
+ "autosave": {
620
+ "anyOf": [
621
+ {
622
+ "type": "boolean"
623
+ },
624
+ {
625
+ "$ref": "#/definitions/AutosaveConfig"
626
+ }
627
+ ],
628
+ "description": "Autosave + version history: after each change (debounced) the design is saved as a version and a `design:autosave` event is emitted. `true` = defaults."
629
+ }
630
+ },
631
+ "additionalProperties": false
632
+ },
633
+ "AutosaveConfig": {
634
+ "type": "object",
635
+ "properties": {
636
+ "enabled": {
637
+ "type": "boolean"
638
+ },
639
+ "delay": {
640
+ "type": "number",
641
+ "description": "Debounce after the last change, in ms (default 1500)"
642
+ },
643
+ "versions": {
644
+ "type": "number",
645
+ "description": "Max versions kept; manual (labelled) versions are dropped last (default 30)"
646
+ },
647
+ "storageKey": {
648
+ "type": "string",
649
+ "description": "Also keep versions in localStorage under this key. Use one key per template (e.g. its id) and update it when loading another template"
650
+ }
651
+ },
652
+ "additionalProperties": false
653
+ },
654
+ "FeaturesConfig": {
655
+ "type": "object",
656
+ "properties": {
657
+ "textEditor": {
658
+ "type": "object",
659
+ "properties": {
660
+ "spellChecker": {
661
+ "type": "boolean"
662
+ },
663
+ "tables": {
664
+ "type": "boolean"
665
+ },
666
+ "cleanPaste": {
667
+ "anyOf": [
668
+ {
669
+ "type": "boolean"
670
+ },
671
+ {
672
+ "type": "string",
673
+ "const": "basic"
674
+ },
675
+ {
676
+ "type": "string",
677
+ "const": "confirm"
678
+ }
679
+ ],
680
+ "description": "true = sanitize (keep basic formatting), 'basic' = plain text, 'confirm' = ask, false = raw"
681
+ },
682
+ "emojis": {
683
+ "type": "boolean"
684
+ },
685
+ "textDirection": {
686
+ "type": "string",
687
+ "enum": [
688
+ "ltr",
689
+ "rtl"
690
+ ],
691
+ "description": "Default text direction for text blocks"
692
+ }
693
+ },
694
+ "additionalProperties": false
695
+ },
696
+ "preview": {
697
+ "anyOf": [
698
+ {
699
+ "type": "boolean"
700
+ },
701
+ {
702
+ "type": "object",
703
+ "properties": {
704
+ "deviceResolutions": {
705
+ "type": "array",
706
+ "items": {
707
+ "type": "object",
708
+ "properties": {
709
+ "name": {
710
+ "type": "string"
711
+ },
712
+ "width": {
713
+ "type": "number"
714
+ }
715
+ },
716
+ "required": [
717
+ "name",
718
+ "width"
719
+ ],
720
+ "additionalProperties": false
721
+ }
722
+ }
723
+ },
724
+ "additionalProperties": false
725
+ }
726
+ ],
727
+ "description": "Preview modal (showPreview / toolbar button). Default true"
728
+ },
729
+ "undoRedo": {
730
+ "type": "boolean"
731
+ },
732
+ "stockImages": {
733
+ "type": "object",
734
+ "properties": {
735
+ "enabled": {
736
+ "type": "boolean"
737
+ },
738
+ "safeSearch": {
739
+ "type": "boolean"
740
+ },
741
+ "licenses": {
742
+ "type": "string"
743
+ }
744
+ },
745
+ "required": [
746
+ "enabled"
747
+ ],
748
+ "additionalProperties": false,
749
+ "description": "\"Free images\" picker in image editors (Openverse search, CC0 / public domain). Off by default: it makes requests to an external service (Openverse) from the user's browser, so enable it only where that is acceptable (privacy / GDPR). `licenses` overrides the Openverse license filter (default \"cc0,pdm\")."
750
+ },
751
+ "userUploads": {
752
+ "type": "boolean",
753
+ "description": "Set false to hide the upload button of image editors (URL / library picking still works)"
754
+ },
755
+ "imageEditor": {
756
+ "type": "boolean"
757
+ },
758
+ "importHtml": {
759
+ "type": "boolean",
760
+ "description": "\"Import HTML\" button in the Body tab (the `importHtml()` API works regardless). Default true"
761
+ },
762
+ "colorPicker": {
763
+ "$ref": "#/definitions/ColorPickerConfig",
764
+ "description": "legacy location of the color picker config (same as top-level `colorPicker`)"
765
+ }
766
+ },
767
+ "additionalProperties": false
768
+ },
769
+ "ColorPickerConfig": {
770
+ "type": "object",
771
+ "properties": {
772
+ "colors": {
773
+ "anyOf": [
774
+ {
775
+ "type": "array",
776
+ "items": {
777
+ "type": "string"
778
+ }
779
+ },
780
+ {
781
+ "type": "array",
782
+ "items": {
783
+ "$ref": "#/definitions/ColorGroup"
784
+ }
785
+ }
786
+ ],
787
+ "description": "Flat list of colors (one unnamed group) or named groups"
788
+ },
789
+ "presets": {
790
+ "type": "array",
791
+ "items": {
792
+ "type": "string"
793
+ },
794
+ "description": "legacy `presets`: a flat list of preset colors"
795
+ }
796
+ },
797
+ "additionalProperties": false
798
+ },
799
+ "ColorGroup": {
800
+ "type": "object",
801
+ "properties": {
802
+ "id": {
803
+ "type": "string"
804
+ },
805
+ "label": {
806
+ "type": "string"
807
+ },
808
+ "colors": {
809
+ "type": "array",
810
+ "items": {
811
+ "type": "string"
812
+ }
813
+ },
814
+ "default": {
815
+ "type": "boolean",
816
+ "description": "Show this group first"
817
+ }
818
+ },
819
+ "required": [
820
+ "id",
821
+ "colors"
822
+ ],
823
+ "additionalProperties": false,
824
+ "description": "A named group of color swatches (`features.colorPicker.colors[]`)"
825
+ },
826
+ "EmailDesign": {
827
+ "type": "object",
828
+ "properties": {
829
+ "counters": {
830
+ "type": "object",
831
+ "additionalProperties": {
832
+ "type": "number"
833
+ }
834
+ },
835
+ "body": {
836
+ "$ref": "#/definitions/DesignBody"
837
+ },
838
+ "schemaVersion": {
839
+ "type": "number"
840
+ }
841
+ },
842
+ "required": [
843
+ "counters",
844
+ "body",
845
+ "schemaVersion"
846
+ ],
847
+ "additionalProperties": false,
848
+ "description": "Top-level design document"
849
+ },
850
+ "DesignBody": {
851
+ "type": "object",
852
+ "properties": {
853
+ "id": {
854
+ "type": "string"
855
+ },
856
+ "rows": {
857
+ "type": "array",
858
+ "items": {
859
+ "$ref": "#/definitions/DesignRow"
860
+ }
861
+ },
862
+ "headers": {
863
+ "type": "array",
864
+ "items": {
865
+ "$ref": "#/definitions/DesignRow"
866
+ }
867
+ },
868
+ "footers": {
869
+ "type": "array",
870
+ "items": {
871
+ "$ref": "#/definitions/DesignRow"
872
+ }
873
+ },
874
+ "values": {
875
+ "$ref": "#/definitions/BodyValues"
876
+ }
877
+ },
878
+ "required": [
879
+ "id",
880
+ "rows",
881
+ "headers",
882
+ "footers",
883
+ "values"
884
+ ],
885
+ "additionalProperties": false,
886
+ "description": "Design body containing rows, headers, footers and global values"
887
+ },
888
+ "DesignRow": {
889
+ "type": "object",
890
+ "properties": {
891
+ "id": {
892
+ "type": "string"
893
+ },
894
+ "cells": {
895
+ "type": "array",
896
+ "items": {
897
+ "type": "number"
898
+ }
899
+ },
900
+ "columns": {
901
+ "type": "array",
902
+ "items": {
903
+ "$ref": "#/definitions/DesignColumn"
904
+ }
905
+ },
906
+ "values": {
907
+ "$ref": "#/definitions/RowValues"
908
+ }
909
+ },
910
+ "required": [
911
+ "id",
912
+ "cells",
913
+ "columns",
914
+ "values"
915
+ ],
916
+ "additionalProperties": false,
917
+ "description": "A row in the design — contains columns"
918
+ },
919
+ "DesignColumn": {
920
+ "type": "object",
921
+ "properties": {
922
+ "id": {
923
+ "type": "string"
924
+ },
925
+ "contents": {
926
+ "type": "array",
927
+ "items": {
928
+ "$ref": "#/definitions/DesignContent"
929
+ }
930
+ },
931
+ "values": {
932
+ "$ref": "#/definitions/ColumnValues"
933
+ }
934
+ },
935
+ "required": [
936
+ "id",
937
+ "contents",
938
+ "values"
939
+ ],
940
+ "additionalProperties": false,
941
+ "description": "A column within a row — contains content blocks"
942
+ },
943
+ "DesignContent": {
944
+ "type": "object",
945
+ "properties": {
946
+ "id": {
947
+ "type": "string"
948
+ },
949
+ "type": {
950
+ "type": "string"
951
+ },
952
+ "values": {
953
+ "$ref": "#/definitions/ContentValues"
954
+ }
955
+ },
956
+ "required": [
957
+ "id",
958
+ "type",
959
+ "values"
960
+ ],
961
+ "additionalProperties": false,
962
+ "description": "A content block (tool instance) within a column"
963
+ },
964
+ "ContentValues": {
965
+ "type": "object",
966
+ "properties": {
967
+ "_meta": {
968
+ "$ref": "#/definitions/MetaInfo"
969
+ },
970
+ "_override": {
971
+ "$ref": "#/definitions/ValueOverrides"
972
+ },
973
+ "containerPadding": {
974
+ "type": "string"
975
+ },
976
+ "anchor": {
977
+ "type": "string"
978
+ },
979
+ "hideDesktop": {
980
+ "type": "boolean"
981
+ },
982
+ "hideMobile": {
983
+ "type": "boolean"
984
+ },
985
+ "displayCondition": {
986
+ "anyOf": [
987
+ {
988
+ "$ref": "#/definitions/DisplayCondition"
989
+ },
990
+ {
991
+ "type": "null"
992
+ }
993
+ ]
994
+ }
995
+ },
996
+ "required": [
997
+ "_meta",
998
+ "containerPadding",
999
+ "anchor",
1000
+ "hideDesktop",
1001
+ "hideMobile",
1002
+ "displayCondition"
1003
+ ],
1004
+ "additionalProperties": {}
1005
+ },
1006
+ "MetaInfo": {
1007
+ "type": "object",
1008
+ "properties": {
1009
+ "htmlID": {
1010
+ "type": "string"
1011
+ },
1012
+ "htmlClassNames": {
1013
+ "type": "string"
1014
+ }
1015
+ },
1016
+ "required": [
1017
+ "htmlID",
1018
+ "htmlClassNames"
1019
+ ],
1020
+ "additionalProperties": false
1021
+ },
1022
+ "ValueOverrides": {
1023
+ "type": "object",
1024
+ "properties": {
1025
+ "mobile": {
1026
+ "type": "object",
1027
+ "additionalProperties": {}
1028
+ },
1029
+ "desktop": {
1030
+ "type": "object",
1031
+ "additionalProperties": {}
1032
+ }
1033
+ },
1034
+ "additionalProperties": {
1035
+ "anyOf": [
1036
+ {
1037
+ "type": "object",
1038
+ "additionalProperties": {}
1039
+ },
1040
+ {
1041
+ "not": {}
1042
+ }
1043
+ ]
1044
+ },
1045
+ "description": "Per-device value overrides (legacy-compatible). Values in `mobile` replace the base values on small screens (export: media queries; canvas: mobile view). `desktop` is accepted for round-trips."
1046
+ },
1047
+ "DisplayCondition": {
1048
+ "type": "object",
1049
+ "properties": {
1050
+ "type": {
1051
+ "type": "string"
1052
+ },
1053
+ "label": {
1054
+ "type": "string"
1055
+ },
1056
+ "description": {
1057
+ "type": "string"
1058
+ },
1059
+ "before": {
1060
+ "type": "string"
1061
+ },
1062
+ "after": {
1063
+ "type": "string"
1064
+ }
1065
+ },
1066
+ "required": [
1067
+ "type",
1068
+ "label",
1069
+ "description"
1070
+ ],
1071
+ "additionalProperties": {}
1072
+ },
1073
+ "ColumnValues": {
1074
+ "type": "object",
1075
+ "properties": {
1076
+ "backgroundColor": {
1077
+ "type": "string"
1078
+ },
1079
+ "padding": {
1080
+ "type": "string"
1081
+ },
1082
+ "border": {
1083
+ "$ref": "#/definitions/Border"
1084
+ },
1085
+ "borderRadius": {
1086
+ "type": "string"
1087
+ },
1088
+ "_meta": {
1089
+ "$ref": "#/definitions/MetaInfo"
1090
+ }
1091
+ },
1092
+ "required": [
1093
+ "backgroundColor",
1094
+ "padding",
1095
+ "border",
1096
+ "borderRadius",
1097
+ "_meta"
1098
+ ],
1099
+ "additionalProperties": {}
1100
+ },
1101
+ "Border": {
1102
+ "type": "object",
1103
+ "properties": {
1104
+ "borderTopWidth": {
1105
+ "type": "string"
1106
+ },
1107
+ "borderTopStyle": {
1108
+ "type": "string"
1109
+ },
1110
+ "borderTopColor": {
1111
+ "type": "string"
1112
+ },
1113
+ "borderRightWidth": {
1114
+ "type": "string"
1115
+ },
1116
+ "borderRightStyle": {
1117
+ "type": "string"
1118
+ },
1119
+ "borderRightColor": {
1120
+ "type": "string"
1121
+ },
1122
+ "borderBottomWidth": {
1123
+ "type": "string"
1124
+ },
1125
+ "borderBottomStyle": {
1126
+ "type": "string"
1127
+ },
1128
+ "borderBottomColor": {
1129
+ "type": "string"
1130
+ },
1131
+ "borderLeftWidth": {
1132
+ "type": "string"
1133
+ },
1134
+ "borderLeftStyle": {
1135
+ "type": "string"
1136
+ },
1137
+ "borderLeftColor": {
1138
+ "type": "string"
1139
+ }
1140
+ },
1141
+ "additionalProperties": false
1142
+ },
1143
+ "RowValues": {
1144
+ "type": "object",
1145
+ "properties": {
1146
+ "displayCondition": {
1147
+ "anyOf": [
1148
+ {
1149
+ "$ref": "#/definitions/DisplayCondition"
1150
+ },
1151
+ {
1152
+ "type": "null"
1153
+ }
1154
+ ]
1155
+ },
1156
+ "columns": {
1157
+ "type": "boolean"
1158
+ },
1159
+ "backgroundColor": {
1160
+ "type": "string"
1161
+ },
1162
+ "columnsBackgroundColor": {
1163
+ "type": "string"
1164
+ },
1165
+ "backgroundImage": {
1166
+ "$ref": "#/definitions/BackgroundImage"
1167
+ },
1168
+ "padding": {
1169
+ "type": "string"
1170
+ },
1171
+ "anchor": {
1172
+ "type": "string"
1173
+ },
1174
+ "hideDesktop": {
1175
+ "type": "boolean"
1176
+ },
1177
+ "hideMobile": {
1178
+ "type": "boolean"
1179
+ },
1180
+ "noStackMobile": {
1181
+ "type": "boolean",
1182
+ "description": "Keep columns side by side on mobile instead of stacking"
1183
+ },
1184
+ "_override": {
1185
+ "$ref": "#/definitions/ValueOverrides"
1186
+ },
1187
+ "_meta": {
1188
+ "$ref": "#/definitions/MetaInfo"
1189
+ }
1190
+ },
1191
+ "required": [
1192
+ "displayCondition",
1193
+ "columns",
1194
+ "backgroundColor",
1195
+ "columnsBackgroundColor",
1196
+ "backgroundImage",
1197
+ "padding",
1198
+ "anchor",
1199
+ "hideDesktop",
1200
+ "hideMobile",
1201
+ "_meta"
1202
+ ],
1203
+ "additionalProperties": {}
1204
+ },
1205
+ "BackgroundImage": {
1206
+ "type": "object",
1207
+ "properties": {
1208
+ "url": {
1209
+ "type": "string"
1210
+ },
1211
+ "fullWidth": {
1212
+ "type": "boolean"
1213
+ },
1214
+ "repeat": {
1215
+ "type": [
1216
+ "boolean",
1217
+ "string"
1218
+ ]
1219
+ },
1220
+ "center": {
1221
+ "type": "boolean"
1222
+ },
1223
+ "cover": {
1224
+ "type": "boolean"
1225
+ }
1226
+ },
1227
+ "required": [
1228
+ "url",
1229
+ "fullWidth",
1230
+ "repeat",
1231
+ "center",
1232
+ "cover"
1233
+ ],
1234
+ "additionalProperties": false
1235
+ },
1236
+ "BodyValues": {
1237
+ "type": "object",
1238
+ "properties": {
1239
+ "backgroundColor": {
1240
+ "type": "string"
1241
+ },
1242
+ "contentAlign": {
1243
+ "type": "string"
1244
+ },
1245
+ "contentVerticalAlign": {
1246
+ "type": "string"
1247
+ },
1248
+ "contentWidth": {
1249
+ "type": "string"
1250
+ },
1251
+ "fontFamily": {
1252
+ "$ref": "#/definitions/FontFamily"
1253
+ },
1254
+ "textColor": {
1255
+ "type": "string"
1256
+ },
1257
+ "linkStyle": {
1258
+ "$ref": "#/definitions/LinkStyle"
1259
+ },
1260
+ "preheaderText": {
1261
+ "type": "string"
1262
+ },
1263
+ "fontWeight": {
1264
+ "type": [
1265
+ "number",
1266
+ "string"
1267
+ ],
1268
+ "description": "Body font weight (e.g. 400, 700)"
1269
+ },
1270
+ "title": {
1271
+ "type": "string",
1272
+ "description": "Document <title> of the exported HTML (overridden by the export `title` option; falls back to `subject`)"
1273
+ },
1274
+ "subject": {
1275
+ "type": "string",
1276
+ "description": "Email subject line (kept with the design so the sender uses the same text)"
1277
+ },
1278
+ "language": {
1279
+ "type": "string",
1280
+ "description": "Content language (BCP 47, e.g. 'it', 'en-GB') → `<html lang>`"
1281
+ },
1282
+ "darkMode": {
1283
+ "type": "object",
1284
+ "properties": {
1285
+ "backgroundColor": {
1286
+ "type": "string"
1287
+ },
1288
+ "textColor": {
1289
+ "type": "string"
1290
+ },
1291
+ "linkColor": {
1292
+ "type": "string"
1293
+ }
1294
+ },
1295
+ "additionalProperties": false,
1296
+ "description": "Email-wide dark-mode colors (exported in a prefers-color-scheme: dark query)"
1297
+ },
1298
+ "popupPosition": {
1299
+ "type": "string"
1300
+ },
1301
+ "popupWidth": {
1302
+ "type": "string"
1303
+ },
1304
+ "popupHeight": {
1305
+ "type": "string"
1306
+ },
1307
+ "borderRadius": {
1308
+ "type": "string"
1309
+ },
1310
+ "popupBackgroundColor": {
1311
+ "type": "string"
1312
+ },
1313
+ "popupBackgroundImage": {
1314
+ "$ref": "#/definitions/BackgroundImage"
1315
+ },
1316
+ "popupOverlay_backgroundColor": {
1317
+ "type": "string"
1318
+ },
1319
+ "popupCloseButton_position": {
1320
+ "type": "string"
1321
+ },
1322
+ "popupCloseButton_backgroundColor": {
1323
+ "type": "string"
1324
+ },
1325
+ "popupCloseButton_iconColor": {
1326
+ "type": "string"
1327
+ },
1328
+ "popupCloseButton_borderRadius": {
1329
+ "type": "string"
1330
+ },
1331
+ "popupCloseButton_margin": {
1332
+ "type": "string"
1333
+ },
1334
+ "popupCloseButton_action": {
1335
+ "$ref": "#/definitions/PopupCloseButtonAction"
1336
+ },
1337
+ "_meta": {
1338
+ "$ref": "#/definitions/MetaInfo"
1339
+ }
1340
+ },
1341
+ "required": [
1342
+ "backgroundColor",
1343
+ "contentAlign",
1344
+ "contentVerticalAlign",
1345
+ "contentWidth",
1346
+ "fontFamily",
1347
+ "textColor",
1348
+ "linkStyle",
1349
+ "preheaderText",
1350
+ "popupPosition",
1351
+ "popupWidth",
1352
+ "popupHeight",
1353
+ "borderRadius",
1354
+ "popupBackgroundColor",
1355
+ "popupBackgroundImage",
1356
+ "popupOverlay_backgroundColor",
1357
+ "popupCloseButton_position",
1358
+ "popupCloseButton_backgroundColor",
1359
+ "popupCloseButton_iconColor",
1360
+ "popupCloseButton_borderRadius",
1361
+ "popupCloseButton_margin",
1362
+ "popupCloseButton_action",
1363
+ "_meta"
1364
+ ],
1365
+ "additionalProperties": {}
1366
+ },
1367
+ "LinkStyle": {
1368
+ "type": "object",
1369
+ "properties": {
1370
+ "body": {
1371
+ "type": "boolean"
1372
+ },
1373
+ "linkColor": {
1374
+ "type": "string"
1375
+ },
1376
+ "linkHoverColor": {
1377
+ "type": "string"
1378
+ },
1379
+ "linkUnderline": {
1380
+ "type": "boolean"
1381
+ },
1382
+ "linkHoverUnderline": {
1383
+ "type": "boolean"
1384
+ }
1385
+ },
1386
+ "required": [
1387
+ "body",
1388
+ "linkColor",
1389
+ "linkHoverColor",
1390
+ "linkUnderline",
1391
+ "linkHoverUnderline"
1392
+ ],
1393
+ "additionalProperties": false
1394
+ },
1395
+ "PopupCloseButtonAction": {
1396
+ "type": "object",
1397
+ "properties": {
1398
+ "name": {
1399
+ "type": "string"
1400
+ },
1401
+ "attrs": {
1402
+ "type": "object",
1403
+ "additionalProperties": {
1404
+ "type": "string"
1405
+ }
1406
+ }
1407
+ },
1408
+ "required": [
1409
+ "name",
1410
+ "attrs"
1411
+ ],
1412
+ "additionalProperties": false
1413
+ },
1414
+ "AIConfig": {
1415
+ "type": "object",
1416
+ "properties": {
1417
+ "provider": {
1418
+ "$ref": "#/definitions/AIProvider",
1419
+ "description": "Custom provider (takes precedence over endpoint)"
1420
+ },
1421
+ "endpoint": {
1422
+ "type": "string",
1423
+ "description": "HTTP endpoint speaking the NDJSON protocol (e.g. the"
1424
+ },
1425
+ "headers": {
1426
+ "type": "object",
1427
+ "additionalProperties": {
1428
+ "type": "string"
1429
+ },
1430
+ "description": "Extra request headers (auth tokens, tenant ids…)"
1431
+ },
1432
+ "context": {
1433
+ "$ref": "#/definitions/AIContext",
1434
+ "description": "Default business context merged into every request"
1435
+ },
1436
+ "quickActions": {
1437
+ "type": "array",
1438
+ "items": {
1439
+ "$ref": "#/definitions/AIQuickAction"
1440
+ },
1441
+ "description": "Quick actions shown in the AI tab and block toolbar"
1442
+ },
1443
+ "showUsage": {
1444
+ "type": "boolean",
1445
+ "description": "Show tokens and estimated cost of the last run in the AI tab (default false). The data is always available in `ai:usage` / `ai:done` events either way."
1446
+ }
1447
+ },
1448
+ "additionalProperties": false
1449
+ },
1450
+ "AIProvider": {
1451
+ "type": "object",
1452
+ "additionalProperties": false,
1453
+ "description": "Anything that can turn an AIRequest into a stream of events"
1454
+ },
1455
+ "AIContext": {
1456
+ "type": "object",
1457
+ "properties": {
1458
+ "brand": {
1459
+ "type": "object",
1460
+ "properties": {
1461
+ "name": {
1462
+ "type": "string"
1463
+ },
1464
+ "website": {
1465
+ "type": "string"
1466
+ },
1467
+ "logoUrl": {
1468
+ "type": "string"
1469
+ },
1470
+ "colors": {
1471
+ "type": "object",
1472
+ "additionalProperties": {
1473
+ "type": "string"
1474
+ }
1475
+ },
1476
+ "fonts": {
1477
+ "type": "array",
1478
+ "items": {
1479
+ "type": "string"
1480
+ }
1481
+ },
1482
+ "voice": {
1483
+ "type": "string"
1484
+ }
1485
+ },
1486
+ "additionalProperties": false
1487
+ },
1488
+ "audience": {
1489
+ "type": "string"
1490
+ },
1491
+ "tone": {
1492
+ "type": "string"
1493
+ },
1494
+ "language": {
1495
+ "type": "string",
1496
+ "description": "Output language for generated copy (e.g. \"it\", \"en\")"
1497
+ },
1498
+ "goal": {
1499
+ "type": "string"
1500
+ },
1501
+ "data": {
1502
+ "type": "object",
1503
+ "additionalProperties": {},
1504
+ "description": "Arbitrary structured data: products, offers, events, user segments…"
1505
+ }
1506
+ },
1507
+ "additionalProperties": {},
1508
+ "description": "Business context passed to the model alongside the prompt"
1509
+ },
1510
+ "AIQuickAction": {
1511
+ "type": "object",
1512
+ "properties": {
1513
+ "label": {
1514
+ "type": "string"
1515
+ },
1516
+ "action": {
1517
+ "$ref": "#/definitions/AIAction"
1518
+ },
1519
+ "prompt": {
1520
+ "type": "string"
1521
+ },
1522
+ "forTypes": {
1523
+ "type": "array",
1524
+ "items": {
1525
+ "type": "string"
1526
+ },
1527
+ "description": "Show only when a content block of these types is selected"
1528
+ }
1529
+ },
1530
+ "required": [
1531
+ "label",
1532
+ "action",
1533
+ "prompt"
1534
+ ],
1535
+ "additionalProperties": false
1536
+ },
1537
+ "AIAction": {
1538
+ "anyOf": [
1539
+ {
1540
+ "type": "string"
1541
+ },
1542
+ {
1543
+ "type": "string",
1544
+ "enum": [
1545
+ "generate",
1546
+ "edit",
1547
+ "rewrite",
1548
+ "shorten",
1549
+ "translate",
1550
+ "subject",
1551
+ "import-html"
1552
+ ]
1553
+ }
1554
+ ],
1555
+ "description": "Built-in actions; any other string is passed through as a custom action"
1556
+ },
1557
+ "LinkTypeConfig": {
1558
+ "type": "object",
1559
+ "properties": {
1560
+ "name": {
1561
+ "type": "string"
1562
+ },
1563
+ "label": {
1564
+ "type": "string"
1565
+ },
1566
+ "attrs": {
1567
+ "type": "object",
1568
+ "additionalProperties": {
1569
+ "type": "string"
1570
+ },
1571
+ "description": "Fields shown in the link editor; values end up in `href.values`"
1572
+ },
1573
+ "fields": {
1574
+ "type": "array",
1575
+ "items": {
1576
+ "type": "object",
1577
+ "properties": {
1578
+ "name": {
1579
+ "type": "string"
1580
+ },
1581
+ "label": {
1582
+ "type": "string"
1583
+ },
1584
+ "defaultValue": {
1585
+ "type": "string"
1586
+ },
1587
+ "placeholder": {
1588
+ "type": "string"
1589
+ },
1590
+ "options": {
1591
+ "type": "array",
1592
+ "items": {
1593
+ "type": "object",
1594
+ "properties": {
1595
+ "label": {
1596
+ "type": "string"
1597
+ },
1598
+ "value": {
1599
+ "type": "string"
1600
+ }
1601
+ },
1602
+ "required": [
1603
+ "label",
1604
+ "value"
1605
+ ],
1606
+ "additionalProperties": false
1607
+ }
1608
+ }
1609
+ },
1610
+ "required": [
1611
+ "name",
1612
+ "label"
1613
+ ],
1614
+ "additionalProperties": false
1615
+ }
1616
+ },
1617
+ "enabled": {
1618
+ "type": "boolean",
1619
+ "description": "Set false to hide a built-in type"
1620
+ }
1621
+ },
1622
+ "required": [
1623
+ "name",
1624
+ "label"
1625
+ ],
1626
+ "additionalProperties": false,
1627
+ "description": "A link action type, e.g. web / email / phone / sms / custom"
1628
+ },
1629
+ "SpecialLink": {
1630
+ "type": "object",
1631
+ "properties": {
1632
+ "name": {
1633
+ "type": "string"
1634
+ },
1635
+ "href": {
1636
+ "type": "string"
1637
+ },
1638
+ "target": {
1639
+ "type": "string",
1640
+ "enum": [
1641
+ "_blank",
1642
+ "_self"
1643
+ ]
1644
+ },
1645
+ "specialLinks": {
1646
+ "type": "array",
1647
+ "items": {
1648
+ "$ref": "#/definitions/SpecialLink"
1649
+ }
1650
+ }
1651
+ },
1652
+ "required": [
1653
+ "name"
1654
+ ],
1655
+ "additionalProperties": false,
1656
+ "description": "A predefined link (e.g. unsubscribe). Groups nest via `specialLinks`."
1657
+ },
1658
+ "ColumnsConfig": {
1659
+ "type": "object",
1660
+ "properties": {
1661
+ "layouts": {
1662
+ "type": "array",
1663
+ "items": {
1664
+ "type": "array",
1665
+ "items": {
1666
+ "type": "number"
1667
+ }
1668
+ },
1669
+ "description": "Column layouts as relative cell proportions, e.g. `[[1], [1, 1], [2, 4, 4, 2]]`. Defaults to 100%, 50/50, 33/33/33, 66/33, 33/66, 25x4."
1670
+ }
1671
+ },
1672
+ "additionalProperties": false
1673
+ },
1674
+ "MergeTagsConfig": {
1675
+ "type": "object",
1676
+ "properties": {
1677
+ "sort": {
1678
+ "type": "boolean",
1679
+ "description": "Sort merge tags alphabetically in menus (default true)"
1680
+ },
1681
+ "autocompleteTriggerChar": {
1682
+ "type": [
1683
+ "string",
1684
+ "null"
1685
+ ],
1686
+ "description": "Text that opens the merge tag autocomplete in the text editor (default '{{'); `null` disables it"
1687
+ }
1688
+ },
1689
+ "additionalProperties": false
1690
+ },
1691
+ "BrandKit": {
1692
+ "type": "object",
1693
+ "properties": {
1694
+ "name": {
1695
+ "type": "string"
1696
+ },
1697
+ "colors": {
1698
+ "type": "object",
1699
+ "properties": {
1700
+ "primary": {
1701
+ "type": "string"
1702
+ },
1703
+ "secondary": {
1704
+ "type": "string"
1705
+ },
1706
+ "text": {
1707
+ "type": "string",
1708
+ "description": "Body text"
1709
+ },
1710
+ "background": {
1711
+ "type": "string",
1712
+ "description": "Email background"
1713
+ },
1714
+ "contentBackground": {
1715
+ "type": "string",
1716
+ "description": "Content (rows) background"
1717
+ },
1718
+ "link": {
1719
+ "type": "string"
1720
+ },
1721
+ "palette": {
1722
+ "type": "array",
1723
+ "items": {
1724
+ "type": "string"
1725
+ },
1726
+ "description": "Extra swatches shown in the color picker"
1727
+ }
1728
+ },
1729
+ "additionalProperties": false
1730
+ },
1731
+ "fonts": {
1732
+ "type": "object",
1733
+ "properties": {
1734
+ "body": {
1735
+ "anyOf": [
1736
+ {
1737
+ "type": "string"
1738
+ },
1739
+ {
1740
+ "$ref": "#/definitions/FontFamily"
1741
+ }
1742
+ ],
1743
+ "description": "Body / text font (name, CSS stack or `{ label, value, url }`)"
1744
+ },
1745
+ "heading": {
1746
+ "anyOf": [
1747
+ {
1748
+ "type": "string"
1749
+ },
1750
+ {
1751
+ "$ref": "#/definitions/FontFamily"
1752
+ }
1753
+ ]
1754
+ }
1755
+ },
1756
+ "additionalProperties": false
1757
+ },
1758
+ "logo": {
1759
+ "type": "object",
1760
+ "properties": {
1761
+ "url": {
1762
+ "type": "string"
1763
+ },
1764
+ "alt": {
1765
+ "type": "string"
1766
+ },
1767
+ "width": {
1768
+ "type": "number"
1769
+ },
1770
+ "href": {
1771
+ "type": "string"
1772
+ }
1773
+ },
1774
+ "required": [
1775
+ "url"
1776
+ ],
1777
+ "additionalProperties": false
1778
+ },
1779
+ "button": {
1780
+ "type": "object",
1781
+ "properties": {
1782
+ "backgroundColor": {
1783
+ "type": "string"
1784
+ },
1785
+ "color": {
1786
+ "type": "string"
1787
+ },
1788
+ "hoverBackgroundColor": {
1789
+ "type": "string"
1790
+ },
1791
+ "borderRadius": {
1792
+ "type": [
1793
+ "string",
1794
+ "number"
1795
+ ]
1796
+ },
1797
+ "fontWeight": {
1798
+ "type": [
1799
+ "number",
1800
+ "string"
1801
+ ]
1802
+ }
1803
+ },
1804
+ "additionalProperties": false
1805
+ },
1806
+ "heading": {
1807
+ "type": "object",
1808
+ "properties": {
1809
+ "color": {
1810
+ "type": "string"
1811
+ },
1812
+ "fontWeight": {
1813
+ "type": [
1814
+ "number",
1815
+ "string"
1816
+ ]
1817
+ }
1818
+ },
1819
+ "additionalProperties": false
1820
+ },
1821
+ "voice": {
1822
+ "type": "string",
1823
+ "description": "Voice / tone for the AI (copied into `ai.context.brand.voice`)"
1824
+ }
1825
+ },
1826
+ "additionalProperties": false,
1827
+ "description": "Brand kit (see `MailEditorConfig.brand`)"
1828
+ }
1829
+ }
1830
+ }