@zotlit/obsidian-plugin 0.0.0-stage → 2.3.0-beta.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,1889 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "urn:zotlit:template-contract:v3:filename",
4
+ "$comment": "Generated by scripts/generate-contract.ts - DO NOT EDIT.",
5
+ "title": "zt (filename root)",
6
+ "description": "The serialized `zt` data the `filename` template receives.",
7
+ "$ref": "#/$defs/TemplateFilenameItemData",
8
+ "$defs": {
9
+ "TemplateFilenameItemData": {
10
+ "description": "The `zt` root of the `filename` template: an item's own fields, its collections, Primary Creators, an Author Summary, and inert `notePath` / `noteLink` stubs. It reads only this item when naming a note.\n\nItem-type-specific Zotero fields beyond the typed ones above, each under its canonical name — e.g. `zt.conferenceName`, `zt.numPages`. A field Zotero maps to a base field is reachable through that base name alone: read `blogTitle` as `zt.publicationTitle`, `studio` as `zt.publisher`, `reportNumber` as `zt.number`, `thesisType` as `zt.type`.",
11
+ "type": "object",
12
+ "properties": {
13
+ "notePath": {
14
+ "type": ["string", "null"],
15
+ "description": "Always `\"\"` — the note does not exist yet when a filename is resolved. Stubbed (rather than omitted) so a filename template reading `notePath` does not throw; it keeps the `string | null` type the note root gives."
16
+ },
17
+ "noteLink": {
18
+ "oneOf": [
19
+ {
20
+ "type": "object",
21
+ "properties": {
22
+ "$helper": {
23
+ "const": "noteLink"
24
+ },
25
+ "signature": {
26
+ "const": "(alias?: string, subpath?: string) => string | null"
27
+ },
28
+ "value": {
29
+ "type": ["string", "null"]
30
+ },
31
+ "error": {
32
+ "type": "string"
33
+ }
34
+ },
35
+ "required": ["$helper", "signature", "value"],
36
+ "additionalProperties": false
37
+ }
38
+ ],
39
+ "description": "Always returns `\"\"`; matches the note root's `noteLink` signature."
40
+ },
41
+ "collections": {
42
+ "type": "array",
43
+ "items": {
44
+ "$ref": "#/$defs/TemplateCollection"
45
+ },
46
+ "description": "Collections the item belongs to, sorted by name; trashed collections excluded."
47
+ },
48
+ "key": {
49
+ "type": "string",
50
+ "description": "Zotero item key, e.g. `\"ABC12345\"`; unique within its library."
51
+ },
52
+ "groupID": {
53
+ "type": ["number", "null"],
54
+ "description": "Group library ID; `null` for the personal library."
55
+ },
56
+ "libraryID": {
57
+ "type": "number",
58
+ "description": "Zotero library ID holding the item."
59
+ },
60
+ "indexedKey": {
61
+ "type": "string",
62
+ "description": "`key` for the personal library, `KEYgGROUPID` for a group library."
63
+ },
64
+ "itemType": {
65
+ "type": "string",
66
+ "description": "Zotero item type, e.g. `\"journalArticle\"`, `\"book\"`."
67
+ },
68
+ "dateAdded": {
69
+ "type": "string",
70
+ "description": "When the item was added to Zotero. Second precision — Zotero stores the timestamp as a UTC string with no sub-second component. Renders as the local date (e.g. `2026-06-21`) in `{{ }}` output."
71
+ },
72
+ "dateModified": {
73
+ "type": "string",
74
+ "description": "When the item was last modified in Zotero; same precision and rendering as `dateAdded`."
75
+ },
76
+ "creators": {
77
+ "type": "array",
78
+ "items": {
79
+ "$ref": "#/$defs/TemplateCreator"
80
+ },
81
+ "description": "Every creator on the item, in Zotero's own order."
82
+ },
83
+ "primaryCreatorType": {
84
+ "type": ["string", "null"],
85
+ "description": "The creator role Zotero treats as primary for this item type, e.g. `\"author\"` for a journal article, `\"director\"` for a film; `null` when the type defines none."
86
+ },
87
+ "tags": {
88
+ "type": "array",
89
+ "items": {
90
+ "$ref": "#/$defs/TemplateTag"
91
+ },
92
+ "description": "Tags applied to the item."
93
+ },
94
+ "title": {
95
+ "type": ["string", "null"],
96
+ "description": "Item title."
97
+ },
98
+ "abstract": {
99
+ "type": ["string", "null"],
100
+ "description": "Abstract text. The CSL-inspired rename of Zotero's `abstractNote`, which stays accessible — both `zt.abstract` and `zt.abstractNote` work."
101
+ },
102
+ "containerTitle": {
103
+ "type": ["string", "null"],
104
+ "description": "Journal or container title. The CSL-inspired rename of Zotero's `publicationTitle`, which stays accessible — both names work."
105
+ },
106
+ "citationKey": {
107
+ "type": ["string", "null"],
108
+ "description": "Citation key, from Zotero's native citation key field, where Better BibTeX writes the keys it generates."
109
+ },
110
+ "citekey": {
111
+ "type": ["string", "null"],
112
+ "description": "Alias for `citationKey`; both stay accessible on `zt.*`."
113
+ },
114
+ "date": {
115
+ "anyOf": [
116
+ {
117
+ "$ref": "#/$defs/ItemDateYMD"
118
+ },
119
+ {
120
+ "$ref": "#/$defs/ItemDateYearMonth"
121
+ },
122
+ {
123
+ "$ref": "#/$defs/ItemDateYear"
124
+ },
125
+ {
126
+ "$ref": "#/$defs/ItemDateText"
127
+ },
128
+ {
129
+ "type": "null"
130
+ }
131
+ ],
132
+ "description": "Publication date, parsed from Zotero's multipart `date` field."
133
+ },
134
+ "shortTitle": {
135
+ "type": ["string", "null"],
136
+ "description": "Short title."
137
+ },
138
+ "DOI": {
139
+ "type": ["string", "null"],
140
+ "description": "Digital Object Identifier."
141
+ },
142
+ "url": {
143
+ "type": ["string", "null"],
144
+ "description": "Item URL."
145
+ },
146
+ "ISBN": {
147
+ "type": ["string", "null"],
148
+ "description": "ISBN."
149
+ },
150
+ "ISSN": {
151
+ "type": ["string", "null"],
152
+ "description": "ISSN."
153
+ },
154
+ "volume": {
155
+ "type": ["string", "null"],
156
+ "description": "Volume."
157
+ },
158
+ "issue": {
159
+ "type": ["string", "null"],
160
+ "description": "Issue."
161
+ },
162
+ "pages": {
163
+ "type": ["string", "null"],
164
+ "description": "Page range."
165
+ },
166
+ "publisher": {
167
+ "type": ["string", "null"],
168
+ "description": "Publisher."
169
+ },
170
+ "place": {
171
+ "type": ["string", "null"],
172
+ "description": "Place of publication."
173
+ },
174
+ "edition": {
175
+ "type": ["string", "null"],
176
+ "description": "Edition."
177
+ },
178
+ "language": {
179
+ "type": ["string", "null"],
180
+ "description": "Language, verbatim as Zotero stores it, e.g. `\"en-US\"`, `\"English\"`."
181
+ },
182
+ "extra": {
183
+ "anyOf": [
184
+ {
185
+ "$ref": "#/$defs/ItemExtra"
186
+ },
187
+ {
188
+ "type": "null"
189
+ }
190
+ ],
191
+ "description": "Parsed best-effort from Zotero's free-text `extra` field; prints `raw`. `null` when the field is empty or absent."
192
+ },
193
+ "authors": {
194
+ "type": "array",
195
+ "items": {
196
+ "$ref": "#/$defs/TemplateCreator"
197
+ },
198
+ "description": "Primary Creators from the item's role-priority chain."
199
+ },
200
+ "authorsShort": {
201
+ "type": "string",
202
+ "description": "Formatted short author string, e.g. `\"Smith et al.\"`."
203
+ }
204
+ },
205
+ "required": [
206
+ "notePath",
207
+ "noteLink",
208
+ "collections",
209
+ "key",
210
+ "groupID",
211
+ "libraryID",
212
+ "indexedKey",
213
+ "itemType",
214
+ "dateAdded",
215
+ "dateModified",
216
+ "creators",
217
+ "primaryCreatorType",
218
+ "tags",
219
+ "title",
220
+ "abstract",
221
+ "containerTitle",
222
+ "citationKey",
223
+ "citekey",
224
+ "date",
225
+ "shortTitle",
226
+ "DOI",
227
+ "url",
228
+ "ISBN",
229
+ "ISSN",
230
+ "volume",
231
+ "issue",
232
+ "pages",
233
+ "publisher",
234
+ "place",
235
+ "edition",
236
+ "language",
237
+ "extra",
238
+ "authors",
239
+ "authorsShort"
240
+ ],
241
+ "oneOf": [
242
+ {
243
+ "properties": {
244
+ "abstractNote": {
245
+ "type": "string"
246
+ },
247
+ "accessDate": {
248
+ "type": "string"
249
+ },
250
+ "archive": {
251
+ "type": "string"
252
+ },
253
+ "archiveLocation": {
254
+ "type": "string"
255
+ },
256
+ "artworkSize": {
257
+ "type": "string"
258
+ },
259
+ "callNumber": {
260
+ "type": "string"
261
+ },
262
+ "eventPlace": {
263
+ "type": "string"
264
+ },
265
+ "libraryCatalog": {
266
+ "type": "string"
267
+ },
268
+ "medium": {
269
+ "type": "string"
270
+ },
271
+ "rights": {
272
+ "type": "string"
273
+ },
274
+ "itemType": {
275
+ "const": "artwork"
276
+ }
277
+ },
278
+ "required": ["itemType"]
279
+ },
280
+ {
281
+ "properties": {
282
+ "abstractNote": {
283
+ "type": "string"
284
+ },
285
+ "accessDate": {
286
+ "type": "string"
287
+ },
288
+ "archive": {
289
+ "type": "string"
290
+ },
291
+ "archiveLocation": {
292
+ "type": "string"
293
+ },
294
+ "callNumber": {
295
+ "type": "string"
296
+ },
297
+ "libraryCatalog": {
298
+ "type": "string"
299
+ },
300
+ "medium": {
301
+ "type": "string"
302
+ },
303
+ "numberOfVolumes": {
304
+ "type": "string"
305
+ },
306
+ "rights": {
307
+ "type": "string"
308
+ },
309
+ "runningTime": {
310
+ "type": "string"
311
+ },
312
+ "seriesTitle": {
313
+ "type": "string"
314
+ },
315
+ "itemType": {
316
+ "const": "audioRecording"
317
+ }
318
+ },
319
+ "required": ["itemType"]
320
+ },
321
+ {
322
+ "properties": {
323
+ "abstractNote": {
324
+ "type": "string"
325
+ },
326
+ "accessDate": {
327
+ "type": "string"
328
+ },
329
+ "authority": {
330
+ "type": "string"
331
+ },
332
+ "code": {
333
+ "type": "string"
334
+ },
335
+ "history": {
336
+ "type": "string"
337
+ },
338
+ "number": {
339
+ "type": "string"
340
+ },
341
+ "rights": {
342
+ "type": "string"
343
+ },
344
+ "section": {
345
+ "type": "string"
346
+ },
347
+ "session": {
348
+ "type": "string"
349
+ },
350
+ "itemType": {
351
+ "const": "bill"
352
+ }
353
+ },
354
+ "required": ["itemType"]
355
+ },
356
+ {
357
+ "properties": {
358
+ "abstractNote": {
359
+ "type": "string"
360
+ },
361
+ "accessDate": {
362
+ "type": "string"
363
+ },
364
+ "publicationTitle": {
365
+ "type": "string"
366
+ },
367
+ "rights": {
368
+ "type": "string"
369
+ },
370
+ "type": {
371
+ "type": "string"
372
+ },
373
+ "itemType": {
374
+ "const": "blogPost"
375
+ }
376
+ },
377
+ "required": ["itemType"]
378
+ },
379
+ {
380
+ "properties": {
381
+ "abstractNote": {
382
+ "type": "string"
383
+ },
384
+ "accessDate": {
385
+ "type": "string"
386
+ },
387
+ "archive": {
388
+ "type": "string"
389
+ },
390
+ "archiveLocation": {
391
+ "type": "string"
392
+ },
393
+ "callNumber": {
394
+ "type": "string"
395
+ },
396
+ "libraryCatalog": {
397
+ "type": "string"
398
+ },
399
+ "medium": {
400
+ "type": "string"
401
+ },
402
+ "numPages": {
403
+ "type": "string"
404
+ },
405
+ "numberOfVolumes": {
406
+ "type": "string"
407
+ },
408
+ "originalDate": {
409
+ "type": "string"
410
+ },
411
+ "originalPlace": {
412
+ "type": "string"
413
+ },
414
+ "originalPublisher": {
415
+ "type": "string"
416
+ },
417
+ "rights": {
418
+ "type": "string"
419
+ },
420
+ "series": {
421
+ "type": "string"
422
+ },
423
+ "seriesNumber": {
424
+ "type": "string"
425
+ },
426
+ "itemType": {
427
+ "const": "book"
428
+ }
429
+ },
430
+ "required": ["itemType"]
431
+ },
432
+ {
433
+ "properties": {
434
+ "abstractNote": {
435
+ "type": "string"
436
+ },
437
+ "accessDate": {
438
+ "type": "string"
439
+ },
440
+ "archive": {
441
+ "type": "string"
442
+ },
443
+ "archiveLocation": {
444
+ "type": "string"
445
+ },
446
+ "callNumber": {
447
+ "type": "string"
448
+ },
449
+ "libraryCatalog": {
450
+ "type": "string"
451
+ },
452
+ "medium": {
453
+ "type": "string"
454
+ },
455
+ "numberOfVolumes": {
456
+ "type": "string"
457
+ },
458
+ "originalDate": {
459
+ "type": "string"
460
+ },
461
+ "originalPlace": {
462
+ "type": "string"
463
+ },
464
+ "originalPublisher": {
465
+ "type": "string"
466
+ },
467
+ "publicationTitle": {
468
+ "type": "string"
469
+ },
470
+ "rights": {
471
+ "type": "string"
472
+ },
473
+ "series": {
474
+ "type": "string"
475
+ },
476
+ "seriesNumber": {
477
+ "type": "string"
478
+ },
479
+ "itemType": {
480
+ "const": "bookSection"
481
+ }
482
+ },
483
+ "required": ["itemType"]
484
+ },
485
+ {
486
+ "properties": {
487
+ "abstractNote": {
488
+ "type": "string"
489
+ },
490
+ "accessDate": {
491
+ "type": "string"
492
+ },
493
+ "authority": {
494
+ "type": "string"
495
+ },
496
+ "history": {
497
+ "type": "string"
498
+ },
499
+ "number": {
500
+ "type": "string"
501
+ },
502
+ "reporter": {
503
+ "type": "string"
504
+ },
505
+ "rights": {
506
+ "type": "string"
507
+ },
508
+ "itemType": {
509
+ "const": "case"
510
+ }
511
+ },
512
+ "required": ["itemType"]
513
+ },
514
+ {
515
+ "properties": {
516
+ "abstractNote": {
517
+ "type": "string"
518
+ },
519
+ "accessDate": {
520
+ "type": "string"
521
+ },
522
+ "archive": {
523
+ "type": "string"
524
+ },
525
+ "archiveLocation": {
526
+ "type": "string"
527
+ },
528
+ "callNumber": {
529
+ "type": "string"
530
+ },
531
+ "libraryCatalog": {
532
+ "type": "string"
533
+ },
534
+ "programmingLanguage": {
535
+ "type": "string"
536
+ },
537
+ "rights": {
538
+ "type": "string"
539
+ },
540
+ "seriesTitle": {
541
+ "type": "string"
542
+ },
543
+ "system": {
544
+ "type": "string"
545
+ },
546
+ "versionNumber": {
547
+ "type": "string"
548
+ },
549
+ "itemType": {
550
+ "const": "computerProgram"
551
+ }
552
+ },
553
+ "required": ["itemType"]
554
+ },
555
+ {
556
+ "properties": {
557
+ "abstractNote": {
558
+ "type": "string"
559
+ },
560
+ "accessDate": {
561
+ "type": "string"
562
+ },
563
+ "archive": {
564
+ "type": "string"
565
+ },
566
+ "archiveLocation": {
567
+ "type": "string"
568
+ },
569
+ "callNumber": {
570
+ "type": "string"
571
+ },
572
+ "conferenceName": {
573
+ "type": "string"
574
+ },
575
+ "eventPlace": {
576
+ "type": "string"
577
+ },
578
+ "libraryCatalog": {
579
+ "type": "string"
580
+ },
581
+ "numberOfVolumes": {
582
+ "type": "string"
583
+ },
584
+ "publicationTitle": {
585
+ "type": "string"
586
+ },
587
+ "rights": {
588
+ "type": "string"
589
+ },
590
+ "series": {
591
+ "type": "string"
592
+ },
593
+ "seriesNumber": {
594
+ "type": "string"
595
+ },
596
+ "itemType": {
597
+ "const": "conferencePaper"
598
+ }
599
+ },
600
+ "required": ["itemType"]
601
+ },
602
+ {
603
+ "properties": {
604
+ "abstractNote": {
605
+ "type": "string"
606
+ },
607
+ "accessDate": {
608
+ "type": "string"
609
+ },
610
+ "archive": {
611
+ "type": "string"
612
+ },
613
+ "archiveLocation": {
614
+ "type": "string"
615
+ },
616
+ "callNumber": {
617
+ "type": "string"
618
+ },
619
+ "libraryCatalog": {
620
+ "type": "string"
621
+ },
622
+ "medium": {
623
+ "type": "string"
624
+ },
625
+ "number": {
626
+ "type": "string"
627
+ },
628
+ "rights": {
629
+ "type": "string"
630
+ },
631
+ "type": {
632
+ "type": "string"
633
+ },
634
+ "versionNumber": {
635
+ "type": "string"
636
+ },
637
+ "itemType": {
638
+ "const": "dataset"
639
+ }
640
+ },
641
+ "required": ["itemType"]
642
+ },
643
+ {
644
+ "properties": {
645
+ "abstractNote": {
646
+ "type": "string"
647
+ },
648
+ "accessDate": {
649
+ "type": "string"
650
+ },
651
+ "archive": {
652
+ "type": "string"
653
+ },
654
+ "archiveLocation": {
655
+ "type": "string"
656
+ },
657
+ "callNumber": {
658
+ "type": "string"
659
+ },
660
+ "libraryCatalog": {
661
+ "type": "string"
662
+ },
663
+ "numberOfVolumes": {
664
+ "type": "string"
665
+ },
666
+ "publicationTitle": {
667
+ "type": "string"
668
+ },
669
+ "rights": {
670
+ "type": "string"
671
+ },
672
+ "series": {
673
+ "type": "string"
674
+ },
675
+ "seriesNumber": {
676
+ "type": "string"
677
+ },
678
+ "itemType": {
679
+ "const": "dictionaryEntry"
680
+ }
681
+ },
682
+ "required": ["itemType"]
683
+ },
684
+ {
685
+ "properties": {
686
+ "abstractNote": {
687
+ "type": "string"
688
+ },
689
+ "accessDate": {
690
+ "type": "string"
691
+ },
692
+ "archive": {
693
+ "type": "string"
694
+ },
695
+ "archiveLocation": {
696
+ "type": "string"
697
+ },
698
+ "callNumber": {
699
+ "type": "string"
700
+ },
701
+ "libraryCatalog": {
702
+ "type": "string"
703
+ },
704
+ "rights": {
705
+ "type": "string"
706
+ },
707
+ "type": {
708
+ "type": "string"
709
+ },
710
+ "itemType": {
711
+ "const": "document"
712
+ }
713
+ },
714
+ "required": ["itemType"]
715
+ },
716
+ {
717
+ "properties": {
718
+ "abstractNote": {
719
+ "type": "string"
720
+ },
721
+ "accessDate": {
722
+ "type": "string"
723
+ },
724
+ "rights": {
725
+ "type": "string"
726
+ },
727
+ "itemType": {
728
+ "const": "email"
729
+ }
730
+ },
731
+ "required": ["itemType"]
732
+ },
733
+ {
734
+ "properties": {
735
+ "abstractNote": {
736
+ "type": "string"
737
+ },
738
+ "accessDate": {
739
+ "type": "string"
740
+ },
741
+ "archive": {
742
+ "type": "string"
743
+ },
744
+ "archiveLocation": {
745
+ "type": "string"
746
+ },
747
+ "callNumber": {
748
+ "type": "string"
749
+ },
750
+ "libraryCatalog": {
751
+ "type": "string"
752
+ },
753
+ "numberOfVolumes": {
754
+ "type": "string"
755
+ },
756
+ "publicationTitle": {
757
+ "type": "string"
758
+ },
759
+ "rights": {
760
+ "type": "string"
761
+ },
762
+ "series": {
763
+ "type": "string"
764
+ },
765
+ "seriesNumber": {
766
+ "type": "string"
767
+ },
768
+ "itemType": {
769
+ "const": "encyclopediaArticle"
770
+ }
771
+ },
772
+ "required": ["itemType"]
773
+ },
774
+ {
775
+ "properties": {
776
+ "abstractNote": {
777
+ "type": "string"
778
+ },
779
+ "accessDate": {
780
+ "type": "string"
781
+ },
782
+ "archive": {
783
+ "type": "string"
784
+ },
785
+ "archiveLocation": {
786
+ "type": "string"
787
+ },
788
+ "callNumber": {
789
+ "type": "string"
790
+ },
791
+ "libraryCatalog": {
792
+ "type": "string"
793
+ },
794
+ "medium": {
795
+ "type": "string"
796
+ },
797
+ "rights": {
798
+ "type": "string"
799
+ },
800
+ "runningTime": {
801
+ "type": "string"
802
+ },
803
+ "type": {
804
+ "type": "string"
805
+ },
806
+ "itemType": {
807
+ "const": "film"
808
+ }
809
+ },
810
+ "required": ["itemType"]
811
+ },
812
+ {
813
+ "properties": {
814
+ "abstractNote": {
815
+ "type": "string"
816
+ },
817
+ "accessDate": {
818
+ "type": "string"
819
+ },
820
+ "publicationTitle": {
821
+ "type": "string"
822
+ },
823
+ "rights": {
824
+ "type": "string"
825
+ },
826
+ "type": {
827
+ "type": "string"
828
+ },
829
+ "itemType": {
830
+ "const": "forumPost"
831
+ }
832
+ },
833
+ "required": ["itemType"]
834
+ },
835
+ {
836
+ "properties": {
837
+ "abstractNote": {
838
+ "type": "string"
839
+ },
840
+ "accessDate": {
841
+ "type": "string"
842
+ },
843
+ "authority": {
844
+ "type": "string"
845
+ },
846
+ "committee": {
847
+ "type": "string"
848
+ },
849
+ "history": {
850
+ "type": "string"
851
+ },
852
+ "number": {
853
+ "type": "string"
854
+ },
855
+ "numberOfVolumes": {
856
+ "type": "string"
857
+ },
858
+ "rights": {
859
+ "type": "string"
860
+ },
861
+ "session": {
862
+ "type": "string"
863
+ },
864
+ "itemType": {
865
+ "const": "hearing"
866
+ }
867
+ },
868
+ "required": ["itemType"]
869
+ },
870
+ {
871
+ "properties": {
872
+ "abstractNote": {
873
+ "type": "string"
874
+ },
875
+ "accessDate": {
876
+ "type": "string"
877
+ },
878
+ "rights": {
879
+ "type": "string"
880
+ },
881
+ "itemType": {
882
+ "const": "instantMessage"
883
+ }
884
+ },
885
+ "required": ["itemType"]
886
+ },
887
+ {
888
+ "properties": {
889
+ "abstractNote": {
890
+ "type": "string"
891
+ },
892
+ "accessDate": {
893
+ "type": "string"
894
+ },
895
+ "archive": {
896
+ "type": "string"
897
+ },
898
+ "archiveLocation": {
899
+ "type": "string"
900
+ },
901
+ "callNumber": {
902
+ "type": "string"
903
+ },
904
+ "libraryCatalog": {
905
+ "type": "string"
906
+ },
907
+ "medium": {
908
+ "type": "string"
909
+ },
910
+ "rights": {
911
+ "type": "string"
912
+ },
913
+ "itemType": {
914
+ "const": "interview"
915
+ }
916
+ },
917
+ "required": ["itemType"]
918
+ },
919
+ {
920
+ "properties": {
921
+ "PMCID": {
922
+ "type": "string"
923
+ },
924
+ "PMID": {
925
+ "type": "string"
926
+ },
927
+ "abstractNote": {
928
+ "type": "string"
929
+ },
930
+ "accessDate": {
931
+ "type": "string"
932
+ },
933
+ "archive": {
934
+ "type": "string"
935
+ },
936
+ "archiveLocation": {
937
+ "type": "string"
938
+ },
939
+ "callNumber": {
940
+ "type": "string"
941
+ },
942
+ "journalAbbreviation": {
943
+ "type": "string"
944
+ },
945
+ "libraryCatalog": {
946
+ "type": "string"
947
+ },
948
+ "partNumber": {
949
+ "type": "string"
950
+ },
951
+ "partTitle": {
952
+ "type": "string"
953
+ },
954
+ "publicationTitle": {
955
+ "type": "string"
956
+ },
957
+ "rights": {
958
+ "type": "string"
959
+ },
960
+ "section": {
961
+ "type": "string"
962
+ },
963
+ "series": {
964
+ "type": "string"
965
+ },
966
+ "seriesText": {
967
+ "type": "string"
968
+ },
969
+ "seriesTitle": {
970
+ "type": "string"
971
+ },
972
+ "itemType": {
973
+ "const": "journalArticle"
974
+ }
975
+ },
976
+ "required": ["itemType"]
977
+ },
978
+ {
979
+ "properties": {
980
+ "abstractNote": {
981
+ "type": "string"
982
+ },
983
+ "accessDate": {
984
+ "type": "string"
985
+ },
986
+ "archive": {
987
+ "type": "string"
988
+ },
989
+ "archiveLocation": {
990
+ "type": "string"
991
+ },
992
+ "callNumber": {
993
+ "type": "string"
994
+ },
995
+ "eventPlace": {
996
+ "type": "string"
997
+ },
998
+ "libraryCatalog": {
999
+ "type": "string"
1000
+ },
1001
+ "rights": {
1002
+ "type": "string"
1003
+ },
1004
+ "type": {
1005
+ "type": "string"
1006
+ },
1007
+ "itemType": {
1008
+ "const": "letter"
1009
+ }
1010
+ },
1011
+ "required": ["itemType"]
1012
+ },
1013
+ {
1014
+ "properties": {
1015
+ "abstractNote": {
1016
+ "type": "string"
1017
+ },
1018
+ "accessDate": {
1019
+ "type": "string"
1020
+ },
1021
+ "archive": {
1022
+ "type": "string"
1023
+ },
1024
+ "archiveLocation": {
1025
+ "type": "string"
1026
+ },
1027
+ "callNumber": {
1028
+ "type": "string"
1029
+ },
1030
+ "libraryCatalog": {
1031
+ "type": "string"
1032
+ },
1033
+ "publicationTitle": {
1034
+ "type": "string"
1035
+ },
1036
+ "rights": {
1037
+ "type": "string"
1038
+ },
1039
+ "itemType": {
1040
+ "const": "magazineArticle"
1041
+ }
1042
+ },
1043
+ "required": ["itemType"]
1044
+ },
1045
+ {
1046
+ "properties": {
1047
+ "abstractNote": {
1048
+ "type": "string"
1049
+ },
1050
+ "accessDate": {
1051
+ "type": "string"
1052
+ },
1053
+ "archive": {
1054
+ "type": "string"
1055
+ },
1056
+ "archiveLocation": {
1057
+ "type": "string"
1058
+ },
1059
+ "callNumber": {
1060
+ "type": "string"
1061
+ },
1062
+ "libraryCatalog": {
1063
+ "type": "string"
1064
+ },
1065
+ "numPages": {
1066
+ "type": "string"
1067
+ },
1068
+ "number": {
1069
+ "type": "string"
1070
+ },
1071
+ "rights": {
1072
+ "type": "string"
1073
+ },
1074
+ "type": {
1075
+ "type": "string"
1076
+ },
1077
+ "itemType": {
1078
+ "const": "manuscript"
1079
+ }
1080
+ },
1081
+ "required": ["itemType"]
1082
+ },
1083
+ {
1084
+ "properties": {
1085
+ "abstractNote": {
1086
+ "type": "string"
1087
+ },
1088
+ "accessDate": {
1089
+ "type": "string"
1090
+ },
1091
+ "archive": {
1092
+ "type": "string"
1093
+ },
1094
+ "archiveLocation": {
1095
+ "type": "string"
1096
+ },
1097
+ "callNumber": {
1098
+ "type": "string"
1099
+ },
1100
+ "libraryCatalog": {
1101
+ "type": "string"
1102
+ },
1103
+ "rights": {
1104
+ "type": "string"
1105
+ },
1106
+ "scale": {
1107
+ "type": "string"
1108
+ },
1109
+ "seriesTitle": {
1110
+ "type": "string"
1111
+ },
1112
+ "type": {
1113
+ "type": "string"
1114
+ },
1115
+ "itemType": {
1116
+ "const": "map"
1117
+ }
1118
+ },
1119
+ "required": ["itemType"]
1120
+ },
1121
+ {
1122
+ "properties": {
1123
+ "abstractNote": {
1124
+ "type": "string"
1125
+ },
1126
+ "accessDate": {
1127
+ "type": "string"
1128
+ },
1129
+ "archive": {
1130
+ "type": "string"
1131
+ },
1132
+ "archiveLocation": {
1133
+ "type": "string"
1134
+ },
1135
+ "callNumber": {
1136
+ "type": "string"
1137
+ },
1138
+ "libraryCatalog": {
1139
+ "type": "string"
1140
+ },
1141
+ "publicationTitle": {
1142
+ "type": "string"
1143
+ },
1144
+ "rights": {
1145
+ "type": "string"
1146
+ },
1147
+ "section": {
1148
+ "type": "string"
1149
+ },
1150
+ "itemType": {
1151
+ "const": "newspaperArticle"
1152
+ }
1153
+ },
1154
+ "required": ["itemType"]
1155
+ },
1156
+ {
1157
+ "properties": {
1158
+ "abstractNote": {
1159
+ "type": "string"
1160
+ },
1161
+ "accessDate": {
1162
+ "type": "string"
1163
+ },
1164
+ "applicationNumber": {
1165
+ "type": "string"
1166
+ },
1167
+ "assignee": {
1168
+ "type": "string"
1169
+ },
1170
+ "authority": {
1171
+ "type": "string"
1172
+ },
1173
+ "country": {
1174
+ "type": "string"
1175
+ },
1176
+ "filingDate": {
1177
+ "type": "string"
1178
+ },
1179
+ "number": {
1180
+ "type": "string"
1181
+ },
1182
+ "originalDate": {
1183
+ "type": "string"
1184
+ },
1185
+ "priorityNumbers": {
1186
+ "type": "string"
1187
+ },
1188
+ "references": {
1189
+ "type": "string"
1190
+ },
1191
+ "rights": {
1192
+ "type": "string"
1193
+ },
1194
+ "status": {
1195
+ "type": "string"
1196
+ },
1197
+ "itemType": {
1198
+ "const": "patent"
1199
+ }
1200
+ },
1201
+ "required": ["itemType"]
1202
+ },
1203
+ {
1204
+ "properties": {
1205
+ "abstractNote": {
1206
+ "type": "string"
1207
+ },
1208
+ "accessDate": {
1209
+ "type": "string"
1210
+ },
1211
+ "medium": {
1212
+ "type": "string"
1213
+ },
1214
+ "number": {
1215
+ "type": "string"
1216
+ },
1217
+ "rights": {
1218
+ "type": "string"
1219
+ },
1220
+ "runningTime": {
1221
+ "type": "string"
1222
+ },
1223
+ "seriesTitle": {
1224
+ "type": "string"
1225
+ },
1226
+ "itemType": {
1227
+ "const": "podcast"
1228
+ }
1229
+ },
1230
+ "required": ["itemType"]
1231
+ },
1232
+ {
1233
+ "properties": {
1234
+ "abstractNote": {
1235
+ "type": "string"
1236
+ },
1237
+ "accessDate": {
1238
+ "type": "string"
1239
+ },
1240
+ "archive": {
1241
+ "type": "string"
1242
+ },
1243
+ "archiveLocation": {
1244
+ "type": "string"
1245
+ },
1246
+ "callNumber": {
1247
+ "type": "string"
1248
+ },
1249
+ "libraryCatalog": {
1250
+ "type": "string"
1251
+ },
1252
+ "number": {
1253
+ "type": "string"
1254
+ },
1255
+ "rights": {
1256
+ "type": "string"
1257
+ },
1258
+ "series": {
1259
+ "type": "string"
1260
+ },
1261
+ "seriesNumber": {
1262
+ "type": "string"
1263
+ },
1264
+ "type": {
1265
+ "type": "string"
1266
+ },
1267
+ "itemType": {
1268
+ "const": "preprint"
1269
+ }
1270
+ },
1271
+ "required": ["itemType"]
1272
+ },
1273
+ {
1274
+ "properties": {
1275
+ "abstractNote": {
1276
+ "type": "string"
1277
+ },
1278
+ "accessDate": {
1279
+ "type": "string"
1280
+ },
1281
+ "meetingName": {
1282
+ "type": "string"
1283
+ },
1284
+ "publicationTitle": {
1285
+ "type": "string"
1286
+ },
1287
+ "rights": {
1288
+ "type": "string"
1289
+ },
1290
+ "series": {
1291
+ "type": "string"
1292
+ },
1293
+ "type": {
1294
+ "type": "string"
1295
+ },
1296
+ "itemType": {
1297
+ "const": "presentation"
1298
+ }
1299
+ },
1300
+ "required": ["itemType"]
1301
+ },
1302
+ {
1303
+ "properties": {
1304
+ "abstractNote": {
1305
+ "type": "string"
1306
+ },
1307
+ "accessDate": {
1308
+ "type": "string"
1309
+ },
1310
+ "archive": {
1311
+ "type": "string"
1312
+ },
1313
+ "archiveLocation": {
1314
+ "type": "string"
1315
+ },
1316
+ "callNumber": {
1317
+ "type": "string"
1318
+ },
1319
+ "libraryCatalog": {
1320
+ "type": "string"
1321
+ },
1322
+ "medium": {
1323
+ "type": "string"
1324
+ },
1325
+ "number": {
1326
+ "type": "string"
1327
+ },
1328
+ "publicationTitle": {
1329
+ "type": "string"
1330
+ },
1331
+ "rights": {
1332
+ "type": "string"
1333
+ },
1334
+ "runningTime": {
1335
+ "type": "string"
1336
+ },
1337
+ "itemType": {
1338
+ "const": "radioBroadcast"
1339
+ }
1340
+ },
1341
+ "required": ["itemType"]
1342
+ },
1343
+ {
1344
+ "properties": {
1345
+ "abstractNote": {
1346
+ "type": "string"
1347
+ },
1348
+ "accessDate": {
1349
+ "type": "string"
1350
+ },
1351
+ "archive": {
1352
+ "type": "string"
1353
+ },
1354
+ "archiveLocation": {
1355
+ "type": "string"
1356
+ },
1357
+ "callNumber": {
1358
+ "type": "string"
1359
+ },
1360
+ "libraryCatalog": {
1361
+ "type": "string"
1362
+ },
1363
+ "number": {
1364
+ "type": "string"
1365
+ },
1366
+ "rights": {
1367
+ "type": "string"
1368
+ },
1369
+ "seriesNumber": {
1370
+ "type": "string"
1371
+ },
1372
+ "seriesTitle": {
1373
+ "type": "string"
1374
+ },
1375
+ "type": {
1376
+ "type": "string"
1377
+ },
1378
+ "itemType": {
1379
+ "const": "report"
1380
+ }
1381
+ },
1382
+ "required": ["itemType"]
1383
+ },
1384
+ {
1385
+ "properties": {
1386
+ "abstractNote": {
1387
+ "type": "string"
1388
+ },
1389
+ "accessDate": {
1390
+ "type": "string"
1391
+ },
1392
+ "archive": {
1393
+ "type": "string"
1394
+ },
1395
+ "archiveLocation": {
1396
+ "type": "string"
1397
+ },
1398
+ "authority": {
1399
+ "type": "string"
1400
+ },
1401
+ "callNumber": {
1402
+ "type": "string"
1403
+ },
1404
+ "committee": {
1405
+ "type": "string"
1406
+ },
1407
+ "libraryCatalog": {
1408
+ "type": "string"
1409
+ },
1410
+ "numPages": {
1411
+ "type": "string"
1412
+ },
1413
+ "number": {
1414
+ "type": "string"
1415
+ },
1416
+ "partNumber": {
1417
+ "type": "string"
1418
+ },
1419
+ "partTitle": {
1420
+ "type": "string"
1421
+ },
1422
+ "rights": {
1423
+ "type": "string"
1424
+ },
1425
+ "status": {
1426
+ "type": "string"
1427
+ },
1428
+ "type": {
1429
+ "type": "string"
1430
+ },
1431
+ "versionNumber": {
1432
+ "type": "string"
1433
+ },
1434
+ "itemType": {
1435
+ "const": "standard"
1436
+ }
1437
+ },
1438
+ "required": ["itemType"]
1439
+ },
1440
+ {
1441
+ "properties": {
1442
+ "abstractNote": {
1443
+ "type": "string"
1444
+ },
1445
+ "accessDate": {
1446
+ "type": "string"
1447
+ },
1448
+ "code": {
1449
+ "type": "string"
1450
+ },
1451
+ "codeNumber": {
1452
+ "type": "string"
1453
+ },
1454
+ "history": {
1455
+ "type": "string"
1456
+ },
1457
+ "number": {
1458
+ "type": "string"
1459
+ },
1460
+ "rights": {
1461
+ "type": "string"
1462
+ },
1463
+ "section": {
1464
+ "type": "string"
1465
+ },
1466
+ "session": {
1467
+ "type": "string"
1468
+ },
1469
+ "itemType": {
1470
+ "const": "statute"
1471
+ }
1472
+ },
1473
+ "required": ["itemType"]
1474
+ },
1475
+ {
1476
+ "properties": {
1477
+ "abstractNote": {
1478
+ "type": "string"
1479
+ },
1480
+ "accessDate": {
1481
+ "type": "string"
1482
+ },
1483
+ "archive": {
1484
+ "type": "string"
1485
+ },
1486
+ "archiveLocation": {
1487
+ "type": "string"
1488
+ },
1489
+ "callNumber": {
1490
+ "type": "string"
1491
+ },
1492
+ "libraryCatalog": {
1493
+ "type": "string"
1494
+ },
1495
+ "numPages": {
1496
+ "type": "string"
1497
+ },
1498
+ "rights": {
1499
+ "type": "string"
1500
+ },
1501
+ "series": {
1502
+ "type": "string"
1503
+ },
1504
+ "seriesNumber": {
1505
+ "type": "string"
1506
+ },
1507
+ "type": {
1508
+ "type": "string"
1509
+ },
1510
+ "itemType": {
1511
+ "const": "thesis"
1512
+ }
1513
+ },
1514
+ "required": ["itemType"]
1515
+ },
1516
+ {
1517
+ "properties": {
1518
+ "abstractNote": {
1519
+ "type": "string"
1520
+ },
1521
+ "accessDate": {
1522
+ "type": "string"
1523
+ },
1524
+ "archive": {
1525
+ "type": "string"
1526
+ },
1527
+ "archiveLocation": {
1528
+ "type": "string"
1529
+ },
1530
+ "callNumber": {
1531
+ "type": "string"
1532
+ },
1533
+ "libraryCatalog": {
1534
+ "type": "string"
1535
+ },
1536
+ "medium": {
1537
+ "type": "string"
1538
+ },
1539
+ "number": {
1540
+ "type": "string"
1541
+ },
1542
+ "publicationTitle": {
1543
+ "type": "string"
1544
+ },
1545
+ "rights": {
1546
+ "type": "string"
1547
+ },
1548
+ "runningTime": {
1549
+ "type": "string"
1550
+ },
1551
+ "itemType": {
1552
+ "const": "tvBroadcast"
1553
+ }
1554
+ },
1555
+ "required": ["itemType"]
1556
+ },
1557
+ {
1558
+ "properties": {
1559
+ "abstractNote": {
1560
+ "type": "string"
1561
+ },
1562
+ "accessDate": {
1563
+ "type": "string"
1564
+ },
1565
+ "archive": {
1566
+ "type": "string"
1567
+ },
1568
+ "archiveLocation": {
1569
+ "type": "string"
1570
+ },
1571
+ "callNumber": {
1572
+ "type": "string"
1573
+ },
1574
+ "libraryCatalog": {
1575
+ "type": "string"
1576
+ },
1577
+ "medium": {
1578
+ "type": "string"
1579
+ },
1580
+ "numberOfVolumes": {
1581
+ "type": "string"
1582
+ },
1583
+ "rights": {
1584
+ "type": "string"
1585
+ },
1586
+ "runningTime": {
1587
+ "type": "string"
1588
+ },
1589
+ "seriesTitle": {
1590
+ "type": "string"
1591
+ },
1592
+ "itemType": {
1593
+ "const": "videoRecording"
1594
+ }
1595
+ },
1596
+ "required": ["itemType"]
1597
+ },
1598
+ {
1599
+ "properties": {
1600
+ "abstractNote": {
1601
+ "type": "string"
1602
+ },
1603
+ "accessDate": {
1604
+ "type": "string"
1605
+ },
1606
+ "publicationTitle": {
1607
+ "type": "string"
1608
+ },
1609
+ "rights": {
1610
+ "type": "string"
1611
+ },
1612
+ "type": {
1613
+ "type": "string"
1614
+ },
1615
+ "itemType": {
1616
+ "const": "webpage"
1617
+ }
1618
+ },
1619
+ "required": ["itemType"]
1620
+ }
1621
+ ],
1622
+ "unevaluatedProperties": false
1623
+ },
1624
+ "TemplateCollection": {
1625
+ "description": "A Zotero collection an item belongs to, in the template vocabulary. Coerces to `name` in string contexts (like a tag coerces to its name).",
1626
+ "type": "object",
1627
+ "properties": {
1628
+ "key": {
1629
+ "type": "string",
1630
+ "description": "Zotero collection key."
1631
+ },
1632
+ "name": {
1633
+ "type": "string",
1634
+ "description": "Collection name."
1635
+ },
1636
+ "path": {
1637
+ "type": "array",
1638
+ "items": {
1639
+ "type": "string"
1640
+ },
1641
+ "description": "Ancestor chain from top-level root to this collection: `path[0]` is the top-level ancestor, `path[path.length - 1]` is this collection. A plain array — render with `path.join(\" > \")` (or `\"/\"` for filename folders), or pipe the collection list through the `collection_paths` filter, which joins each full ancestor path by a separator (`\"/\"` by default)."
1642
+ }
1643
+ },
1644
+ "required": ["key", "name", "path"],
1645
+ "additionalProperties": false
1646
+ },
1647
+ "TemplateCreator": {
1648
+ "description": "One creator of an item, in the template vocabulary. Coerces to `TemplateCreator.fullName` in string contexts.",
1649
+ "type": "object",
1650
+ "properties": {
1651
+ "family": {
1652
+ "type": "string",
1653
+ "description": "Family / last name; empty for institutional creators."
1654
+ },
1655
+ "given": {
1656
+ "type": "string",
1657
+ "description": "Given / first name; empty for institutional creators."
1658
+ },
1659
+ "literal": {
1660
+ "type": ["string", "null"],
1661
+ "description": "Full name for institutional / single-name authors (Zotero `fieldMode=1`); `null` for personal names."
1662
+ },
1663
+ "role": {
1664
+ "type": "string",
1665
+ "description": "Zotero creator type: `\"author\"`, `\"editor\"`, `\"translator\"`, etc."
1666
+ },
1667
+ "fullName": {
1668
+ "type": "string",
1669
+ "description": "`literal` for institutional creators, `\"given family\"` for personal names."
1670
+ }
1671
+ },
1672
+ "required": ["family", "given", "literal", "role", "fullName"],
1673
+ "additionalProperties": false
1674
+ },
1675
+ "TemplateTag": {
1676
+ "description": "A Tag in the template vocabulary. Coerces to `name` in string contexts (like a collection coerces to its name), so `{{ zt.tags | join: \", \" }}` renders tag names directly. Zotero-internal IDs are dropped; `type` is the resolved name rather than Zotero's raw int.",
1677
+ "type": "object",
1678
+ "properties": {
1679
+ "name": {
1680
+ "type": "string",
1681
+ "description": "Tag name as shown in Zotero."
1682
+ },
1683
+ "type": {
1684
+ "enum": ["manual", "auto", "unknown"],
1685
+ "description": "`\"manual\"` for a hand-added tag, `\"auto\"` for an automatic one (a translator or plugin attached it while saving or importing); `\"unknown\"` for a type id Zotero added after this mapping was written."
1686
+ }
1687
+ },
1688
+ "required": ["name", "type"],
1689
+ "additionalProperties": false
1690
+ },
1691
+ "ItemDateYMD": {
1692
+ "description": "Full Y/M/D date parsed into a `Temporal.PlainDate`.",
1693
+ "type": "object",
1694
+ "properties": {
1695
+ "kind": {
1696
+ "const": "date",
1697
+ "description": "Discriminator for the full-precision variant."
1698
+ },
1699
+ "value": {
1700
+ "type": "string",
1701
+ "description": "The parsed calendar date."
1702
+ },
1703
+ "year": {
1704
+ "type": "number",
1705
+ "description": "Numeric year."
1706
+ },
1707
+ "month": {
1708
+ "type": "number",
1709
+ "description": "Month, 1-12."
1710
+ },
1711
+ "day": {
1712
+ "type": "number",
1713
+ "description": "Day of month."
1714
+ },
1715
+ "raw": {
1716
+ "type": "string",
1717
+ "description": "The stored Zotero `date` value verbatim, retained for round-tripping."
1718
+ }
1719
+ },
1720
+ "required": ["kind", "value", "year", "month", "day", "raw"],
1721
+ "additionalProperties": false
1722
+ },
1723
+ "ItemDateYearMonth": {
1724
+ "description": "Year and month only; `Temporal.PlainYearMonth` (no day).",
1725
+ "type": "object",
1726
+ "properties": {
1727
+ "kind": {
1728
+ "const": "yearMonth",
1729
+ "description": "Discriminator for the year-and-month variant."
1730
+ },
1731
+ "value": {
1732
+ "type": "string",
1733
+ "description": "The parsed year and month."
1734
+ },
1735
+ "year": {
1736
+ "type": "number",
1737
+ "description": "Numeric year."
1738
+ },
1739
+ "month": {
1740
+ "type": "number",
1741
+ "description": "Month, 1-12."
1742
+ },
1743
+ "day": {
1744
+ "type": "null",
1745
+ "description": "Always `null` — this variant carries no day."
1746
+ },
1747
+ "raw": {
1748
+ "type": "string",
1749
+ "description": "The stored Zotero `date` value verbatim, retained for round-tripping."
1750
+ }
1751
+ },
1752
+ "required": ["kind", "value", "year", "month", "day", "raw"],
1753
+ "additionalProperties": false
1754
+ },
1755
+ "ItemDateYear": {
1756
+ "description": "Year only. Also covers Zotero's `01 2003` misparse where the user-string day is meaningful but month is missing (the spurious day is dropped since no `Temporal` type fits \"year + day without month\").",
1757
+ "type": "object",
1758
+ "properties": {
1759
+ "kind": {
1760
+ "const": "year",
1761
+ "description": "Discriminator for the year-only variant."
1762
+ },
1763
+ "value": {
1764
+ "type": "null",
1765
+ "description": "Always `null` — no `Temporal` type holds a bare year."
1766
+ },
1767
+ "year": {
1768
+ "type": "number",
1769
+ "description": "Numeric year."
1770
+ },
1771
+ "month": {
1772
+ "type": "null",
1773
+ "description": "Always `null` — the month is missing or unparseable."
1774
+ },
1775
+ "day": {
1776
+ "type": "null",
1777
+ "description": "Always `null` — this variant carries no day."
1778
+ },
1779
+ "raw": {
1780
+ "type": "string",
1781
+ "description": "The stored Zotero `date` value verbatim, retained for round-tripping."
1782
+ }
1783
+ },
1784
+ "required": ["kind", "value", "year", "month", "day", "raw"],
1785
+ "additionalProperties": false
1786
+ },
1787
+ "ItemDateText": {
1788
+ "description": "Unparseable / text-only: the year is missing or the SQL prefix is absent.",
1789
+ "type": "object",
1790
+ "properties": {
1791
+ "kind": {
1792
+ "const": "text",
1793
+ "description": "Discriminator for the text variant."
1794
+ },
1795
+ "value": {
1796
+ "type": "null",
1797
+ "description": "Always `null` — nothing parsed, so there is no `Temporal` value."
1798
+ },
1799
+ "text": {
1800
+ "type": "string",
1801
+ "description": "The renderable user portion, or the entire raw value when non-multipart."
1802
+ },
1803
+ "year": {
1804
+ "type": ["number", "null"],
1805
+ "description": "Year extracted from `ItemDateText.text` when it holds a standalone 4-digit year in the 1000-2999 range, else `null`."
1806
+ },
1807
+ "month": {
1808
+ "type": "null",
1809
+ "description": "Always `null` — the text variant resolves no month."
1810
+ },
1811
+ "day": {
1812
+ "type": "null",
1813
+ "description": "Always `null` — the text variant resolves no day."
1814
+ },
1815
+ "raw": {
1816
+ "type": "string",
1817
+ "description": "The stored Zotero `date` value verbatim, retained for round-tripping."
1818
+ }
1819
+ },
1820
+ "required": ["kind", "value", "text", "year", "month", "day", "raw"],
1821
+ "additionalProperties": false
1822
+ },
1823
+ "ItemExtra": {
1824
+ "description": "Best-effort structured view of Zotero's `extra` field. Plain data so it is directly indexable in Liquid, Eta, and JS.\n\n`toString` is non-enumerable, so a spread, `JSON.stringify`, or `Object.keys` sees the three data properties alone.",
1825
+ "type": "object",
1826
+ "properties": {
1827
+ "raw": {
1828
+ "type": "string",
1829
+ "description": "Original field text verbatim, for a full round-trip."
1830
+ },
1831
+ "fields": {
1832
+ "type": "object",
1833
+ "additionalProperties": {
1834
+ "type": "string"
1835
+ },
1836
+ "description": "First value per key — the common-case lookup, e.g. `zt.extra.fields[\"tex.mendeley-tags\"]`. First-wins: a repeated key keeps its first occurrence."
1837
+ },
1838
+ "lines": {
1839
+ "type": "array",
1840
+ "items": {
1841
+ "$ref": "#/$defs/ExtraLine"
1842
+ },
1843
+ "description": "Every source row in order, the source of truth `ItemExtra.fields` derives from. Scan it to recover every value of a repeated key."
1844
+ }
1845
+ },
1846
+ "required": ["raw", "fields", "lines"],
1847
+ "additionalProperties": false
1848
+ },
1849
+ "ExtraLine": {
1850
+ "anyOf": [
1851
+ {
1852
+ "type": "object",
1853
+ "properties": {
1854
+ "raw": {
1855
+ "type": "string",
1856
+ "description": "Verbatim source line."
1857
+ },
1858
+ "key": {
1859
+ "type": "string",
1860
+ "description": "Parsed key, trimmed."
1861
+ },
1862
+ "value": {
1863
+ "type": "string",
1864
+ "description": "Parsed value, trimmed; always non-empty on a pair row."
1865
+ }
1866
+ },
1867
+ "required": ["raw", "key", "value"],
1868
+ "additionalProperties": false
1869
+ },
1870
+ {
1871
+ "type": "object",
1872
+ "properties": {
1873
+ "raw": {
1874
+ "type": "string",
1875
+ "description": "Verbatim source line."
1876
+ },
1877
+ "key": {
1878
+ "type": "null",
1879
+ "description": "Always `null` — prose, blank, and empty-value rows carry no key."
1880
+ }
1881
+ },
1882
+ "required": ["raw", "key"],
1883
+ "additionalProperties": false
1884
+ }
1885
+ ],
1886
+ "description": "One source row of an Extra field, in document order: a parsed pair (`key` plus trimmed `value`) or a non-pair text/blank row (`key: null`). `raw` is the verbatim line so interleaved prose is never dropped.\n\nA line splits on its first `:` or `=`, and is a pair only when the key starts with an ASCII letter and otherwise holds ASCII letters, digits, spaces, dots, hyphens, or underscores. A line that does not match, and one whose value is empty, becomes a text row.\n\nA non-enumerable `toString` returns `raw`, as on the extra field itself."
1887
+ }
1888
+ }
1889
+ }