xref: /webtrees/app/Gedcom.php (revision 80e6d9499c9b061cec580edbcd89ec8e02d06243)
1<?php
2
3/**
4 * webtrees: online genealogy
5 * Copyright (C) 2022 webtrees development team
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <https://www.gnu.org/licenses/>.
16 */
17
18declare(strict_types=1);
19
20namespace Fisharebest\Webtrees;
21
22use Fisharebest\Webtrees\Contracts\ElementFactoryInterface;
23use Fisharebest\Webtrees\Contracts\ElementInterface;
24use Fisharebest\Webtrees\Elements\AddressCity;
25use Fisharebest\Webtrees\Elements\AddressCountry;
26use Fisharebest\Webtrees\Elements\AddressEmail;
27use Fisharebest\Webtrees\Elements\AddressFax;
28use Fisharebest\Webtrees\Elements\AddressLine;
29use Fisharebest\Webtrees\Elements\AddressLine1;
30use Fisharebest\Webtrees\Elements\AddressLine2;
31use Fisharebest\Webtrees\Elements\AddressLine3;
32use Fisharebest\Webtrees\Elements\AddressPostalCode;
33use Fisharebest\Webtrees\Elements\AddressState;
34use Fisharebest\Webtrees\Elements\AddressWebPage;
35use Fisharebest\Webtrees\Elements\AdoptedByWhichParent;
36use Fisharebest\Webtrees\Elements\Adoption;
37use Fisharebest\Webtrees\Elements\AdultChristening;
38use Fisharebest\Webtrees\Elements\AgeAtEvent;
39use Fisharebest\Webtrees\Elements\AncestralFileNumber;
40use Fisharebest\Webtrees\Elements\Annulment;
41use Fisharebest\Webtrees\Elements\ApprovedSystemId;
42use Fisharebest\Webtrees\Elements\AutomatedRecordId;
43use Fisharebest\Webtrees\Elements\Baptism;
44use Fisharebest\Webtrees\Elements\BarMitzvah;
45use Fisharebest\Webtrees\Elements\BasMitzvah;
46use Fisharebest\Webtrees\Elements\Birth;
47use Fisharebest\Webtrees\Elements\Blessing;
48use Fisharebest\Webtrees\Elements\Burial;
49use Fisharebest\Webtrees\Elements\CasteName;
50use Fisharebest\Webtrees\Elements\CauseOfEvent;
51use Fisharebest\Webtrees\Elements\Census;
52use Fisharebest\Webtrees\Elements\CertaintyAssessment;
53use Fisharebest\Webtrees\Elements\Change;
54use Fisharebest\Webtrees\Elements\ChangeDate;
55use Fisharebest\Webtrees\Elements\CharacterSet;
56use Fisharebest\Webtrees\Elements\ChildLinkageStatus;
57use Fisharebest\Webtrees\Elements\Christening;
58use Fisharebest\Webtrees\Elements\Confirmation;
59use Fisharebest\Webtrees\Elements\ContentDescription;
60use Fisharebest\Webtrees\Elements\Coordinates;
61use Fisharebest\Webtrees\Elements\CopyrightFile;
62use Fisharebest\Webtrees\Elements\CopyrightSourceData;
63use Fisharebest\Webtrees\Elements\CountOfChildren;
64use Fisharebest\Webtrees\Elements\CountOfMarriages;
65use Fisharebest\Webtrees\Elements\Cremation;
66use Fisharebest\Webtrees\Elements\CustomElement;
67use Fisharebest\Webtrees\Elements\CustomEvent;
68use Fisharebest\Webtrees\Elements\CustomFact;
69use Fisharebest\Webtrees\Elements\CustomFamilyEvent;
70use Fisharebest\Webtrees\Elements\CustomIndividualEvent;
71use Fisharebest\Webtrees\Elements\DateLdsOrd;
72use Fisharebest\Webtrees\Elements\DateValue;
73use Fisharebest\Webtrees\Elements\Death;
74use Fisharebest\Webtrees\Elements\DescriptiveTitle;
75use Fisharebest\Webtrees\Elements\Divorce;
76use Fisharebest\Webtrees\Elements\DivorceFiled;
77use Fisharebest\Webtrees\Elements\Emigration;
78use Fisharebest\Webtrees\Elements\EmptyElement;
79use Fisharebest\Webtrees\Elements\Engagement;
80use Fisharebest\Webtrees\Elements\EntryRecordingDate;
81use Fisharebest\Webtrees\Elements\EventAttributeType;
82use Fisharebest\Webtrees\Elements\EventOrFactClassification;
83use Fisharebest\Webtrees\Elements\EventsRecorded;
84use Fisharebest\Webtrees\Elements\EventTypeCitedFrom;
85use Fisharebest\Webtrees\Elements\FamilyCensus;
86use Fisharebest\Webtrees\Elements\FamilyRecord;
87use Fisharebest\Webtrees\Elements\FamilyResidence;
88use Fisharebest\Webtrees\Elements\FamilySearchFamilyTreeId;
89use Fisharebest\Webtrees\Elements\FamilyStatusText;
90use Fisharebest\Webtrees\Elements\FileName;
91use Fisharebest\Webtrees\Elements\FirstCommunion;
92use Fisharebest\Webtrees\Elements\Form;
93use Fisharebest\Webtrees\Elements\GedcomElement;
94use Fisharebest\Webtrees\Elements\GenerationsOfAncestors;
95use Fisharebest\Webtrees\Elements\GenerationsOfDescendants;
96use Fisharebest\Webtrees\Elements\GovIdentifier;
97use Fisharebest\Webtrees\Elements\Graduation;
98use Fisharebest\Webtrees\Elements\HeaderRecord;
99use Fisharebest\Webtrees\Elements\HierarchicalRelationship;
100use Fisharebest\Webtrees\Elements\Immigration;
101use Fisharebest\Webtrees\Elements\IndividualRecord;
102use Fisharebest\Webtrees\Elements\LanguageId;
103use Fisharebest\Webtrees\Elements\LdsBaptism;
104use Fisharebest\Webtrees\Elements\LdsBaptismDateStatus;
105use Fisharebest\Webtrees\Elements\LdsChildSealing;
106use Fisharebest\Webtrees\Elements\LdsChildSealingDateStatus;
107use Fisharebest\Webtrees\Elements\LdsConfirmation;
108use Fisharebest\Webtrees\Elements\LdsEndowment;
109use Fisharebest\Webtrees\Elements\LdsEndowmentDateStatus;
110use Fisharebest\Webtrees\Elements\LdsSpouseSealing;
111use Fisharebest\Webtrees\Elements\LdsSpouseSealingDateStatus;
112use Fisharebest\Webtrees\Elements\LocationRecord;
113use Fisharebest\Webtrees\Elements\MaidenheadLocator;
114use Fisharebest\Webtrees\Elements\Marriage;
115use Fisharebest\Webtrees\Elements\MarriageBanns;
116use Fisharebest\Webtrees\Elements\MarriageContract;
117use Fisharebest\Webtrees\Elements\MarriageLicence;
118use Fisharebest\Webtrees\Elements\MarriageSettlement;
119use Fisharebest\Webtrees\Elements\MarriageType;
120use Fisharebest\Webtrees\Elements\MediaRecord;
121use Fisharebest\Webtrees\Elements\MultimediaFileReference;
122use Fisharebest\Webtrees\Elements\MultimediaFormat;
123use Fisharebest\Webtrees\Elements\NameOfBusiness;
124use Fisharebest\Webtrees\Elements\NameOfFamilyFile;
125use Fisharebest\Webtrees\Elements\NameOfProduct;
126use Fisharebest\Webtrees\Elements\NameOfRepository;
127use Fisharebest\Webtrees\Elements\NameOfSourceData;
128use Fisharebest\Webtrees\Elements\NamePersonal;
129use Fisharebest\Webtrees\Elements\NamePhoneticVariation;
130use Fisharebest\Webtrees\Elements\NamePieceGiven;
131use Fisharebest\Webtrees\Elements\NamePieceNickname;
132use Fisharebest\Webtrees\Elements\NamePiecePrefix;
133use Fisharebest\Webtrees\Elements\NamePieceSuffix;
134use Fisharebest\Webtrees\Elements\NamePieceSurname;
135use Fisharebest\Webtrees\Elements\NamePieceSurnamePrefix;
136use Fisharebest\Webtrees\Elements\NameRomanizedVariation;
137use Fisharebest\Webtrees\Elements\NameType;
138use Fisharebest\Webtrees\Elements\NationalIdNumber;
139use Fisharebest\Webtrees\Elements\NationOrTribalOrigin;
140use Fisharebest\Webtrees\Elements\Naturalization;
141use Fisharebest\Webtrees\Elements\NobilityTypeTitle;
142use Fisharebest\Webtrees\Elements\NoteRecord;
143use Fisharebest\Webtrees\Elements\NoteStructure;
144use Fisharebest\Webtrees\Elements\Occupation;
145use Fisharebest\Webtrees\Elements\OrdinanceProcessFlag;
146use Fisharebest\Webtrees\Elements\Ordination;
147use Fisharebest\Webtrees\Elements\PafUid;
148use Fisharebest\Webtrees\Elements\PedigreeLinkageType;
149use Fisharebest\Webtrees\Elements\PermanentRecordFileNumber;
150use Fisharebest\Webtrees\Elements\PhoneNumber;
151use Fisharebest\Webtrees\Elements\PhoneticType;
152use Fisharebest\Webtrees\Elements\PhysicalDescription;
153use Fisharebest\Webtrees\Elements\PlaceHierarchy;
154use Fisharebest\Webtrees\Elements\PlaceLatitude;
155use Fisharebest\Webtrees\Elements\PlaceLivingOrdinance;
156use Fisharebest\Webtrees\Elements\PlaceLongtitude;
157use Fisharebest\Webtrees\Elements\PlaceName;
158use Fisharebest\Webtrees\Elements\PlacePhoneticVariation;
159use Fisharebest\Webtrees\Elements\PlaceRomanizedVariation;
160use Fisharebest\Webtrees\Elements\Possessions;
161use Fisharebest\Webtrees\Elements\Probate;
162use Fisharebest\Webtrees\Elements\PublicationDate;
163use Fisharebest\Webtrees\Elements\ReceivingSystemName;
164use Fisharebest\Webtrees\Elements\RelationIsDescriptor;
165use Fisharebest\Webtrees\Elements\ReligiousAffiliation;
166use Fisharebest\Webtrees\Elements\RepositoryRecord;
167use Fisharebest\Webtrees\Elements\ResearchTask;
168use Fisharebest\Webtrees\Elements\ResearchTaskPriority;
169use Fisharebest\Webtrees\Elements\ResearchTaskStatus;
170use Fisharebest\Webtrees\Elements\ResearchTaskType;
171use Fisharebest\Webtrees\Elements\Residence;
172use Fisharebest\Webtrees\Elements\ResponsibleAgency;
173use Fisharebest\Webtrees\Elements\RestrictionNotice;
174use Fisharebest\Webtrees\Elements\Retirement;
175use Fisharebest\Webtrees\Elements\RoleInEvent;
176use Fisharebest\Webtrees\Elements\RomanizedType;
177use Fisharebest\Webtrees\Elements\ScholasticAchievement;
178use Fisharebest\Webtrees\Elements\SexValue;
179use Fisharebest\Webtrees\Elements\SexXValue;
180use Fisharebest\Webtrees\Elements\SocialSecurityNumber;
181use Fisharebest\Webtrees\Elements\SourceCallNumber;
182use Fisharebest\Webtrees\Elements\SourceData;
183use Fisharebest\Webtrees\Elements\SourceFiledByEntry;
184use Fisharebest\Webtrees\Elements\SourceJurisdictionPlace;
185use Fisharebest\Webtrees\Elements\SourceMediaType;
186use Fisharebest\Webtrees\Elements\SourceOriginator;
187use Fisharebest\Webtrees\Elements\SourcePublicationFacts;
188use Fisharebest\Webtrees\Elements\SourceRecord;
189use Fisharebest\Webtrees\Elements\SubmissionRecord;
190use Fisharebest\Webtrees\Elements\SubmitterName;
191use Fisharebest\Webtrees\Elements\SubmitterRecord;
192use Fisharebest\Webtrees\Elements\SubmitterRegisteredRfn;
193use Fisharebest\Webtrees\Elements\SubmitterText;
194use Fisharebest\Webtrees\Elements\TempleCode;
195use Fisharebest\Webtrees\Elements\TextFromSource;
196use Fisharebest\Webtrees\Elements\TimeValue;
197use Fisharebest\Webtrees\Elements\TransmissionDate;
198use Fisharebest\Webtrees\Elements\UserReferenceNumber;
199use Fisharebest\Webtrees\Elements\UserReferenceType;
200use Fisharebest\Webtrees\Elements\VersionNumber;
201use Fisharebest\Webtrees\Elements\WebtreesUser;
202use Fisharebest\Webtrees\Elements\WhereWithinSource;
203use Fisharebest\Webtrees\Elements\Will;
204use Fisharebest\Webtrees\Elements\XrefAssociate;
205use Fisharebest\Webtrees\Elements\XrefFamily;
206use Fisharebest\Webtrees\Elements\XrefIndividual;
207use Fisharebest\Webtrees\Elements\XrefLocation;
208use Fisharebest\Webtrees\Elements\XrefMedia;
209use Fisharebest\Webtrees\Elements\XrefRepository;
210use Fisharebest\Webtrees\Elements\XrefSource;
211use Fisharebest\Webtrees\Elements\XrefSubmission;
212use Fisharebest\Webtrees\Elements\XrefSubmitter;
213
214/**
215 * GEDCOM 5.5.1 specification
216 */
217class Gedcom
218{
219    // 255 less the EOL character.
220    public const LINE_LENGTH = 253;
221
222    // Gedcom tags which indicate the start of life.
223    public const BIRTH_EVENTS = ['BIRT', 'CHR', 'BAPM'];
224
225    // Gedcom tags which indicate the end of life.
226    public const DEATH_EVENTS = ['DEAT', 'BURI', 'CREM'];
227
228    // Gedcom tags which indicate the start of a relationship.
229    public const MARRIAGE_EVENTS = ['MARR', '_NMR'];
230
231    // Gedcom tags which indicate the end of a relationship.
232    public const DIVORCE_EVENTS = ['DIV', 'ANUL', '_SEPR'];
233
234    // Regular expression to match a GEDCOM tag.
235    public const REGEX_TAG = '[_A-Z][_A-Z0-9]*';
236
237    // Regular expression to match a GEDCOM XREF.
238    public const REGEX_XREF = '[A-Za-z0-9:_.-]{1,20}';
239
240    // Regular expression to match a GEDCOM fact/event
241    private const REGEX_VALUE   = '( .+)?';
242    private const REGEX_LEVEL_9 = '\n9 ' . self::REGEX_TAG . self::REGEX_VALUE;
243    private const REGEX_LEVEL_8 = '\n8 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_9 . ')*';
244    private const REGEX_LEVEL_7 = '\n7 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_8 . ')*';
245    private const REGEX_LEVEL_6 = '\n6 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_7 . ')*';
246    private const REGEX_LEVEL_5 = '\n5 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_6 . ')*';
247    private const REGEX_LEVEL_4 = '\n4 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_5 . ')*';
248    private const REGEX_LEVEL_3 = '\n3 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_4 . ')*';
249    private const REGEX_LEVEL_2 = '\n2 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_3 . ')*';
250    public const REGEX_FACT     = '1 ' . self::REGEX_TAG . self::REGEX_VALUE . '(' . self::REGEX_LEVEL_2 . ')*';
251
252    // Separates the parts of a place name.
253    public const PLACE_SEPARATOR = ', ';
254
255    // Regex to match a (badly formed) GEDCOM place separator.
256    public const PLACE_SEPARATOR_REGEX = '/ *,[, ]*/';
257
258    // LATI and LONG tags
259    public const LATITUDE_NORTH = 'N';
260    public const LATITUDE_SOUTH = 'S';
261    public const LONGITUDE_EAST = 'E';
262    public const LONGITUDE_WEST = 'W';
263
264    // Not all record types allow a CHAN event.
265    public const RECORDS_WITH_CHAN = [
266        Family::RECORD_TYPE,
267        Individual::RECORD_TYPE,
268        Media::RECORD_TYPE,
269        Note::RECORD_TYPE,
270        Repository::RECORD_TYPE,
271        Source::RECORD_TYPE,
272        Submitter::RECORD_TYPE,
273    ];
274
275    // These preferences control multiple tag definitions
276    public const HIDDEN_TAGS = [
277        // Individual names
278        'NAME_NPFX'  => ['INDI:NAME:NPFX', 'INDI:NAME:FONE:NPFX', 'INDI:NAME:ROMN:NPFX'],
279        'NAME_SPFX'  => ['INDI:NAME:SPFX', 'INDI:NAME:FONE:SPFX', 'INDI:NAME:ROMN:SPFX'],
280        'NAME_NSFX'  => ['INDI:NAME:NSFX', 'INDI:NAME:FONE:NSFX', 'INDI:NAME:ROMN:NSFX'],
281        'NAME_NICK'  => ['INDI:NAME:NICK', 'INDI:NAME:FONE:NICK', 'INDI:NAME:ROMN:NICK'],
282        'NAME_FONE'  => ['INDI:NAME:FONE'],
283        'NAME_ROMN'  => ['INDI:NAME:ROMN'],
284        'NAME_NOTE'  => ['INDI:NAME:NOTE'],
285        'NAME_SOUR'  => ['INDI:NAME:SOUR'],
286        // Places
287        'PLAC_MAP'   => [':PLAC:MAP'],
288        'PLAC_FONE'  => [':PLAC:FONE'],
289        'PLAC_ROMN'  => [':PLAC:ROMN'],
290        'PLAC_FORM'  => [':PLAC:FORM', 'HEAD:PLAC'],
291        'PLAC_NOTE'  => [':PLAC:NOTE'],
292        // Addresses
293        'ADDR_EMAIL' => [':EMAIL'],
294        'ADDR_PHON'  => [':PHON'],
295        'ADDR_WWW'   => [':WWW'],
296        // Source citations
297        'SOUR_EVEN'  => [':SOUR:EVEN'],
298        'SOUR_DATE'  => [':SOUR:DATA:DATE'],
299        'SOUR_NOTE'  => [':SOUR:NOTE'],
300        'SOUR_QUAY'  => [':SOUR:QUAY'],
301        // Sources
302        'SOUR_DATA'  => ['SOUR:DATA:EVEN', 'SOUR:DATA:AGNC', 'SOUR:DATA:NOTE'],
303        // Individuals
304        'BIRT_FAMC'  => ['INDI:BIRT:FAMC'],
305        'RELI'       => ['INDI:RELI'],
306        'BAPM'       => ['INDI:BAPM'],
307        'CHR'        => ['INDI:CHR', 'INDI:CHRA'],
308        'FCOM'       => ['INDI:FCOM', 'INDI:CONF'],
309        'ORDN'       => ['INDI:ORDN'],
310        'BARM'       => ['INDI:BARM', 'INDI:BASM'],
311        'ALIA'       => ['INDI:ALIA'],
312        'ASSO'       => ['INDI:ASSO'],
313        // Families
314        'ENGA'       => ['FAM:ENGA'],
315        'MARB'       => ['FAM:MARB'],
316        'MARC'       => ['FAM:MARC'],
317        'MARL'       => ['FAM:MARL'],
318        'MARS'       => ['FAM:MARS'],
319        'ANUL'       => ['FAM:ANUL'],
320        'DIVF'       => ['FAM:DIVF'],
321        'FAM_RESI'   => ['FAM:RESI'],
322        'FAM_CENS'   => ['FAM:CENS'],
323        // LDS church
324        'LDS'        => ['INDI:BAPL', 'INDI:CONL', 'INDI:ENDL', 'INDI:SLGC', 'FAM:SLGS', 'HEAD:SUBN'],
325        // Identifiers
326        'AFN'        => ['INDI:AFN'],
327        'IDNO'       => ['INDI:IDNO'],
328        'SSN'        => ['INDI:SSN'],
329        'RFN'        => [':RFN'],
330        'REFN'       => [':REFN'],
331        'RIN'        => [':RIN'],
332        // Submitters
333        'SUBM'       => ['INDI:SUBM', 'FAM:SUBM'],
334        'ANCI'       => ['INDI:ANCI', 'INDI:DESI'],
335    ];
336
337    // Custom GEDCOM tags that can be created in webtrees.
338    public const CUSTOM_FAMILY_TAGS = [
339        'FACT',
340        '_COML',
341        '_MARI',
342        '_MBON',
343        '_NMR',
344        '_SEPR',
345    ];
346
347    public const CUSTOM_INDIVIDUAL_TAGS = [
348        '_BRTM',
349        '_CIRC',
350        '_DEG',
351        '_DNA',
352        '_EXCM',
353        '_EYEC',
354        '_FNRL',
355        '_FSFTID',
356        '_HAIR',
357        '_HEIG',
358        '_INTE',
359        '_MDCL',
360        '_MEDC',
361        '_MILI',
362        '_MILT',
363        '_NAMS',
364        '_PRMN',
365        '_WEIG',
366        '_YART',
367    ];
368
369    // Some applications create GEDCOM files containing records without XREFS.
370    // We cannot process these.
371    public const CUSTOM_RECORDS_WITHOUT_XREFS = [
372        'EMOTIONALRELATIONSHIP', // GenoPro
373        'GENOMAP', // GenoPro
374        'GLOBAL', // GenoPro
375        'LABEL', // GenoPro
376        'PEDIGREELINK', // GenoPro
377        'SOCIALRELATIONSHIP', // GenoPro
378        '_EVDEF', // RootsMagic
379        '_EVENT_DEFN', // PAF and Legacy
380        '_HASHTAG_DEFN', // Legacy
381        '_PUBLISH', // MyHeritage
382        '_TODO', // Legacy
383    ];
384
385    /**
386     * Definitions for GEDCOM 5.5.1.
387     *
388     * @return array<string,ElementInterface>
389     */
390    private function gedcom551Tags(): array
391    {
392        return [
393            'FAM'                      => new FamilyRecord(I18N::translate('Family')),
394            'FAM:*:ADDR'               => new AddressLine(I18N::translate('Address')),
395            'FAM:*:ADDR:ADR1'          => new AddressLine1(I18N::translate('Address line 1')),
396            'FAM:*:ADDR:ADR2'          => new AddressLine2(I18N::translate('Address line 2')),
397            'FAM:*:ADDR:ADR3'          => new AddressLine3(I18N::translate('Address line 3')),
398            'FAM:*:ADDR:CITY'          => new AddressCity(I18N::translate('City')),
399            'FAM:*:ADDR:CTRY'          => new AddressCountry(I18N::translate('Country')),
400            'FAM:*:ADDR:POST'          => new AddressPostalCode(I18N::translate('Postal code')),
401            'FAM:*:ADDR:STAE'          => new AddressState(I18N::translate('State')),
402            'FAM:*:AGNC'               => new ResponsibleAgency(I18N::translate('Agency')),
403            'FAM:*:CAUS'               => new CauseOfEvent(I18N::translate('Cause')),
404            'FAM:*:DATE'               => new DateValue(I18N::translate('Date')),
405            'FAM:*:EMAIL'              => new AddressEmail(I18N::translate('Email address')),
406            'FAM:*:FAX'                => new AddressFax(I18N::translate('Fax')),
407            'FAM:*:HUSB'               => new EmptyElement(I18N::translate('Husband'), ['AGE' => '0:1']),
408            'FAM:*:HUSB:AGE'           => new AgeAtEvent(I18N::translate('Husband’s age')),
409            'FAM:*:NOTE'               => new NoteStructure(I18N::translate('Note')),
410            'FAM:*:OBJE'               => new XrefMedia(I18N::translate('Media object')),
411            'FAM:*:PHON'               => new PhoneNumber(I18N::translate('Phone')),
412            'FAM:*:PLAC'               => new PlaceName(I18N::translate('Place')),
413            'FAM:*:PLAC:FONE'          => new PlacePhoneticVariation(I18N::translate('Phonetic place')),
414            'FAM:*:PLAC:FONE:TYPE'     => new PhoneticType(I18N::translate('Type')),
415            'FAM:*:PLAC:FORM'          => new PlaceHierarchy(I18N::translate('Format')),
416            'FAM:*:PLAC:MAP'           => new Coordinates(I18N::translate('Coordinates')),
417            'FAM:*:PLAC:MAP:LATI'      => new PlaceLatitude(I18N::translate('Latitude')),
418            'FAM:*:PLAC:MAP:LONG'      => new PlaceLongtitude(I18N::translate('Longitude')),
419            'FAM:*:PLAC:NOTE'          => new NoteStructure(I18N::translate('Note')),
420            'FAM:*:PLAC:ROMN'          => new PlaceRomanizedVariation(I18N::translate('Romanized place')),
421            'FAM:*:PLAC:ROMN:TYPE'     => new RomanizedType(I18N::translate('Type')),
422            'FAM:*:RELI'               => new ReligiousAffiliation(I18N::translate('Religion'), []),
423            'FAM:*:RESN'               => new RestrictionNotice(I18N::translate('Restriction')),
424            'FAM:*:SOUR'               => new XrefSource(I18N::translate('Source citation')),
425            'FAM:*:SOUR:DATA'          => new SourceData(I18N::translate('Data')),
426            'FAM:*:SOUR:DATA:DATE'     => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
427            'FAM:*:SOUR:DATA:TEXT'     => new TextFromSource(I18N::translate('Text')),
428            'FAM:*:SOUR:EVEN'          => new EventTypeCitedFrom(I18N::translate('Event')),
429            'FAM:*:SOUR:EVEN:ROLE'     => new RoleInEvent(I18N::translate('Role')),
430            'FAM:*:SOUR:NOTE'          => new NoteStructure(I18N::translate('Note')),
431            'FAM:*:SOUR:OBJE'          => new XrefMedia(I18N::translate('Media object')),
432            'FAM:*:SOUR:PAGE'          => new WhereWithinSource(I18N::translate('Citation details')),
433            'FAM:*:SOUR:QUAY'          => new CertaintyAssessment(I18N::translate('Quality of data')),
434            'FAM:*:TYPE'               => new EventOrFactClassification(I18N::translate('Type')),
435            'FAM:*:WIFE'               => new EmptyElement(I18N::translate('Wife'), ['AGE' => '0:1']),
436            'FAM:*:WIFE:AGE'           => new AgeAtEvent(I18N::translate('Wife’s age')),
437            'FAM:*:WWW'                => new AddressWebPage(I18N::translate('URL')),
438            'FAM:ANUL'                 => new Annulment(I18N::translate('Annulment')),
439            'FAM:CENS'                 => new FamilyCensus(I18N::translate('Family census')),
440            'FAM:CHAN'                 => new Change(I18N::translate('Last change')),
441            'FAM:CHAN:DATE'            => new ChangeDate(I18N::translate('Date of last change')),
442            'FAM:CHAN:DATE:TIME'       => new TimeValue(I18N::translate('Time of last change')),
443            'FAM:CHIL'                 => new XrefIndividual(I18N::translate('Child')),
444            'FAM:DIV'                  => new Divorce(I18N::translate('Divorce')),
445            'FAM:DIV:DATE'             => new DateValue(I18N::translate('Date of divorce')),
446            'FAM:DIVF'                 => new DivorceFiled(I18N::translate('Divorce filed')),
447            'FAM:ENGA'                 => new Engagement(I18N::translate('Engagement')),
448            'FAM:ENGA:DATE'            => new DateValue(I18N::translate('Date of engagement')),
449            'FAM:ENGA:PLAC'            => new PlaceName(I18N::translate('Place of engagement')),
450            'FAM:EVEN'                 => new CustomFamilyEvent(I18N::translate('Event')),
451            'FAM:EVEN:TYPE'            => new EventAttributeType(I18N::translate('Type of event')),
452            'FAM:HUSB'                 => new XrefIndividual(I18N::translate('Husband')),
453            'FAM:MARB'                 => new MarriageBanns(I18N::translate('Marriage banns')),
454            'FAM:MARB:DATE'            => new DateValue(I18N::translate('Date of marriage banns')),
455            'FAM:MARB:PLAC'            => new PlaceName(I18N::translate('Place of marriage banns')),
456            'FAM:MARC'                 => new MarriageContract(I18N::translate('Marriage contract')),
457            'FAM:MARL'                 => new MarriageLicence(I18N::translate('Marriage license')),
458            'FAM:MARR'                 => new Marriage(I18N::translate('Marriage')),
459            'FAM:MARR:DATE'            => new DateValue(I18N::translate('Date of marriage')),
460            'FAM:MARR:PLAC'            => new PlaceName(I18N::translate('Place of marriage')),
461            'FAM:MARR:TYPE'            => new MarriageType(I18N::translate('Type of marriage')),
462            'FAM:MARS'                 => new MarriageSettlement(I18N::translate('Marriage settlement')),
463            'FAM:NCHI'                 => new CountOfChildren(I18N::translate('Number of children')),
464            'FAM:NOTE'                 => new NoteStructure(I18N::translate('Note')),
465            'FAM:OBJE'                 => new XrefMedia(I18N::translate('Media object')),
466            'FAM:REFN'                 => new UserReferenceNumber(I18N::translate('Reference number')),
467            'FAM:REFN:TYPE'            => new UserReferenceType(I18N::translate('Type of reference number')),
468            'FAM:RESI'                 => new FamilyResidence(I18N::translate('Family residence')),
469            'FAM:RESN'                 => new RestrictionNotice(I18N::translate('Restriction')),
470            'FAM:RIN'                  => new AutomatedRecordId(I18N::translate('Record ID number')),
471            'FAM:SLGS'                 => new LdsSpouseSealing(I18N::translate('LDS spouse sealing')),
472            'FAM:SLGS:DATE'            => new DateLdsOrd(I18N::translate('Date of LDS spouse sealing')),
473            'FAM:SLGS:PLAC'            => new PlaceLivingOrdinance(I18N::translate('Place of LDS spouse sealing')),
474            'FAM:SLGS:STAT'            => new LdsSpouseSealingDateStatus(I18N::translate('Status')),
475            'FAM:SLGS:STAT:DATE'       => new ChangeDate(I18N::translate('Status change date')),
476            'FAM:SLGS:TEMP'            => new TempleCode(I18N::translate('Temple')),
477            'FAM:SOUR'                 => new XrefSource(I18N::translate('Source citation')),
478            'FAM:SOUR:DATA'            => new SourceData(I18N::translate('Data')),
479            'FAM:SOUR:DATA:DATE'       => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
480            'FAM:SOUR:DATA:TEXT'       => new TextFromSource(I18N::translate('Text')),
481            'FAM:SOUR:EVEN'            => new EventTypeCitedFrom(I18N::translate('Event')),
482            'FAM:SOUR:EVEN:ROLE'       => new RoleInEvent(I18N::translate('Role')),
483            'FAM:SOUR:NOTE'            => new NoteStructure(I18N::translate('Note')),
484            'FAM:SOUR:OBJE'            => new XrefMedia(I18N::translate('Media object')),
485            'FAM:SOUR:PAGE'            => new WhereWithinSource(I18N::translate('Citation details')),
486            'FAM:SOUR:QUAY'            => new CertaintyAssessment(I18N::translate('Quality of data')),
487            'FAM:SUBM'                 => new XrefSubmitter(I18N::translate('Submitter')),
488            'FAM:WIFE'                 => new XrefIndividual(I18N::translate('Wife')),
489            'HEAD'                     => new HeaderRecord(I18N::translate('Header')),
490            'HEAD:CHAR'                => new CharacterSet(I18N::translate('Character set')),
491            'HEAD:CHAR:VERS'           => new VersionNumber(I18N::translate('Version')),
492            'HEAD:COPR'                => new CopyrightFile(I18N::translate('Copyright')),
493            'HEAD:DATE'                => new TransmissionDate(I18N::translate('Date')),
494            'HEAD:DATE:TIME'           => new TimeValue(I18N::translate('Time')),
495            'HEAD:DEST'                => new ReceivingSystemName(I18N::translate('Destination')),
496            'HEAD:FILE'                => new FileName(I18N::translate('Filename')),
497            'HEAD:GEDC'                => new GedcomElement(I18N::translate('GEDCOM')),
498            'HEAD:GEDC:FORM'           => new Form(I18N::translate('Format')),
499            'HEAD:GEDC:VERS'           => new VersionNumber(I18N::translate('Version')),
500            'HEAD:LANG'                => new LanguageId(I18N::translate('Language')),
501            'HEAD:NOTE'                => new ContentDescription(I18N::translate('Note')),
502            'HEAD:PLAC'                => new EmptyElement(I18N::translate('Place hierarchy'), ['FORM' => '1:1']),
503            'HEAD:PLAC:FORM'           => new PlaceHierarchy(I18N::translate('Format')),
504            'HEAD:SOUR'                => new ApprovedSystemId(I18N::translate('Application ID')),
505            'HEAD:SOUR:CORP'           => new NameOfBusiness(I18N::translate('Corporation')),
506            'HEAD:SOUR:CORP:ADDR'      => new AddressLine(I18N::translate('Address')),
507            'HEAD:SOUR:CORP:ADDR:ADR1' => new AddressLine1(I18N::translate('Address line 1')),
508            'HEAD:SOUR:CORP:ADDR:ADR2' => new AddressLine2(I18N::translate('Address line 2')),
509            'HEAD:SOUR:CORP:ADDR:ADR3' => new AddressLine3(I18N::translate('Address line 3')),
510            'HEAD:SOUR:CORP:ADDR:CITY' => new AddressCity(I18N::translate('City')),
511            'HEAD:SOUR:CORP:ADDR:CTRY' => new AddressCountry(I18N::translate('Country')),
512            'HEAD:SOUR:CORP:ADDR:POST' => new AddressPostalCode(I18N::translate('Postal code')),
513            'HEAD:SOUR:CORP:ADDR:STAE' => new AddressState(I18N::translate('State')),
514            'HEAD:SOUR:CORP:EMAIL'     => new AddressEmail(I18N::translate('Email address')),
515            'HEAD:SOUR:CORP:FAX'       => new AddressFax(I18N::translate('Fax')),
516            'HEAD:SOUR:CORP:PHON'      => new PhoneNumber(I18N::translate('Phone')),
517            'HEAD:SOUR:CORP:WWW'       => new AddressWebPage(I18N::translate('URL')),
518            'HEAD:SOUR:DATA'           => new NameOfSourceData(I18N::translate('Data')),
519            'HEAD:SOUR:DATA:COPR'      => new CopyrightSourceData(I18N::translate('Copyright')),
520            'HEAD:SOUR:DATA:DATE'      => new PublicationDate(I18N::translate('Date')),
521            'HEAD:SOUR:NAME'           => new NameOfProduct(I18N::translate('Application name')),
522            'HEAD:SOUR:VERS'           => new VersionNumber(I18N::translate('Version')),
523            'HEAD:SUBM'                => new XrefSubmitter(I18N::translate('Submitter')),
524            'HEAD:SUBN'                => new XrefSubmission(I18N::translate('Submission')),
525            'INDI'                     => new IndividualRecord(I18N::translate('Individual')),
526            'INDI:*:ADDR'              => new AddressLine(I18N::translate('Address')),
527            'INDI:*:ADDR:ADR1'         => new AddressLine1(I18N::translate('Address line 1')),
528            'INDI:*:ADDR:ADR2'         => new AddressLine2(I18N::translate('Address line 2')),
529            'INDI:*:ADDR:ADR3'         => new AddressLine3(I18N::translate('Address line 3')),
530            'INDI:*:ADDR:CITY'         => new AddressCity(I18N::translate('City')),
531            'INDI:*:ADDR:CTRY'         => new AddressCountry(I18N::translate('Country')),
532            'INDI:*:ADDR:POST'         => new AddressPostalCode(I18N::translate('Postal code')),
533            'INDI:*:ADDR:STAE'         => new AddressState(I18N::translate('State')),
534            'INDI:*:AGE'               => new AgeAtEvent(I18N::translate('Age')),
535            'INDI:*:AGNC'              => new ResponsibleAgency(I18N::translate('Agency')),
536            'INDI:*:CAUS'              => new CauseOfEvent(I18N::translate('Cause')),
537            'INDI:*:DATE'              => new DateValue(I18N::translate('Date')),
538            'INDI:*:EMAIL'             => new AddressEmail(I18N::translate('Email address')),
539            'INDI:*:FAX'               => new AddressFax(I18N::translate('Fax')),
540            'INDI:*:NOTE'              => new NoteStructure(I18N::translate('Note')),
541            'INDI:*:OBJE'              => new XrefMedia(I18N::translate('Media object')),
542            'INDI:*:PHON'              => new PhoneNumber(I18N::translate('Phone')),
543            'INDI:*:PLAC'              => new PlaceName(I18N::translate('Place')),
544            'INDI:*:PLAC:FONE'         => new PlacePhoneticVariation(I18N::translate('Phonetic place')),
545            'INDI:*:PLAC:FONE:TYPE'    => new PhoneticType(I18N::translate('Type')),
546            'INDI:*:PLAC:FORM'         => new PlaceHierarchy(I18N::translate('Format')),
547            'INDI:*:PLAC:MAP'          => new Coordinates(I18N::translate('Coordinates')),
548            'INDI:*:PLAC:MAP:LATI'     => new PlaceLatitude(I18N::translate('Latitude')),
549            'INDI:*:PLAC:MAP:LONG'     => new PlaceLongtitude(I18N::translate('Longitude')),
550            'INDI:*:PLAC:NOTE'         => new NoteStructure(I18N::translate('Note')),
551            'INDI:*:PLAC:ROMN'         => new PlaceRomanizedVariation(I18N::translate('Romanized place')),
552            'INDI:*:PLAC:ROMN:TYPE'    => new RomanizedType(I18N::translate('Type')),
553            'INDI:*:RELI'              => new ReligiousAffiliation(I18N::translate('Religion'), []),
554            'INDI:*:RESN'              => new RestrictionNotice(I18N::translate('Restriction')),
555            'INDI:*:SOUR'              => new XrefSource(I18N::translate('Source citation')),
556            'INDI:*:SOUR:DATA'         => new SourceData(I18N::translate('Data')),
557            'INDI:*:SOUR:DATA:DATE'    => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
558            'INDI:*:SOUR:DATA:TEXT'    => new TextFromSource(I18N::translate('Text')),
559            'INDI:*:SOUR:EVEN'         => new EventTypeCitedFrom(I18N::translate('Event')),
560            'INDI:*:SOUR:EVEN:ROLE'    => new RoleInEvent(I18N::translate('Role')),
561            'INDI:*:SOUR:NOTE'         => new NoteStructure(I18N::translate('Note')),
562            'INDI:*:SOUR:OBJE'         => new XrefMedia(I18N::translate('Media object')),
563            'INDI:*:SOUR:PAGE'         => new WhereWithinSource(I18N::translate('Citation details')),
564            'INDI:*:SOUR:QUAY'         => new CertaintyAssessment(I18N::translate('Quality of data')),
565            'INDI:*:TYPE'              => new EventOrFactClassification(I18N::translate('Type')),
566            'INDI:*:WWW'               => new AddressWebPage(I18N::translate('URL')),
567            'INDI:ADOP'                => new Adoption(I18N::translate('Adoption')),
568            'INDI:ADOP:DATE'           => new DateValue(I18N::translate('Date of adoption')),
569            'INDI:ADOP:FAMC'           => new XrefFamily(I18N::translate('Adoptive parents')),
570            'INDI:ADOP:FAMC:ADOP'      => new AdoptedByWhichParent(I18N::translate('Adoption')),
571            'INDI:ADOP:PLAC'           => new PlaceName(I18N::translate('Place of adoption')),
572            'INDI:AFN'                 => new AncestralFileNumber(I18N::translate('Ancestral file number')),
573            'INDI:ALIA'                => new XrefIndividual(I18N::translate('Alias')),
574            'INDI:ANCI'                => new XrefSubmitter(I18N::translate('Ancestors interest')),
575            'INDI:ASSO'                => new XrefAssociate(I18N::translate('Associate')),
576            'INDI:ASSO:RELA'           => new RelationIsDescriptor(I18N::translate('Relationship')),
577            'INDI:BAPL'                => new LdsBaptism(I18N::translate('LDS baptism')),
578            'INDI:BAPL:DATE'           => new DateLdsOrd(I18N::translate('Date of LDS baptism')),
579            'INDI:BAPL:PLAC'           => new PlaceLivingOrdinance(I18N::translate('Place of LDS baptism')),
580            'INDI:BAPL:STAT'           => new LdsBaptismDateStatus(I18N::translate('Status')),
581            'INDI:BAPL:STAT:DATE'      => new ChangeDate(I18N::translate('Status change date')),
582            'INDI:BAPL:TEMP'           => new TempleCode(I18N::translate('Temple')),
583            'INDI:BAPM'                => new Baptism(I18N::translate('Baptism')),
584            'INDI:BAPM:DATE'           => new DateValue(I18N::translate('Date of baptism')),
585            'INDI:BAPM:PLAC'           => new PlaceName(I18N::translate('Place of baptism')),
586            'INDI:BARM'                => new BarMitzvah(I18N::translate('Bar mitzvah')),
587            'INDI:BARM:DATE'           => new DateValue(I18N::translate('Date of bar mitzvah')),
588            'INDI:BARM:PLAC'           => new PlaceName(I18N::translate('Place of bar mitzvah')),
589            'INDI:BASM'                => new BasMitzvah(I18N::translate('Bat mitzvah')),
590            'INDI:BASM:DATE'           => new BasMitzvah(I18N::translate('Date of bat mitzvah')),
591            'INDI:BASM:PLAC'           => new DateValue(I18N::translate('Place of bat mitzvah')),
592            'INDI:BIRT'                => new Birth(I18N::translate('Birth')),
593            'INDI:BIRT:DATE'           => new DateValue(I18N::translate('Date of birth')),
594            'INDI:BIRT:FAMC'           => new XrefFamily(I18N::translate('Birth parents')),
595            'INDI:BIRT:PLAC'           => new PlaceName(I18N::translate('Place of birth')),
596            'INDI:BLES'                => new Blessing(I18N::translate('Blessing')),
597            'INDI:BLES:DATE'           => new DateValue(I18N::translate('Date of blessing')),
598            'INDI:BLES:PLAC'           => new PlaceName(I18N::translate('Place of blessing')),
599            'INDI:BURI'                => new Burial(I18N::translate('Burial')),
600            'INDI:BURI:DATE'           => new DateValue(I18N::translate('Date of burial')),
601            'INDI:BURI:PLAC'           => new PlaceName(I18N::translate('Place of burial')),
602            'INDI:CAST'                => new CasteName(I18N::translate('Caste')),
603            'INDI:CENS'                => new Census(I18N::translate('Census')),
604            'INDI:CENS:DATE'           => new DateValue(I18N::translate('Census date')),
605            'INDI:CENS:PLAC'           => new PlaceName(I18N::translate('Census place')),
606            'INDI:CHAN'                => new Change(I18N::translate('Last change')),
607            'INDI:CHAN:DATE'           => new ChangeDate(I18N::translate('Date of last change')),
608            'INDI:CHAN:DATE:TIME'      => new TimeValue(I18N::translate('Time of last change')),
609            'INDI:CHR'                 => new Christening(I18N::translate('Christening')),
610            'INDI:CHR:DATE'            => new DateValue(I18N::translate('Date of christening')),
611            'INDI:CHR:FAMC'            => new XrefFamily(I18N::translate('Godparents')),
612            'INDI:CHR:PLAC'            => new PlaceName(I18N::translate('Place of christening')),
613            'INDI:CHRA'                => new AdultChristening(I18N::translate('Adult christening')),
614            'INDI:CHRA:PLAC'           => new PlaceName(I18N::translate('Place of christening')),
615            'INDI:CONF'                => new Confirmation(I18N::translate('Confirmation')),
616            'INDI:CONF:DATE'           => new DateValue(I18N::translate('Date of confirmation')),
617            'INDI:CONF:PLAC'           => new PlaceName(I18N::translate('Place of confirmation')),
618            'INDI:CONL'                => new LdsConfirmation(I18N::translate('LDS confirmation')),
619            'INDI:CONL:DATE'           => new DateLdsOrd(I18N::translate('Date of LDS confirmation')),
620            'INDI:CONL:PLAC'           => new PlaceLivingOrdinance(I18N::translate('Place of LDS confirmation')),
621            'INDI:CONL:STAT'           => new LdsSpouseSealingDateStatus(I18N::translate('Status')),
622            'INDI:CONL:STAT:DATE'      => new ChangeDate(I18N::translate('Status change date')),
623            'INDI:CONL:TEMP'           => new TempleCode(I18N::translate('Temple')),
624            'INDI:CREM'                => new Cremation(I18N::translate('Cremation')),
625            'INDI:CREM:DATE'           => new DateValue(I18N::translate('Date of cremation')),
626            'INDI:CREM:PLAC'           => new PlaceName(I18N::translate('Place of cremation')),
627            'INDI:DEAT'                => new Death(I18N::translate('Death')),
628            'INDI:DEAT:CAUS'           => new CauseOfEvent(I18N::translate('Cause of death')),
629            'INDI:DEAT:DATE'           => new DateValue(I18N::translate('Date of death')),
630            'INDI:DEAT:PLAC'           => new PlaceName(I18N::translate('Place of death')),
631            'INDI:DESI'                => new XrefSubmitter(I18N::translate('Descendants interest')),
632            'INDI:DSCR'                => new PhysicalDescription(I18N::translate('Description')),
633            'INDI:EDUC'                => new ScholasticAchievement(I18N::translate('Education')),
634            'INDI:EDUC:AGNC'           => new ResponsibleAgency(I18N::translate('School or college')),
635            'INDI:EMIG'                => new Emigration(I18N::translate('Emigration')),
636            'INDI:EMIG:DATE'           => new DateValue(I18N::translate('Date of emigration')),
637            'INDI:EMIG:PLAC'           => new PlaceName(I18N::translate('Place of emigration')),
638            'INDI:ENDL'                => new LdsEndowment(I18N::translate('LDS endowment')),
639            'INDI:ENDL:DATE'           => new DateLdsOrd(I18N::translate('Date of LDS endowment')),
640            'INDI:ENDL:PLAC'           => new PlaceLivingOrdinance(I18N::translate('Place of LDS endowment')),
641            'INDI:ENDL:STAT'           => new LdsEndowmentDateStatus(I18N::translate('Status')),
642            'INDI:ENDL:STAT:DATE'      => new ChangeDate(I18N::translate('Status change date')),
643            'INDI:ENDL:TEMP'           => new TempleCode(I18N::translate('Temple')),
644            'INDI:EVEN'                => new CustomIndividualEvent(I18N::translate('Event')),
645            'INDI:EVEN:DATE'           => new DateValue(I18N::translate('Date of event')),
646            'INDI:EVEN:PLAC'           => new PlaceName(I18N::translate('Place of event')),
647            'INDI:EVEN:TYPE'           => new EventAttributeType(I18N::translate('Type of event')),
648            'INDI:FACT'                => new CustomFact(I18N::translate('Fact')),
649            'INDI:FACT:TYPE'           => new EventAttributeType(I18N::translate('Type of fact')),
650            'INDI:FAMC'                => new XrefFamily(I18N::translate('Family as a child'), ['NOTE' => '0:1', 'PEDI' => '0:1', 'STAT' => '0:1']),
651            'INDI:FAMC:PEDI'           => new PedigreeLinkageType(I18N::translate('Relationship to parents')),
652            'INDI:FAMC:STAT'           => new ChildLinkageStatus(I18N::translate('Status')),
653            'INDI:FAMS'                => new XrefFamily(I18N::translate('Family as a spouse')),
654            'INDI:FCOM'                => new FirstCommunion(I18N::translate('First communion')),
655            'INDI:FCOM:DATE'           => new DateValue(I18N::translate('Date of first communion')),
656            'INDI:FCOM:PLAC'           => new PlaceName(I18N::translate('Place of first communion')),
657            'INDI:GRAD'                => new Graduation(I18N::translate('Graduation')),
658            'INDI:GRAD:AGNC'           => new ResponsibleAgency(I18N::translate('School or college')),
659            'INDI:IDNO'                => new NationalIdNumber(I18N::translate('Identification number')),
660            'INDI:IDNO:TYPE'           => new EventAttributeType(I18N::translate('Type of identification number')),
661            'INDI:IMMI'                => new Immigration(I18N::translate('Immigration')),
662            'INDI:IMMI:DATE'           => new DateValue(I18N::translate('Date of immigration')),
663            'INDI:IMMI:PLAC'           => new PlaceName(I18N::translate('Place of immigration')),
664            'INDI:NAME'                => new NamePersonal(I18N::translate('Name')),
665            'INDI:NAME:FONE'           => new NamePhoneticVariation(I18N::translate('Phonetic name')),
666            'INDI:NAME:FONE:GIVN'      => new NamePieceGiven(I18N::translate('Given names')),
667            'INDI:NAME:FONE:NICK'      => new NamePieceNickname(I18N::translate('Nickname')),
668            'INDI:NAME:FONE:NPFX'      => new NamePiecePrefix(I18N::translate('Name prefix')),
669            'INDI:NAME:FONE:NSFX'      => new NamePieceSuffix(I18N::translate('Name suffix')),
670            'INDI:NAME:FONE:SPFX'      => new NamePieceSurnamePrefix(I18N::translate('Surname prefix')),
671            'INDI:NAME:FONE:SURN'      => new NamePieceSurname(I18N::translate('Surname')),
672            'INDI:NAME:FONE:TYPE'      => new PhoneticType(I18N::translate('Phonetic type')),
673            'INDI:NAME:GIVN'           => new NamePieceGiven(I18N::translate('Given names')),
674            'INDI:NAME:NICK'           => new NamePieceNickname(I18N::translate('Nickname')),
675            'INDI:NAME:NPFX'           => new NamePiecePrefix(I18N::translate('Name prefix')),
676            'INDI:NAME:NSFX'           => new NamePieceSuffix(I18N::translate('Name suffix')),
677            'INDI:NAME:ROMN'           => new NameRomanizedVariation(I18N::translate('Romanized name')),
678            'INDI:NAME:ROMN:GIVN'      => new NamePieceGiven(I18N::translate('Given names')),
679            'INDI:NAME:ROMN:NICK'      => new NamePieceNickname(I18N::translate('Nickname')),
680            'INDI:NAME:ROMN:NPFX'      => new NamePiecePrefix(I18N::translate('Name prefix')),
681            'INDI:NAME:ROMN:NSFX'      => new NamePieceSuffix(I18N::translate('Name suffix')),
682            'INDI:NAME:ROMN:SPFX'      => new NamePieceSurnamePrefix(I18N::translate('Surname prefix')),
683            'INDI:NAME:ROMN:SURN'      => new NamePieceSurname(I18N::translate('Surname')),
684            'INDI:NAME:ROMN:TYPE'      => new RomanizedType(I18N::translate('Romanized type')),
685            'INDI:NAME:SPFX'           => new NamePieceSurnamePrefix(I18N::translate('Surname prefix')),
686            'INDI:NAME:SURN'           => new NamePieceSurname(I18N::translate('Surname')),
687            'INDI:NAME:TYPE'           => new NameType(I18N::translate('Type of name')),
688            'INDI:NATI'                => new NationOrTribalOrigin(I18N::translate('Nationality')),
689            'INDI:NATU'                => new Naturalization(I18N::translate('Naturalization')),
690            'INDI:NATU:DATE'           => new DateValue(I18N::translate('Date of naturalization')),
691            'INDI:NATU:PLAC'           => new PlaceName(I18N::translate('Place of naturalization')),
692            'INDI:NCHI'                => new CountOfChildren(I18N::translate('Number of children')),
693            'INDI:NMR'                 => new CountOfMarriages(I18N::translate('Number of marriages')),
694            'INDI:NOTE'                => new NoteStructure(I18N::translate('Note')),
695            'INDI:OBJE'                => new XrefMedia(I18N::translate('Media object')),
696            'INDI:OCCU'                => new Occupation(I18N::translate('Occupation')),
697            'INDI:OCCU:AGNC'           => new ResponsibleAgency(I18N::translate('Employer')),
698            'INDI:ORDN'                => new Ordination(I18N::translate('Ordination')),
699            'INDI:ORDN:AGNC'           => new Ordination(I18N::translate('Religious institution')),
700            'INDI:ORDN:DATE'           => new Ordination(I18N::translate('Date of ordination')),
701            'INDI:ORDN:PLAC'           => new Ordination(I18N::translate('Place of ordination')),
702            'INDI:PROB'                => new Probate(I18N::translate('Probate')),
703            'INDI:PROP'                => new Possessions(I18N::translate('Property')),
704            'INDI:REFN'                => new UserReferenceNumber(I18N::translate('Reference number')),
705            'INDI:REFN:TYPE'           => new UserReferenceType(I18N::translate('Type of reference number')),
706            'INDI:RELI'                => new ReligiousAffiliation(I18N::translate('Religion')),
707            'INDI:RESI'                => new Residence(I18N::translate('Residence')),
708            'INDI:RESI:DATE'           => new DateValue(I18N::translate('Date of residence')),
709            'INDI:RESI:PLAC'           => new PlaceName(I18N::translate('Place of residence')),
710            'INDI:RESN'                => new RestrictionNotice(I18N::translate('Restriction')),
711            'INDI:RETI'                => new Retirement(I18N::translate('Retirement')),
712            'INDI:RETI:AGNC'           => new ResponsibleAgency(I18N::translate('Employer')),
713            'INDI:RFN'                 => new PermanentRecordFileNumber(I18N::translate('Record file number')),
714            'INDI:RIN'                 => new AutomatedRecordId(I18N::translate('Record ID number')),
715            'INDI:SEX'                 => new SexValue(I18N::translate('Gender')),
716            'INDI:SLGC'                => new LdsChildSealing(I18N::translate('LDS child sealing')),
717            'INDI:SLGC:DATE'           => new DateLdsOrd(I18N::translate('Date of LDS child sealing')),
718            'INDI:SLGC:FAMC'           => new XrefFamily(I18N::translate('Parents')),
719            'INDI:SLGC:PLAC'           => new PlaceLivingOrdinance(I18N::translate('Place of LDS child sealing')),
720            'INDI:SLGC:STAT'           => new LdsChildSealingDateStatus(I18N::translate('Status')),
721            'INDI:SLGC:STAT:DATE'      => new ChangeDate(I18N::translate('Status change date')),
722            'INDI:SLGC:TEMP'           => new TempleCode(I18N::translate('Temple')),
723            'INDI:SOUR'                => new XrefSource(I18N::translate('Source citation')),
724            'INDI:SOUR:DATA'           => new SourceData(I18N::translate('Data')),
725            'INDI:SOUR:DATA:DATE'      => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
726            'INDI:SOUR:DATA:TEXT'      => new TextFromSource(I18N::translate('Text')),
727            'INDI:SOUR:EVEN'           => new EventTypeCitedFrom(I18N::translate('Event')),
728            'INDI:SOUR:EVEN:ROLE'      => new RoleInEvent(I18N::translate('Role')),
729            'INDI:SOUR:NOTE'           => new NoteStructure(I18N::translate('Note')),
730            'INDI:SOUR:OBJE'           => new XrefMedia(I18N::translate('Media object')),
731            'INDI:SOUR:PAGE'           => new WhereWithinSource(I18N::translate('Citation details')),
732            'INDI:SOUR:QUAY'           => new CertaintyAssessment(I18N::translate('Quality of data')),
733            'INDI:SSN'                 => new SocialSecurityNumber(I18N::translate('Social security number')),
734            'INDI:SUBM'                => new XrefSubmitter(I18N::translate('Submitter')),
735            'INDI:TITL'                => new NobilityTypeTitle(I18N::translate('Title')),
736            'INDI:WILL'                => new Will(I18N::translate('Will')),
737            'NOTE'                     => new NoteRecord(I18N::translate('Shared note')),
738            'NOTE:CHAN'                => new Change(I18N::translate('Last change')),
739            'NOTE:CHAN:DATE'           => new ChangeDate(I18N::translate('Date of last change')),
740            'NOTE:CHAN:DATE:TIME'      => new TimeValue(I18N::translate('Time of last change')),
741            'NOTE:CHAN:NOTE'           => new NoteStructure(I18N::translate('Note')),
742            'NOTE:CONC'                => new SubmitterText(I18N::translate('Note')),
743            'NOTE:CONT'                => new SubmitterText(I18N::translate('Continuation')),
744            'NOTE:REFN'                => new UserReferenceNumber(I18N::translate('Reference number')),
745            'NOTE:REFN:TYPE'           => new UserReferenceType(I18N::translate('Type of reference number')),
746            'NOTE:RIN'                 => new AutomatedRecordId(I18N::translate('Record ID number')),
747            'NOTE:SOUR'                => new XrefSource(I18N::translate('Source citation')),
748            'NOTE:SOUR:DATA'           => new SourceData(I18N::translate('Data')),
749            'NOTE:SOUR:DATA:DATE'      => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
750            'NOTE:SOUR:DATA:TEXT'      => new TextFromSource(I18N::translate('Text')),
751            'NOTE:SOUR:EVEN'           => new EventTypeCitedFrom(I18N::translate('Event')),
752            'NOTE:SOUR:EVEN:ROLE'      => new RoleInEvent(I18N::translate('Role')),
753            'NOTE:SOUR:NOTE'           => new NoteStructure(I18N::translate('Note')),
754            'NOTE:SOUR:OBJE'           => new XrefMedia(I18N::translate('Media object')),
755            'NOTE:SOUR:PAGE'           => new WhereWithinSource(I18N::translate('Citation details')),
756            'NOTE:SOUR:QUAY'           => new CertaintyAssessment(I18N::translate('Quality of data')),
757            'OBJE'                     => new MediaRecord(I18N::translate('Media object')),
758            'OBJE:BLOB'                => new CustomElement(I18N::translate('Binary data object')),
759            'OBJE:CHAN'                => new Change(I18N::translate('Last change')),
760            'OBJE:CHAN:DATE'           => new ChangeDate(I18N::translate('Date of last change')),
761            'OBJE:CHAN:DATE:TIME'      => new TimeValue(I18N::translate('Time of last change')),
762            'OBJE:CHAN:NOTE'           => new NoteStructure(I18N::translate('Note')),
763            'OBJE:FILE'                => new MultimediaFileReference(I18N::translate('Filename')),
764            'OBJE:FILE:FORM'           => new MultimediaFormat(I18N::translate('Format')),
765            'OBJE:FILE:FORM:TYPE'      => new SourceMediaType(I18N::translate('Media type')),
766            'OBJE:FILE:TITL'           => new DescriptiveTitle(I18N::translate('Title')),
767            'OBJE:NOTE'                => new NoteStructure(I18N::translate('Note')),
768            'OBJE:REFN'                => new UserReferenceNumber(I18N::translate('Reference number')),
769            'OBJE:REFN:TYPE'           => new UserReferenceType(I18N::translate('Type of reference number')),
770            'OBJE:RIN'                 => new AutomatedRecordId(I18N::translate('Record ID number')),
771            'OBJE:SOUR'                => new XrefSource(I18N::translate('Source citation')),
772            'OBJE:SOUR:DATA'           => new SourceData(I18N::translate('Data')),
773            'OBJE:SOUR:DATA:DATE'      => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
774            'OBJE:SOUR:DATA:TEXT'      => new TextFromSource(I18N::translate('Text')),
775            'OBJE:SOUR:EVEN'           => new EventTypeCitedFrom(I18N::translate('Event')),
776            'OBJE:SOUR:EVEN:ROLE'      => new RoleInEvent(I18N::translate('Role')),
777            'OBJE:SOUR:NOTE'           => new NoteStructure(I18N::translate('Note')),
778            'OBJE:SOUR:OBJE'           => new XrefMedia(I18N::translate('Media object')),
779            'OBJE:SOUR:PAGE'           => new WhereWithinSource(I18N::translate('Citation details')),
780            'OBJE:SOUR:QUAY'           => new CertaintyAssessment(I18N::translate('Quality of data')),
781            'REPO'                     => new RepositoryRecord(I18N::translate('Repository')),
782            'REPO:ADDR'                => new AddressLine(I18N::translate('Address')),
783            'REPO:ADDR:ADR1'           => new AddressLine1(I18N::translate('Address line 1')),
784            'REPO:ADDR:ADR2'           => new AddressLine2(I18N::translate('Address line 2')),
785            'REPO:ADDR:ADR3'           => new AddressLine3(I18N::translate('Address line 3')),
786            'REPO:ADDR:CITY'           => new AddressCity(I18N::translate('City')),
787            'REPO:ADDR:CTRY'           => new AddressCountry(I18N::translate('Country')),
788            'REPO:ADDR:POST'           => new AddressPostalCode(I18N::translate('Postal code')),
789            'REPO:ADDR:STAE'           => new AddressState(I18N::translate('State')),
790            'REPO:CHAN'                => new Change(I18N::translate('Last change')),
791            'REPO:CHAN:DATE'           => new ChangeDate(I18N::translate('Date of last change')),
792            'REPO:CHAN:DATE:TIME'      => new TimeValue(I18N::translate('Time of last change')),
793            'REPO:CHAN:NOTE'           => new NoteStructure(I18N::translate('Note')),
794            'REPO:EMAIL'               => new AddressEmail(I18N::translate('Email address')),
795            'REPO:FAX'                 => new AddressFax(I18N::translate('Fax')),
796            'REPO:NAME'                => new NameOfRepository(I18N::translateContext('Repository', 'Name')),
797            'REPO:NOTE'                => new NoteStructure(I18N::translate('Note')),
798            'REPO:PHON'                => new PhoneNumber(I18N::translate('Phone')),
799            'REPO:REFN'                => new UserReferenceNumber(I18N::translate('Reference number')),
800            'REPO:REFN:TYPE'           => new UserReferenceType(I18N::translate('Type of reference number')),
801            'REPO:RIN'                 => new AutomatedRecordId(I18N::translate('Record ID number')),
802            'REPO:WWW'                 => new AddressWebPage(I18N::translate('URL')),
803            'SOUR'                     => new SourceRecord(I18N::translate('Source')),
804            'SOUR:ABBR'                => new SourceFiledByEntry(I18N::translate('Abbreviation')),
805            'SOUR:AUTH'                => new SourceOriginator(I18N::translate('Author')),
806            'SOUR:CHAN'                => new Change(I18N::translate('Last change')),
807            'SOUR:CHAN:DATE'           => new ChangeDate(I18N::translate('Date of last change')),
808            'SOUR:CHAN:DATE:TIME'      => new TimeValue(I18N::translate('Time of last change')),
809            'SOUR:CHAN:NOTE'           => new NoteStructure(I18N::translate('Note')),
810            'SOUR:DATA'                => new EmptyElement(I18N::translate('Data'), ['EVEN' => '0:M', 'AGNC' => '0:1', 'NOTE' => '0:M']),
811            'SOUR:DATA:AGNC'           => new ResponsibleAgency(I18N::translate('Agency')),
812            'SOUR:DATA:EVEN'           => new EventsRecorded(I18N::translate('Events')),
813            'SOUR:DATA:EVEN:DATE'      => new DateValue(I18N::translate('Date range')),
814            'SOUR:DATA:EVEN:PLAC'      => new SourceJurisdictionPlace(I18N::translate('Place'), []),
815            'SOUR:DATA:NOTE'           => new NoteStructure(I18N::translate('Note')),
816            'SOUR:NOTE'                => new NoteStructure(I18N::translate('Note')),
817            'SOUR:OBJE'                => new XrefMedia(I18N::translate('Media object')),
818            'SOUR:PUBL'                => new SourcePublicationFacts(I18N::translate('Publication')),
819            'SOUR:REFN'                => new UserReferenceNumber(I18N::translate('Reference number')),
820            'SOUR:REFN:TYPE'           => new UserReferenceType(I18N::translate('Type of reference number')),
821            'SOUR:REPO'                => new XrefRepository(I18N::translate('Repository')),
822            'SOUR:REPO:CALN'           => new SourceCallNumber(I18N::translate('Call number')),
823            'SOUR:REPO:CALN:MEDI'      => new SourceMediaType(I18N::translate('Media type')),
824            'SOUR:REPO:NOTE'           => new NoteStructure(I18N::translate('Note')),
825            'SOUR:RIN'                 => new AutomatedRecordId(I18N::translate('Record ID number')),
826            'SOUR:TEXT'                => new TextFromSource(I18N::translate('Text')),
827            'SOUR:TITL'                => new DescriptiveTitle(I18N::translate('Title')),
828            'SUBM'                     => new SubmitterRecord(I18N::translate('Submitter')),
829            'SUBM:ADDR'                => new AddressLine(I18N::translate('Address')),
830            'SUBM:ADDR:ADR1'           => new AddressLine1(I18N::translate('Address line 1')),
831            'SUBM:ADDR:ADR2'           => new AddressLine2(I18N::translate('Address line 2')),
832            'SUBM:ADDR:ADR3'           => new AddressLine3(I18N::translate('Address line 3')),
833            'SUBM:ADDR:CITY'           => new AddressCity(I18N::translate('City')),
834            'SUBM:ADDR:CTRY'           => new AddressCountry(I18N::translate('Country')),
835            'SUBM:ADDR:POST'           => new AddressPostalCode(I18N::translate('Postal code')),
836            'SUBM:ADDR:STAE'           => new AddressState(I18N::translate('State')),
837            'SUBM:CHAN'                => new Change(I18N::translate('Last change')),
838            'SUBM:CHAN:DATE'           => new ChangeDate(I18N::translate('Date of last change')),
839            'SUBM:CHAN:DATE:TIME'      => new TimeValue(I18N::translate('Time of last change')),
840            'SUBM:CHAN:NOTE'           => new NoteStructure(I18N::translate('Note')),
841            'SUBM:EMAIL'               => new AddressEmail(I18N::translate('Email address')),
842            'SUBM:FAX'                 => new AddressFax(I18N::translate('Fax')),
843            'SUBM:LANG'                => new LanguageId(I18N::translate('Language')),
844            'SUBM:NAME'                => new SubmitterName(I18N::translate('Name')),
845            'SUBM:NOTE'                => new NoteStructure(I18N::translate('Note')),
846            'SUBM:OBJE'                => new XrefMedia(I18N::translate('Media object')),
847            'SUBM:PHON'                => new PhoneNumber(I18N::translate('Phone')),
848            'SUBM:RFN'                 => new SubmitterRegisteredRfn(I18N::translate('Record file number')),
849            'SUBM:RIN'                 => new AutomatedRecordId(I18N::translate('Record ID number')),
850            'SUBM:WWW'                 => new AddressWebPage(I18N::translate('URL')),
851            'SUBN'                     => new SubmissionRecord(I18N::translate('Submission')),
852            'SUBN:ANCE'                => new GenerationsOfAncestors(I18N::translate('Generations of ancestors')),
853            'SUBN:CHAN'                => new Change(I18N::translate('Last change')),
854            'SUBN:CHAN:DATE'           => new ChangeDate(I18N::translate('Date of last change')),
855            'SUBN:CHAN:DATE:TIME'      => new TimeValue(I18N::translate('Time of last change')),
856            'SUBN:CHAN:NOTE'           => new NoteStructure(I18N::translate('Note')),
857            'SUBN:DESC'                => new GenerationsOfDescendants(I18N::translate('Generations of descendants')),
858            'SUBN:FAMF'                => new NameOfFamilyFile(I18N::translate('Family file')),
859            'SUBN:NOTE'                => new NoteStructure(I18N::translate('Note')),
860            'SUBN:ORDI'                => new OrdinanceProcessFlag(I18N::translate('Ordinance')),
861            'SUBN:RIN'                 => new AutomatedRecordId(I18N::translate('Record ID number')),
862            'SUBN:SUBM'                => new XrefSubmitter(I18N::translate('Submitter')),
863            'SUBN:TEMP'                => new TempleCode(/* I18N: https://en.wikipedia.org/wiki/Temple_(LDS_Church)*/ I18N::translate('Temple')),
864            'TRLR'                     => new EmptyElement(I18N::translate('Trailer')),
865        ];
866    }
867
868    /**
869     * @return array<string,ElementInterface>
870     */
871    private function aldfaerTags(): array
872    {
873        return [
874            'FAM:MARR_CIVIL'     => new Marriage(I18N::translate('Civil marriage')),
875            'FAM:MARR_PARTNERS'  => new Marriage(I18N::translate('Registered partnership')),
876            'FAM:MARR_RELIGIOUS' => new Marriage(I18N::translate('Religious marriage')),
877            'FAM:MARR_UNKNOWN'   => new Marriage(I18N::translate('Marriage')),
878            'INDI:BIRT:_LENGTH'  => new CustomElement(I18N::translate('Length')),
879            'INDI:BIRT:_WEIGHT'  => new CustomElement(I18N::translate('Weight')),
880        ];
881    }
882
883    /**
884     * @return array<string,ElementInterface>
885     *
886     * @see https://www.webtrees.net/index.php/en/forum/help-for-release-2-1-x/36664-2-1-beta-support-for-indi-even-sour-data-note-and-the-like
887     */
888    private function ancestryTags(): array
889    {
890        return [
891            'HEAD:SOUR:_TREE'       => new CustomElement(I18N::translate('Family tree')),
892            'HEAD:SOUR:_TREE:NOTE'  => new SubmitterText(I18N::translate('Note')),
893            'HEAD:SOUR:_TREE:RIN'   => new AutomatedRecordId(I18N::translate('Record ID number')),
894            'INDI:*:SOUR:_APID'     => /* I18N: GEDCOM tag _APID */ new CustomElement(I18N::translate('Ancestry PID')),
895            'INDI:*:SOUR:DATA:NOTE' => new SubmitterText(I18N::translate('Note')),
896            'INDI:_EMPLOY'          => new CustomFact(I18N::translate('Occupation')),
897            'INDI:_FUN'             => new CustomEvent(I18N::translate('Funeral')),
898            'INDI:_INIT'            => /* I18N: GEDCOM tag _INIT - an LDS ceremony performed */ new CustomEvent(I18N::translate('Initiatory')),
899            'INDI:_ORDI'            => new CustomEvent(I18N::translate('Ordination')),
900            'INDI:_ORIG'            => new CustomFact(I18N::translate('Origin')),
901            'INDI:_DEST'            => new CustomFact(I18N::translate('Destination')),
902            'OBJE:DATE'             => new DateValue(I18N::translate('Date')),
903            'OBJE:PLAC'             => new PlaceName(I18N::translate('Place')),
904            'OBJE:_CREA'            => /* I18N: GEDCOM tag _CREA */ new CustomElement(I18N::translate('Created at')),
905            'OBJE:_ORIG'            => /* I18N: GEDCOM tag _ORIG */ new CustomElement(I18N::translate('Original text')),
906            'OBJE:_ORIG:_URL'       => new AddressWebPage(I18N::translate('URL')),
907        ];
908    }
909
910    /**
911     * @return array<string,ElementInterface>
912     *
913     * @see https://wiki-de.genealogy.net/GEDCOM/_Nutzerdef-Tag
914     */
915    private function brothersKeeperTags(): array
916    {
917        return [
918            'FAM:*:_EVN'       => new CustomElement('Event number'),
919            'FAM:CHIL:_FREL'   => new CustomElement(I18N::translate('Relationship to father')),
920            'FAM:CHIL:_MREL'   => new CustomElement(I18N::translate('Relationship to mother')),
921            'FAM:_COML'        => new CustomFamilyEvent(I18N::translate('Common law marriage')),
922            'FAM:_MARI'        => new CustomFamilyEvent(I18N::translate('Marriage intention')),
923            'FAM:_MBON'        => new CustomFamilyEvent(I18N::translate('Marriage bond')),
924            'FAM:_NMR'         => new CustomFamilyEvent(I18N::translate('Not married'), ['NOTE' => '0:M', 'SOUR' => '0:M']),
925            'FAM:_PRMN'        => new CustomElement(I18N::translate('Permanent number')),
926            'FAM:_SEPR'        => new CustomFamilyEvent(I18N::translate('Separated')),
927            'FAM:_TODO'        => new CustomElement(I18N::translate('Research task')),
928            'INDI:*:_EVN'      => new CustomElement('Event number'),
929            'INDI:NAME:_ADPN'  => new NamePersonal(I18N::translate('Adopted name'), []),
930            'INDI:NAME:_AKAN'  => new NamePersonal(I18N::translate('Also known as'), []),
931            'INDI:NAME:_BIRN'  => new NamePersonal(I18N::translate('Birth name'), []),
932            'INDI:NAME:_CALL'  => new NamePersonal('Called name', []),
933            'INDI:NAME:_CENN'  => new NamePersonal('Census name', []),
934            'INDI:NAME:_CURN'  => new NamePersonal('Current name', []),
935            'INDI:NAME:_FARN'  => new NamePersonal(I18N::translate('Estate name'), []),
936            'INDI:NAME:_FKAN'  => new NamePersonal('Formal name', []),
937            'INDI:NAME:_FRKA'  => new NamePersonal('Formerly known as', []),
938            'INDI:NAME:_GERN'  => new NamePersonal('German name', []),
939            'INDI:NAME:_HEBN'  => new NamePersonal(I18N::translate('Hebrew name'), []),
940            'INDI:NAME:_HNM'   => new NamePersonal(I18N::translate('Hebrew name'), []),
941            'INDI:NAME:_INDG'  => new NamePersonal('Indigenous name', []),
942            'INDI:NAME:_INDN'  => new NamePersonal('Indian name', []),
943            'INDI:NAME:_LNCH'  => new NamePersonal('Legal name change', []),
944            'INDI:NAME:_MARN'  => new NamePersonal('Married name', []),
945            'INDI:NAME:_MARNM' => new NamePersonal('Married name', []),
946            'INDI:NAME:_OTHN'  => new NamePersonal('Other name', []),
947            'INDI:NAME:_RELN'  => new NamePersonal('Religious name', []),
948            'INDI:NAME:_SHON'  => new NamePersonal('Short name', []),
949            'INDI:NAME:_SLDN'  => new NamePersonal('Soldier name', []),
950            'INDI:_ADPF'       => new CustomElement(I18N::translate('Adopted by father')),
951            'INDI:_ADPM'       => new CustomElement(I18N::translate('Adopted by mother')),
952            'INDI:_BRTM'       => new CustomIndividualEvent(I18N::translate('Brit milah')),
953            'INDI:_BRTM:DATE'  => new DateValue(I18N::translate('Date of brit milah')),
954            'INDI:_BRTM:PLAC'  => new PlaceName(I18N::translate('Place of brit milah')),
955            'INDI:_EMAIL'      => new AddressEmail(I18N::translate('Email address')),
956            'INDI:_EYEC'       => new CustomFact(I18N::translate('Eye color')),
957            'INDI:_FRNL'       => new CustomElement(I18N::translate('Funeral')),
958            'INDI:_HAIR'       => new CustomFact(I18N::translate('Hair color')),
959            'INDI:_HEIG'       => new CustomFact(I18N::translate('Height')),
960            'INDI:_INTE'       => new CustomElement(I18N::translate('Interment')),
961            'INDI:_MEDC'       => new CustomFact(I18N::translate('Medical')),
962            'INDI:_MILT'       => new CustomElement(I18N::translate('Military service')),
963            'INDI:_NLIV'       => new CustomFact(I18N::translate('Not living')),
964            'INDI:_NMAR'       => new CustomFact(I18N::translate('Never married'), ['NOTE' => '0:M', 'SOUR' => '0:M']),
965            'INDI:_PRMN'       => new CustomElement(I18N::translate('Permanent number')),
966            'INDI:_TODO'       => new CustomElement(I18N::translate('Research task')),
967            'INDI:_WEIG'       => new CustomFact(I18N::translate('Weight')),
968            'INDI:_YART'       => new CustomIndividualEvent(I18N::translate('Yahrzeit')),
969            // 1 XXXX
970            // 2 _EVN ##
971            // 1 ASSO @Xnnn@
972            // 2 RELA Witness at event _EVN ##
973        ];
974    }
975
976    /**
977     * @return array<string,ElementInterface>
978     */
979    private function familySearchTags(): array
980    {
981        return [
982            'INDI:_FSFTID' => /* I18N: familysearch.org */ new FamilySearchFamilyTreeId(I18N::translate('FamilySearch ID')),
983        ];
984    }
985
986    /**
987     * @return array<string,ElementInterface>
988     */
989    private function familyTreeBuilderTags(): array
990    {
991        return [
992            '*:_UPD'              => /* I18N: GEDCOM tag _UPD */ new CustomElement(I18N::translate('Updated at')), // e.g. "1 _UPD 14 APR 2012 00:14:10 GMT-5"
993            'INDI:NAME:_AKA'      => new NamePersonal(I18N::translate('Also known as'), []),
994            'OBJE:_ALBUM'         => new CustomElement(I18N::translate('Album')), // XREF to an album
995            'OBJE:_DATE'          => new DateValue(I18N::translate('Date')),
996            'OBJE:_FILESIZE'      => new CustomElement(I18N::translate('File size')),
997            'OBJE:_PHOTO_RIN'     => new CustomElement(I18N::translate('Record ID number')),
998            'OBJE:_PLACE'         => new PlaceName(I18N::translate('Place')),
999            '_ALBUM:_PHOTO'       => new CustomElement(I18N::translate('Photo')),
1000            '_ALBUM:_PHOTO:_PRIN' => new CustomElement(I18N::translate('Highlighted image')),
1001        ];
1002    }
1003
1004    /**
1005     * @return array<string,ElementInterface>
1006     *
1007     * @see https://wiki-de.genealogy.net/GEDCOM/_Nutzerdef-Tag
1008     */
1009    private function familyTreeMakerTags(): array
1010    {
1011        return [
1012            'FAM:CHIL:_FREL'              => new CustomElement(I18N::translate('Relationship to father')),
1013            'FAM:CHIL:_MREL'              => new CustomElement(I18N::translate('Relationship to mother')),
1014            'FAM:_DETS'                   => new CustomElement(I18N::translate('Death of one spouse')),
1015            'FAM:_FA1'                    => new CustomElement(I18N::translate('Fact 1')),
1016            'FAM:_FA10'                   => new CustomElement(I18N::translate('Fact 10')),
1017            'FAM:_FA11'                   => new CustomElement(I18N::translate('Fact 11')),
1018            'FAM:_FA12'                   => new CustomElement(I18N::translate('Fact 12')),
1019            'FAM:_FA13'                   => new CustomElement(I18N::translate('Fact 13')),
1020            'FAM:_FA2'                    => new CustomElement(I18N::translate('Fact 2')),
1021            'FAM:_FA3'                    => new CustomElement(I18N::translate('Fact 3')),
1022            'FAM:_FA4'                    => new CustomElement(I18N::translate('Fact 4')),
1023            'FAM:_FA5'                    => new CustomElement(I18N::translate('Fact 5')),
1024            'FAM:_FA6'                    => new CustomElement(I18N::translate('Fact 6')),
1025            'FAM:_FA7'                    => new CustomElement(I18N::translate('Fact 7')),
1026            'FAM:_FA8'                    => new CustomElement(I18N::translate('Fact 8')),
1027            'FAM:_FA9'                    => new CustomElement(I18N::translate('Fact 9')),
1028            'FAM:_MEND'                   => new CustomElement(I18N::translate('Marriage ending status')),
1029            'FAM:_MSTAT'                  => new CustomElement(I18N::translate('Marriage beginning status')),
1030            'FAM:_SEPR'                   => new CustomElement(I18N::translate('Separation')),
1031            'HEAD:_SCHEMA'                => new CustomElement(I18N::translate('Schema')),
1032            'HEAD:_SCHEMA:FAM'            => new CustomElement(I18N::translate('Family')),
1033            'HEAD:_SCHEMA:FAM:_FA*:LABL'  => new CustomElement(I18N::translate('Label')),
1034            'HEAD:_SCHEMA:FAM:_FA1'       => new CustomElement(I18N::translate('Fact 1')),
1035            'HEAD:_SCHEMA:FAM:_FA10'      => new CustomElement(I18N::translate('Fact 10')),
1036            'HEAD:_SCHEMA:FAM:_FA11'      => new CustomElement(I18N::translate('Fact 11')),
1037            'HEAD:_SCHEMA:FAM:_FA12'      => new CustomElement(I18N::translate('Fact 12')),
1038            'HEAD:_SCHEMA:FAM:_FA13'      => new CustomElement(I18N::translate('Fact 13')),
1039            'HEAD:_SCHEMA:FAM:_FA2'       => new CustomElement(I18N::translate('Fact 2')),
1040            'HEAD:_SCHEMA:FAM:_FA3'       => new CustomElement(I18N::translate('Fact 3')),
1041            'HEAD:_SCHEMA:FAM:_FA4'       => new CustomElement(I18N::translate('Fact 4')),
1042            'HEAD:_SCHEMA:FAM:_FA5'       => new CustomElement(I18N::translate('Fact 5')),
1043            'HEAD:_SCHEMA:FAM:_FA6'       => new CustomElement(I18N::translate('Fact 6')),
1044            'HEAD:_SCHEMA:FAM:_FA7'       => new CustomElement(I18N::translate('Fact 7')),
1045            'HEAD:_SCHEMA:FAM:_FA8'       => new CustomElement(I18N::translate('Fact 8')),
1046            'HEAD:_SCHEMA:FAM:_FA9'       => new CustomElement(I18N::translate('Fact 9')),
1047            'HEAD:_SCHEMA:FAM:_M*:LABL'   => new CustomElement(I18N::translate('Label')),
1048            'HEAD:_SCHEMA:FAM:_MEND'      => new CustomElement(I18N::translate('Marriage ending status')),
1049            'HEAD:_SCHEMA:FAM:_MSTAT'     => new CustomElement(I18N::translate('Marriage beginning status')),
1050            'HEAD:_SCHEMA:INDI'           => new CustomElement(I18N::translate('Individual')),
1051            'HEAD:_SCHEMA:INDI:_FA*:LABL' => new CustomElement(I18N::translate('Label')),
1052            'HEAD:_SCHEMA:INDI:_FA1'      => new CustomElement(I18N::translate('Fact 1')),
1053            'HEAD:_SCHEMA:INDI:_FA10'     => new CustomElement(I18N::translate('Fact 10')),
1054            'HEAD:_SCHEMA:INDI:_FA11'     => new CustomElement(I18N::translate('Fact 11')),
1055            'HEAD:_SCHEMA:INDI:_FA12'     => new CustomElement(I18N::translate('Fact 12')),
1056            'HEAD:_SCHEMA:INDI:_FA13'     => new CustomElement(I18N::translate('Fact 13')),
1057            'HEAD:_SCHEMA:INDI:_FA2'      => new CustomElement(I18N::translate('Fact 2')),
1058            'HEAD:_SCHEMA:INDI:_FA3'      => new CustomElement(I18N::translate('Fact 3')),
1059            'HEAD:_SCHEMA:INDI:_FA4'      => new CustomElement(I18N::translate('Fact 4')),
1060            'HEAD:_SCHEMA:INDI:_FA5'      => new CustomElement(I18N::translate('Fact 5')),
1061            'HEAD:_SCHEMA:INDI:_FA6'      => new CustomElement(I18N::translate('Fact 6')),
1062            'HEAD:_SCHEMA:INDI:_FA7'      => new CustomElement(I18N::translate('Fact 7')),
1063            'HEAD:_SCHEMA:INDI:_FA8'      => new CustomElement(I18N::translate('Fact 8')),
1064            'HEAD:_SCHEMA:INDI:_FA9'      => new CustomElement(I18N::translate('Fact 9')),
1065            'HEAD:_SCHEMA:INDI:_FREL'     => new CustomElement(I18N::translate('Relationship to father')),
1066            'HEAD:_SCHEMA:INDI:_M*:LABL'  => new CustomElement(I18N::translate('Label')),
1067            'HEAD:_SCHEMA:INDI:_MREL'     => new CustomElement(I18N::translate('Relationship to mother')),
1068            'INDI:*:SOUR:_APID'           => /* I18N: GEDCOM tag _APID */ new CustomElement(I18N::translate('Ancestry.com source identifier')),
1069            'INDI:*:SOUR:_LINK'           => new CustomElement(I18N::translate('External link')),
1070            'INDI:NAME:_AKA'              => new NamePersonal(I18N::translate('Also known as'), []),
1071            'INDI:NAME:_MARNM'            => new NamePersonal(I18N::translate('Married name'), []),
1072            'INDI:_CIRC'                  => new CustomElement(I18N::translate('Circumcision')),
1073            'INDI:_DCAUSE'                => new CustomElement(I18N::translate('Cause of death')),
1074            'INDI:_DEG'                   => new CustomElement(I18N::translate('Degree')),
1075            'INDI:_DNA'                   => new CustomElement(I18N::translate('DNA markers')),
1076            'INDI:_ELEC'                  => new CustomElement('Elected'),
1077            'INDI:_EMPLOY'                => new CustomElement('Employment'),
1078            'INDI:_EXCM'                  => new CustomElement('Excommunicated'),
1079            'INDI:_FA1'                   => new CustomElement(I18N::translate('Fact 1')),
1080            'INDI:_FA10'                  => new CustomElement(I18N::translate('Fact 10')),
1081            'INDI:_FA11'                  => new CustomElement(I18N::translate('Fact 11')),
1082            'INDI:_FA12'                  => new CustomElement(I18N::translate('Fact 12')),
1083            'INDI:_FA13'                  => new CustomElement(I18N::translate('Fact 13')),
1084            'INDI:_FA2'                   => new CustomElement(I18N::translate('Fact 2')),
1085            'INDI:_FA3'                   => new CustomElement(I18N::translate('Fact 3')),
1086            'INDI:_FA4'                   => new CustomElement(I18N::translate('Fact 4')),
1087            'INDI:_FA5'                   => new CustomElement(I18N::translate('Fact 5')),
1088            'INDI:_FA6'                   => new CustomElement(I18N::translate('Fact 6')),
1089            'INDI:_FA7'                   => new CustomElement(I18N::translate('Fact 7')),
1090            'INDI:_FA8'                   => new CustomElement(I18N::translate('Fact 8')),
1091            'INDI:_FA9'                   => new CustomElement(I18N::translate('Fact 9')),
1092            'INDI:_MDCL'                  => new CustomElement(I18N::translate('Medical')),
1093            'INDI:_MILT'                  => new CustomElement(I18N::translate('Military service')),
1094            'INDI:_MILTID'                => new CustomElement('Military ID number'),
1095            'INDI:_MISN'                  => new CustomElement('Mission'),
1096            'INDI:_NAMS'                  => new CustomElement(I18N::translate('Namesake')),
1097            'INDI:_UNKN'                  => new CustomElement(I18N::translate('Unknown')), // Special individual ID code for later file comparisons
1098        ];
1099    }
1100
1101    /**
1102     * @return array<string,ElementInterface>
1103     */
1104    private function gedcomLTags(): array
1105    {
1106        return [
1107            'FAM:*:ADDR:_NAME'                => new CustomElement(I18N::translate('Name of addressee')),
1108            // I18N: https://gov.genealogy.net
1109            'FAM:*:PLAC:_GOV'                 => new GovIdentifier(I18N::translate('GOV identifier')),
1110            'FAM:*:PLAC:_LOC'                 => new XrefLocation(I18N::translate('Location')),
1111            // I18N: https://en.wikipedia.org/wiki/Maidenhead_Locator_System
1112            'FAM:*:PLAC:_MAIDENHEAD'          => new MaidenheadLocator(I18N::translate('Maidenhead location code')),
1113            'FAM:*:PLAC:_POST'                => new AddressPostalCode(I18N::translate('Postal code')),
1114            'FAM:*:PLAC:_POST:DATE'           => new DateValue(I18N::translate('Date')),
1115            'FAM:*:_ASSO'                     => new XrefAssociate(I18N::translate('Associate')),
1116            'FAM:*:_ASSO:NOTE'                => new NoteStructure(I18N::translate('Note')),
1117            'FAM:*:_ASSO:RELA'                => new RelationIsDescriptor(I18N::translate('Relationship')),
1118            'FAM:*:_ASSO:SOUR'                => new XrefSource(I18N::translate('Source citation')),
1119            'FAM:*:_ASSO:SOUR:DATA'           => new SourceData(I18N::translate('Data')),
1120            'FAM:*:_ASSO:SOUR:DATA:DATE'      => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
1121            'FAM:*:_ASSO:SOUR:DATA:TEXT'      => new TextFromSource(I18N::translate('Text')),
1122            'FAM:*:_ASSO:SOUR:EVEN'           => new EventTypeCitedFrom(I18N::translate('Event')),
1123            'FAM:*:_ASSO:SOUR:EVEN:ROLE'      => new RoleInEvent(I18N::translate('Role')),
1124            'FAM:*:_ASSO:SOUR:NOTE'           => new NoteStructure(I18N::translate('Note')),
1125            'FAM:*:_ASSO:SOUR:OBJE'           => new XrefMedia(I18N::translate('Media object')),
1126            'FAM:*:_ASSO:SOUR:PAGE'           => new WhereWithinSource(I18N::translate('Citation details')),
1127            'FAM:*:_ASSO:SOUR:QUAY'           => new CertaintyAssessment(I18N::translate('Quality of data')),
1128            'FAM:*:_WITN'                     => new CustomElement(I18N::translate('Witnesses')),
1129            'FAM:_ASSO'                       => new XrefAssociate(I18N::translate('Associate')),
1130            'FAM:_ASSO:RELA'                  => new RelationIsDescriptor(I18N::translate('Relationship')),
1131            'FAM:_STAT'                       => new FamilyStatusText(I18N::translate('Family status')),
1132            'FAM:_TODO'                       => new ResearchTask(I18N::translate('Research task'), ['DESC' => '1:1', '_CAT' => '0:1', '_PRTY' => '0:1', 'TYPE' => '0:1', 'NOTE' => '0:M', 'DATA' => '0:1', 'STAT'  => '0:1', '_CDATE' => '0:1', '_RDATE' => '0:1', 'REPO' => '0:1', '_UID' => '0:M']),
1133            'FAM:_TODO:DATA'                  => new SubmitterText(I18N::translate('The solution')),
1134            'FAM:_TODO:DATE'                  => new DateValue(I18N::translate('Creation date')),
1135            'FAM:_TODO:DESC'                  => new CustomElement(I18N::translate('Description')),
1136            'FAM:_TODO:NOTE'                  => new SubmitterText(I18N::translate('Note')),
1137            'FAM:_TODO:REPO'                  => new XrefRepository(I18N::translate('Repository'), []),
1138            'FAM:_TODO:STAT'                  => new ResearchTaskStatus(I18N::translate('Status')),
1139            'FAM:_TODO:TYPE'                  => new ResearchTaskType(I18N::translate('Type of research task')),
1140            'FAM:_TODO:_CAT'                  => new CustomElement(I18N::translate('Category')),
1141            'FAM:_TODO:_CDATE'                => new DateValue(I18N::translate('Completion date')),
1142            'FAM:_TODO:_PRTY'                 => new ResearchTaskPriority(I18N::translate('Priority')),
1143            'FAM:_TODO:_RDATE'                => new DateValue(I18N::translate('Reminder date')),
1144            'FAM:_UID'                        => new PafUid(I18N::translate('Unique identifier')),
1145            'HEAD:GEDC:VERS:_ADDENDUM'        => new EmptyElement(I18N::translate('GEDCOM-L')),
1146            'HEAD:GEDC:VERS:_ADDENDUM:VERS'   => new VersionNumber(I18N::translate('Version')),
1147            'HEAD:GEDC:VERS:_ADDENDUM:WWW'    => new AddressWebPage(I18N::translate('URL')),
1148            'HEAD:SOUR:CORP:ADDR:_NAME'       => new CustomElement(I18N::translate('Name of addressee')),
1149            'HEAD:_SCHEMA'                    => new EmptyElement(I18N::translate('Schema')),
1150            'HEAD:_SCHEMA:*'                  => new EmptyElement(I18N::translate('Base GEDCOM tag')),
1151            'HEAD:_SCHEMA:*:*'                => new EmptyElement(I18N::translate('New GEDCOM tag')),
1152            'HEAD:_SCHEMA:*:*:*'              => new EmptyElement(I18N::translate('New GEDCOM tag')),
1153            'HEAD:_SCHEMA:*:*:*:*'            => new EmptyElement(I18N::translate('New GEDCOM tag')),
1154            'HEAD:_SCHEMA:*:*:*:*:*'          => new EmptyElement(I18N::translate('New GEDCOM tag')),
1155            'HEAD:_SCHEMA:*:*:*:*:*:*'        => new EmptyElement(I18N::translate('New GEDCOM tag')),
1156            'HEAD:_SCHEMA:*:*:*:*:*:*:_DEFN'  => new EmptyElement(I18N::translate('Definition')),
1157            'HEAD:_SCHEMA:*:*:*:*:*:_DEFN'    => new EmptyElement(I18N::translate('Definition')),
1158            'HEAD:_SCHEMA:*:*:*:*:_DEFN'      => new EmptyElement(I18N::translate('Definition')),
1159            'HEAD:_SCHEMA:*:*:*:_DEFN'        => new EmptyElement(I18N::translate('Definition')),
1160            'HEAD:_SCHEMA:*:*:_DEFN'          => new EmptyElement(I18N::translate('Definition')),
1161            'INDI:*:ADDR:_NAME'               => new CustomElement(I18N::translate('Name of addressee')),
1162            // I18N: https://gov.genealogy.net
1163            'INDI:*:PLAC:_GOV'                => new GovIdentifier(I18N::translate('GOV identifier')),
1164            'INDI:*:PLAC:_LOC'                => new XrefLocation(I18N::translate('Location')),
1165            // I18N: https://en.wikipedia.org/wiki/Maidenhead_Locator_System
1166            'INDI:*:PLAC:_MAIDENHEAD'         => new MaidenheadLocator(I18N::translate('Maidenhead location code')),
1167            'INDI:*:PLAC:_POST'               => new AddressPostalCode(I18N::translate('Postal code')),
1168            'INDI:*:PLAC:_POST:DATE'          => new DateValue(I18N::translate('Date')),
1169            'INDI:*:_ASSO'                    => new XrefAssociate(I18N::translate('Associate')),
1170            'INDI:*:_ASSO:NOTE'               => new NoteStructure(I18N::translate('Note')),
1171            'INDI:*:_ASSO:RELA'               => new RelationIsDescriptor(I18N::translate('Relationship')),
1172            'INDI:*:_ASSO:SOUR'               => new XrefSource(I18N::translate('Source citation')),
1173            'INDI:*:_ASSO:SOUR:DATA'          => new SourceData(I18N::translate('Data')),
1174            'INDI:*:_ASSO:SOUR:DATA:DATE'     => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
1175            'INDI:*:_ASSO:SOUR:DATA:TEXT'     => new TextFromSource(I18N::translate('Text')),
1176            'INDI:*:_ASSO:SOUR:EVEN'          => new EventTypeCitedFrom(I18N::translate('Event')),
1177            'INDI:*:_ASSO:SOUR:EVEN:ROLE'     => new RoleInEvent(I18N::translate('Role')),
1178            'INDI:*:_ASSO:SOUR:NOTE'          => new NoteStructure(I18N::translate('Note')),
1179            'INDI:*:_ASSO:SOUR:OBJE'          => new XrefMedia(I18N::translate('Media object')),
1180            'INDI:*:_ASSO:SOUR:PAGE'          => new WhereWithinSource(I18N::translate('Citation details')),
1181            'INDI:*:_ASSO:SOUR:QUAY'          => new CertaintyAssessment(I18N::translate('Quality of data')),
1182            'INDI:*:_WITN'                    => new CustomElement(I18N::translate('Witnesses')),
1183            'INDI:BAPM:_GODP'                 => new CustomElement(I18N::translate('Godparents')),
1184            'INDI:CHR:_GODP'                  => new CustomElement(I18N::translate('Godparents')),
1185            'INDI:NAME:_RUFNAME'              => new NamePieceGiven(I18N::translate('Rufname')),
1186            'INDI:OBJE:_PRIM'                 => new CustomElement(I18N::translate('Highlighted image')),
1187            'INDI:SEX'                        => new SexXValue(I18N::translate('Gender')),
1188            'INDI:_TODO'                      => new ResearchTask(I18N::translate('Research task')),
1189            'INDI:_TODO:DATA'                 => new SubmitterText(I18N::translate('The solution')),
1190            'INDI:_TODO:DATE'                 => new DateValue(I18N::translate('Creation date')),
1191            'INDI:_TODO:DESC'                 => new CustomElement(I18N::translate('Description')),
1192            'INDI:_TODO:NOTE'                 => new SubmitterText(I18N::translate('Note')),
1193            'INDI:_TODO:REPO'                 => new XrefRepository(I18N::translate('Repository'), []),
1194            'INDI:_TODO:STAT'                 => new ResearchTaskStatus(I18N::translate('Status')),
1195            'INDI:_TODO:TYPE'                 => new ResearchTaskType(I18N::translate('Type of research task')),
1196            'INDI:_TODO:_CAT'                 => new CustomElement(I18N::translate('Category')),
1197            'INDI:_TODO:_CDATE'               => new DateValue(I18N::translate('Completion date')),
1198            'INDI:_TODO:_PRTY'                => new ResearchTaskPriority(I18N::translate('Priority')),
1199            'INDI:_TODO:_RDATE'               => new DateValue(I18N::translate('Reminder date')),
1200            'INDI:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1201            'NOTE:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1202            'OBJE:FILE:_PRIM'                 => new CustomElement(I18N::translate('Highlighted image')),
1203            'OBJE:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1204            'REPO:ADDR:_NAME'                 => new CustomElement(I18N::translate('Name of addressee')),
1205            'REPO:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1206            'SOUR:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1207            'SOUR:DATA:EVEN:PLAC:_LOC'        => new XrefLocation(I18N::translate('Location')),
1208            // I18N: https://en.wikipedia.org/wiki/Maidenhead_Locator_System
1209            'SOUR:DATA:EVEN:PLAC:_MAIDENHEAD' => new MaidenheadLocator(I18N::translate('Maidenhead location code')),
1210            'SOUR:DATA:EVEN:PLAC:_POST'       => new AddressPostalCode(I18N::translate('Postal code')),
1211            'SOUR:DATA:EVEN:PLAC:_POST:DATE'  => new DateValue(I18N::translate('Date')),
1212            'SUBM:ADDR:_NAME'                 => new CustomElement(I18N::translate('Name of addressee')),
1213            'SUBM:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1214            'SUBN:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1215            '_LOC'                            => new LocationRecord(I18N::translate('Location')),
1216            '_LOC:CHAN'                       => new Change(I18N::translate('Last change')),
1217            '_LOC:CHAN:DATE'                  => new ChangeDate(I18N::translate('Date of last change')),
1218            '_LOC:CHAN:DATE:TIME'             => new TimeValue(I18N::translate('Time')),
1219            '_LOC:CHAN:NOTE'                  => new NoteStructure(I18N::translate('Note')),
1220            '_LOC:EVEN'                       => new CustomEvent(I18N::translate('Event')),
1221            '_LOC:EVEN:DATE'                  => new DateValue(I18N::translate('Date of event')),
1222            '_LOC:EVEN:PLAC'                  => new PlaceName(I18N::translate('Place of event')),
1223            '_LOC:EVEN:PLAC:FONE'             => new PlacePhoneticVariation(I18N::translate('Phonetic place')),
1224            '_LOC:EVEN:PLAC:FONE:TYPE'        => new PhoneticType(I18N::translate('Type')),
1225            '_LOC:EVEN:PLAC:FORM'             => new PlaceHierarchy(I18N::translate('Format')),
1226            '_LOC:EVEN:PLAC:MAP'              => new EmptyElement(I18N::translate('Coordinates'), ['LATI' => '1:1', 'LONG' => '1:1']),
1227            '_LOC:EVEN:PLAC:MAP:LATI'         => new PlaceLatitude(I18N::translate('Latitude')),
1228            '_LOC:EVEN:PLAC:MAP:LONG'         => new PlaceLongtitude(I18N::translate('Longitude')),
1229            '_LOC:EVEN:PLAC:NOTE'             => new NoteStructure(I18N::translate('Note')),
1230            '_LOC:EVEN:PLAC:ROMN'             => new PlaceRomanizedVariation(I18N::translate('Romanized place')),
1231            '_LOC:EVEN:PLAC:ROMN:TYPE'        => new RomanizedType(I18N::translate('Type')),
1232            '_LOC:EVEN:TYPE'                  => new EventAttributeType(I18N::translate('Type of event')),
1233            '_LOC:EVEN:AGNC'                  => new ResponsibleAgency(I18N::translate('Agency')),
1234            '_LOC:EVEN:ADDR'                  => new AddressLine(I18N::translate('Address')),
1235            '_LOC:EVEN:ADDR:ADR1'             => new AddressLine1(I18N::translate('Address line 1')),
1236            '_LOC:EVEN:ADDR:ADR2'             => new AddressLine2(I18N::translate('Address line 2')),
1237            '_LOC:EVEN:ADDR:ADR3'             => new AddressLine3(I18N::translate('Address line 3')),
1238            '_LOC:EVEN:ADDR:CITY'             => new AddressCity(I18N::translate('City')),
1239            '_LOC:EVEN:ADDR:CTRY'             => new AddressCountry(I18N::translate('Country')),
1240            '_LOC:EVEN:ADDR:POST'             => new AddressPostalCode(I18N::translate('Postal code')),
1241            '_LOC:EVEN:ADDR:STAE'             => new AddressState(I18N::translate('State')),
1242            '_LOC:EVEN:CAUS'                  => new CauseOfEvent(I18N::translate('Cause')),
1243            '_LOC:EVEN:RELI'                  => new ReligiousAffiliation(I18N::translate('Religion'), []),
1244            '_LOC:EVEN:RESN'                  => new RestrictionNotice(I18N::translate('Restriction')),
1245            '_LOC:EVEN:SOUR'                  => new XrefSource(I18N::translate('Source citation')),
1246            '_LOC:EVEN:NOTE'                  => new NoteStructure(I18N::translate('Note')),
1247            '_LOC:EVEN:OBJE'                  => new XrefMedia(I18N::translate('Media object')),
1248            '_LOC:MAP'                        => new EmptyElement(I18N::translate('Coordinates'), ['LATI' => '1:1', 'LONG' => '1:1']),
1249            '_LOC:MAP:LATI'                   => new PlaceLatitude(I18N::translate('Latitude')),
1250            '_LOC:MAP:LONG'                   => new PlaceLongtitude(I18N::translate('Longitude')),
1251            '_LOC:NAME'                       => new PlaceName(I18N::translate('Place'), ['ABBR' => '0:1', 'DATE' => '0:1', 'LANG' => '0:1', 'SOUR' => '0:M']),
1252            '_LOC:NAME:ABBR'                  => new CustomElement(I18N::translate('Abbreviation')),
1253            '_LOC:NAME:ABBR:TYPE'             => new CustomElement(I18N::translate('Type of abbreviation')),
1254            '_LOC:NAME:DATE'                  => new DateValue(I18N::translate('Date')),
1255            '_LOC:NAME:LANG'                  => new LanguageId(I18N::translate('Language')),
1256            '_LOC:NAME:SOUR'                  => new XrefSource(I18N::translate('Source')),
1257            '_LOC:NOTE'                       => new NoteStructure(I18N::translate('Note')),
1258            '_LOC:OBJE'                       => new XrefMedia(I18N::translate('Media')),
1259            '_LOC:RELI'                       => new ReligiousAffiliation(I18N::translate('Religion'), []),
1260            '_LOC:SOUR'                       => new XrefSource(I18N::translate('Source')),
1261            '_LOC:SOUR:DATA'                  => new SourceData(I18N::translate('Data')),
1262            '_LOC:SOUR:DATA:DATE'             => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
1263            '_LOC:SOUR:DATA:TEXT'             => new TextFromSource(I18N::translate('Text')),
1264            '_LOC:SOUR:EVEN'                  => new EventTypeCitedFrom(I18N::translate('Event')),
1265            '_LOC:SOUR:EVEN:ROLE'             => new RoleInEvent(I18N::translate('Role')),
1266            '_LOC:SOUR:NOTE'                  => new NoteStructure(I18N::translate('Note')),
1267            '_LOC:SOUR:OBJE'                  => new XrefMedia(I18N::translate('Media object')),
1268            '_LOC:SOUR:PAGE'                  => new WhereWithinSource(I18N::translate('Citation details')),
1269            '_LOC:SOUR:QUAY'                  => new CertaintyAssessment(I18N::translate('Quality of data')),
1270            '_LOC:TYPE'                       => new CustomElement(I18N::translate('Type of location'), ['DATE' => '0:1', '_GOVTYPE' => '0:1', 'SOUR' => '0:M']),
1271            '_LOC:TYPE:DATE'                  => new DateValue(I18N::translate('Date')),
1272            '_LOC:TYPE:SOUR'                  => new XrefSource(I18N::translate('Source')),
1273            '_LOC:TYPE:_GOVTYPE'              => new CustomElement(I18N::translate('GOV identifier type')),
1274            '_LOC:_AIDN'                      => new CustomElement(I18N::translate('Administrative ID')),
1275            '_LOC:_AIDN:DATE'                 => new DateValue(I18N::translate('Date')),
1276            '_LOC:_AIDN:SOUR'                 => new XrefSource(I18N::translate('Source')),
1277            '_LOC:_AIDN:TYPE'                 => new CustomElement(I18N::translate('Type of administrative ID')),
1278            '_LOC:_DMGD'                      => new CustomElement(I18N::translate('Demographic data')),
1279            '_LOC:_DMGD:DATE'                 => new DateValue(I18N::translate('Date')),
1280            '_LOC:_DMGD:SOUR'                 => new XrefSource(I18N::translate('Source')),
1281            '_LOC:_DMGD:TYPE'                 => new CustomElement(I18N::translate('Type of demographic data')),
1282            // I18N: https://gov.genealogy.net
1283            '_LOC:_GOV'                       => new GovIdentifier(I18N::translate('GOV identifier')),
1284            '_LOC:_LOC'                       => new XrefLocation(I18N::translate('Parent location'), ['DATE' => '0:1', 'SOUR' => '0:M', 'TYPE' => '0:1']),
1285            '_LOC:_LOC:DATE'                  => new DateValue(I18N::translate('Date')),
1286            '_LOC:_LOC:SOUR'                  => new XrefSource(I18N::translate('Source')),
1287            '_LOC:_LOC:TYPE'                  => new HierarchicalRelationship(I18N::translate('Hierarchical relationship')),
1288            // I18N: https://en.wikipedia.org/wiki/Maidenhead_Locator_System
1289            '_LOC:_MAIDENHEAD'                => new MaidenheadLocator(I18N::translate('Maidenhead location code')),
1290            '_LOC:_POST'                      => new AddressPostalCode(I18N::translate('Postal code')),
1291            '_LOC:_POST:DATE'                 => new DateValue(I18N::translate('Date')),
1292            '_LOC:_POST:SOUR'                 => new XrefSource(I18N::translate('Source')),
1293            '_LOC:_UID'                       => new PafUid(I18N::translate('Unique identifier')),
1294            '_LOC:*:SOUR:DATA'                => new SourceData(I18N::translate('Data')),
1295            '_LOC:*:SOUR:DATA:DATE'           => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
1296            '_LOC:*:SOUR:DATA:TEXT'           => new TextFromSource(I18N::translate('Text')),
1297            '_LOC:*:SOUR:EVEN'                => new EventTypeCitedFrom(I18N::translate('Event')),
1298            '_LOC:*:SOUR:EVEN:ROLE'           => new RoleInEvent(I18N::translate('Role')),
1299            '_LOC:*:SOUR:NOTE'                => new NoteStructure(I18N::translate('Note')),
1300            '_LOC:*:SOUR:OBJE'                => new XrefMedia(I18N::translate('Media object')),
1301            '_LOC:*:SOUR:PAGE'                => new WhereWithinSource(I18N::translate('Citation details')),
1302            '_LOC:*:SOUR:QUAY'                => new CertaintyAssessment(I18N::translate('Quality of data')),
1303        ];
1304    }
1305
1306    /**
1307     * @return array<string,ElementInterface>
1308     */
1309    private function geneatique(): array
1310    {
1311        return [
1312            /*
1313            Pour déclarer les témoins dans les actes de naissance
1314
1315            Balise GEDCOM non valide. INDI:BIRT:ASSO
1316            INDI:BIRT:ASSO:TYPE
1317            INDI:BIRT:ASSO:RELA
1318            INDI:DEAT:PLAC:QUAY
1319            INDI:BIRT:OBJE:QUAY
1320            INDI:BIRT:SOUR:TEXT
1321
1322            Dans les mariages
1323
1324            FAM:MARR:ASSO
1325            FAM:MARR:ASSO:TYPE
1326            FAM:MARR:ASSO:RELA
1327            FAM:MARR:WWW:QUAY
1328            OBJE:WWW
1329            OBJE:SOUR:TEXTHTTPS
1330            OBJE:NOTE:WWW
1331            SOUR:QUAY
1332            SOUR:TYPE
1333            */
1334        ];
1335    }
1336
1337    /**
1338     * @return array<string,ElementInterface>
1339     */
1340    private function genPlusWinTags(): array
1341    {
1342        return [
1343            'FAM:*:ADDR:_NUM'         => new CustomElement(I18N::translate('House number')),
1344            'FAM:*:ADDR:_STRASSE'     => new CustomElement(I18N::translate('Street name')),
1345            'FAM:*:DATE:_ZUS'         => new CustomElement(I18N::translate('Additional information')),
1346            'FAM:*:OBJE:_PRIM'        => new CustomElement(I18N::translate('Highlighted image')),
1347            'FAM:*:PLAC:_AON'         => new CustomElement(I18N::translate('Alternative place name')),
1348            // I18N: https://foko.genealogy.net
1349            'FAM:*:PLAC:_FCTRY'       => new CustomElement(I18N::translate('FOKO country')),
1350            // I18N: https://foko.genealogy.net
1351            'FAM:*:PLAC:_FSTAE'       => new CustomElement(I18N::translate('FOKO country')),
1352            // I18N: https://gov.genealogy.net
1353            'FAM:*:PLAC:_GOV'         => new GovIdentifier(I18N::translate('GOV identifier')),
1354            // I18N: https://en.wikipedia.org/wiki/Maidenhead_Locator_System
1355            'FAM:*:PLAC:_MAIDENHEAD'  => new MaidenheadLocator(I18N::translate('Maidenhead location code')),
1356            'FAM:*:PLAC:_POST'        => new AddressPostalCode(I18N::translate('Postal code')),
1357            'FAM:*:PLAC:_SIC'         => new CustomElement(I18N::translate('Reliability of the information')),
1358            'FAM:*:PLAC:_ZUS'         => new CustomElement(I18N::translate('Additional information')),
1359            'FAM:*:SOUR:_ORI'         => new TextFromSource(I18N::translate('Original text')),
1360            'FAM:*:SOUR:_ZUS'         => new CustomElement(I18N::translate('Additional information')),
1361            'FAM:*:SOUR:PAGE:_ZUS'    => new CustomElement(I18N::translate('Additional information')),
1362            'FAM:*:_ASSO'             => new XrefAssociate(I18N::translate('Associate')),
1363            'FAM:*:_CERT'             => new CustomElement(I18N::translate('Certificate number')),
1364            'FAM:*:_COM'              => new CustomElement(I18N::translate('Comment')),
1365            'FAM:*:_SITE'             => new CustomElement(I18N::translate('Extra information')),
1366            'FAM:*:_WITN'             => new CustomElement(I18N::translate('Witnesses')),
1367            'FAM:OBJE:_PRIM'          => new CustomElement(I18N::translate('Highlighted image')),
1368            'FAM:SOUR:_ORI'           => new TextFromSource(I18N::translate('Original text')),
1369            'FAM:SOUR:_ZUS'           => new CustomElement(I18N::translate('Additional information')),
1370            'FAM:SOUR:PAGE:_ZUS'      => new CustomElement(I18N::translate('Additional information')),
1371            'FAM:_CREAT'              => new DateValue(I18N::translate('Creation date')),
1372            'FAM:_LIV'                => new CustomElement(I18N::translate('Cohabitation')),
1373            'FAM:_NAME'               => new CustomElement(I18N::translate('Joint family name')),
1374            'FAM:_UID'                => new PafUid(I18N::translate('Unique identifier')),
1375            'INDI:*:ADDR:_NUM'        => new CustomElement(I18N::translate('House number')),
1376            'INDI:*:ADDR:_STRASSE'    => new CustomElement(I18N::translate('Street name')),
1377            'INDI:*:DATE:_ZUS'        => new CustomElement(I18N::translate('Additional information')),
1378            'INDI:*:OBJE:_PRIM'       => new CustomElement(I18N::translate('Highlighted image')),
1379            'INDI:*:PLAC:_AON'        => new CustomElement(I18N::translate('Alternative place name')),
1380            // I18N: https://foko.genealogy.net
1381            'INDI:*:PLAC:_FCTRY'      => new CustomElement(I18N::translate('FOKO country')),
1382            // I18N: https://foko.genealogy.net
1383            'INDI:*:PLAC:_FSTAE'      => new CustomElement(I18N::translate('FOKO country')),
1384            // I18N: https://gov.genealogy.net
1385            'INDI:*:PLAC:_GOV'        => new GovIdentifier(I18N::translate('GOV identifier')),
1386            // I18N: https://en.wikipedia.org/wiki/Maidenhead_Locator_System
1387            'INDI:*:PLAC:_MAIDENHEAD' => new MaidenheadLocator(I18N::translate('Maidenhead location code')),
1388            'INDI:*:PLAC:_POST'       => new AddressPostalCode(I18N::translate('Postal code')),
1389            'INDI:*:PLAC:_SIC'        => new CustomElement(I18N::translate('Reliability of the information')),
1390            'INDI:*:PLAC:_ZUS'        => new CustomElement(I18N::translate('Additional information')),
1391            'INDI:*:SOUR:_ORI'        => new TextFromSource(I18N::translate('Original text')),
1392            'INDI:*:SOUR:_ZUS'        => new CustomElement(I18N::translate('Additional information')),
1393            'INDI:*:SOUR:PAGE:_ZUS'   => new CustomElement(I18N::translate('Additional information')),
1394            'INDI:*:_ASSO'            => new XrefAssociate(I18N::translate('Associate')),
1395            'INDI:*:_CERT'            => new CustomElement(I18N::translate('Certificate number')),
1396            'INDI:*:_COM'             => new CustomElement(I18N::translate('Comment')),
1397            'INDI:*:_SITE'            => new CustomElement(I18N::translate('Extra information')),
1398            'INDI:*:_WITN'            => new CustomElement(I18N::translate('Witnesses')),
1399            'INDI:BAPM:_GODP'         => new CustomElement(I18N::translate('Godparents')),
1400            'INDI:CHR:_GODP'          => new CustomElement(I18N::translate('Godparents')),
1401            'INDI:OBJE:_PRIM'         => new CustomElement(I18N::translate('Highlighted image')),
1402            'INDI:SOUR:_ORI'          => new TextFromSource(I18N::translate('Original text')),
1403            'INDI:SOUR:_ZUS'          => new CustomElement(I18N::translate('Additional information')),
1404            'INDI:SOUR:PAGE:_ZUS'     => new CustomElement(I18N::translate('Additional information')),
1405            'INDI:NAME:_AKA'          => new CustomElement(I18N::translate('Also known as')),
1406            // https://en.wikipedia.org/wiki/Rufname
1407            'INDI:NAME:RUFN'          => new CustomElement(I18N::translate('Rufname')),
1408            'INDI:_CREAT'             => new CustomElement(I18N::translate('Creation date')),
1409            'INDI:_HEIM'              => new CustomElement(/* I18N: German Bürgerort */ I18N::translate('Place of citizenship')),
1410            'INDI:_UID'               => new PafUid(I18N::translate('Unique identifier')),
1411            'NOTE:_CREAT'             => new DateValue(I18N::translate('Creation date')),
1412            'NOTE:_UID'               => new PafUid(I18N::translate('Unique identifier')),
1413            'OBJE:_CREAT'             => new DateValue(I18N::translate('Creation date')),
1414            'OBJE:_UID'               => new PafUid(I18N::translate('Unique identifier')),
1415            'REPO:_CREAT'             => new DateValue(I18N::translate('Creation date')),
1416            'REPO:_UID'               => new PafUid(I18N::translate('Unique identifier')),
1417            'SOUR:_CREAT'             => new DateValue(I18N::translate('Creation date')),
1418            'SOUR:_KTIT'              => new SourceFiledByEntry(I18N::translate('Abbreviation')),
1419            'SOUR:_UID'               => new PafUid(I18N::translate('Unique identifier')),
1420        ];
1421    }
1422
1423    /**
1424     * @return array<string,ElementInterface>
1425     */
1426    private function heredis(): array
1427    {
1428        return [
1429            'INDI:SIGN'                   => new CustomElement(I18N::translate('Signature')),
1430            /* Reported on the forum - but what do they mean?
1431            'INDI:_FIL'                   => new CustomElement(I18N::translate('???')),
1432            'INDI:*:_FNA'                 => new CustomElement(I18N::translate('???')),
1433            'INDI:????:????:_SUBMAP'      => new EmptyElement(I18N::translate('Coordinates'), ['INDI' => '1:1', 'LONG' => '1:1']),
1434            'INDI:????:????:_SUBMAP:LATI' => new PlaceLatitude(I18N::translate('Latitude')),
1435            'INDI:????:????:_SUBMAP:LONG' => new PlaceLongtitude(I18N::translate('Longitude')),
1436            */
1437        ];
1438    }
1439
1440    /**
1441     * @see http://support.legacyfamilytree.com/article/AA-00520/0/GEDCOM-Files-custom-tags-in-Legacy.html
1442     *
1443     * @return array<string,ElementInterface>
1444     */
1445    private function legacyTags(): array
1446    {
1447        return [
1448            'FAM:*:ADDR:_PRIV'             => new CustomElement(I18N::translate('Private')),
1449            'FAM:*:PLAC:_VERI'             => new CustomElement(I18N::translate('Verified')),
1450            'FAM:*:SOUR:DATE'              => new DateValue(I18N::translate('Date')),
1451            'FAM:*:SOUR:_VERI'             => new CustomElement(I18N::translate('Verified')),
1452            'FAM:*:_PRIV'                  => new CustomElement(I18N::translate('Private')),
1453            'FAM:CHIL:_FREL'               => new CustomElement(I18N::translate('Relationship to father')),
1454            'FAM:CHIL:_MREL'               => new CustomElement(I18N::translate('Relationship to mother')),
1455            'FAM:CHIL:_STAT'               => new CustomElement(I18N::translate('Status')),
1456            'FAM:EVEN:_OVER'               => new CustomElement('Event sentence override'),
1457            'FAM:MARR:_HTITL'              => new CustomElement(I18N::translate('Label for husband')),
1458            'FAM:MARR:_STAT'               => new CustomElement(I18N::translate('Status')),
1459            'FAM:MARR:_WTITL'              => new CustomElement(I18N::translate('Label for wife')),
1460            'FAM:_NONE'                    => new CustomElement(I18N::translate('No children')),
1461            'FAM:_TAG'                     => new CustomElement('Tag'),
1462            'FAM:_TAG2'                    => new CustomElement('Tag #2'),
1463            'FAM:_TAG3'                    => new CustomElement('Tag #3'),
1464            'FAM:_TAG4'                    => new CustomElement('Tag #4'),
1465            'FAM:_TAG5'                    => new CustomElement('Tag #5'),
1466            'FAM:_TAG6'                    => new CustomElement('Tag #6'),
1467            'FAM:_TAG7'                    => new CustomElement('Tag #7'),
1468            'FAM:_TAG8'                    => new CustomElement('Tag #8'),
1469            'FAM:_TAG9'                    => new CustomElement('Tag #9'),
1470            'FAM:_UID'                     => new PafUid(I18N::translate('Unique identifier')),
1471            'HEAD:_EVENT_DEFN'             => new CustomElement('Event definition'),
1472            'HEAD:_EVENT_DEFN:_CONF_FLAG'  => new CustomElement(I18N::translate('Private')),
1473            'HEAD:_EVENT_DEFN:_DATE_TYPE'  => new CustomElement(I18N::translate('Date')),
1474            'HEAD:_EVENT_DEFN:_DESC_FLAG'  => new CustomElement(I18N::translate('Description')),
1475            'HEAD:_EVENT_DEFN:_PLACE_TYPE' => new CustomElement(I18N::translate('Place')),
1476            'HEAD:_EVENT_DEFN:_PP_EXCLUDE' => new CustomElement('Exclude event from potential problems report'),
1477            'HEAD:_EVENT_DEFN:_SEN1'       => new CustomElement('Event sentence definition'),
1478            'HEAD:_EVENT_DEFN:_SEN2'       => new CustomElement('Event sentence definition'),
1479            'HEAD:_EVENT_DEFN:_SEN3'       => new CustomElement('Event sentence definition'),
1480            'HEAD:_EVENT_DEFN:_SEN4'       => new CustomElement('Event sentence definition'),
1481            'HEAD:_EVENT_DEFN:_SEN5'       => new CustomElement('Event sentence definition'),
1482            'HEAD:_EVENT_DEFN:_SEN6'       => new CustomElement('Event sentence definition'),
1483            'HEAD:_EVENT_DEFN:_SEN7'       => new CustomElement('Event sentence definition'),
1484            'HEAD:_EVENT_DEFN:_SEN8'       => new CustomElement('Event sentence definition'),
1485            'HEAD:_EVENT_DEFN:_SENDOF'     => new CustomElement('Event sentence, female, date only'),
1486            'HEAD:_EVENT_DEFN:_SENDOM'     => new CustomElement('Event sentence, male, date only'),
1487            'HEAD:_EVENT_DEFN:_SENDOU'     => new CustomElement('Event sentence, unknown sex, date only'),
1488            'HEAD:_EVENT_DEFN:_SENDPF'     => new CustomElement('Event sentence, female, date and place'),
1489            'HEAD:_EVENT_DEFN:_SENDPM'     => new CustomElement('Event sentence, male, date and place'),
1490            'HEAD:_EVENT_DEFN:_SENDPU'     => new CustomElement('Event sentence, unknown sex, date and place'),
1491            'HEAD:_EVENT_DEFN:_SENF'       => new CustomElement('Event sentence, female'),
1492            'HEAD:_EVENT_DEFN:_SENM'       => new CustomElement('Event sentence, male'),
1493            'HEAD:_EVENT_DEFN:_SENPOF'     => new CustomElement('Event sentence, unknown sex'),
1494            'HEAD:_EVENT_DEFN:_SENPOM'     => new CustomElement('Event sentence, female, place only'),
1495            'HEAD:_EVENT_DEFN:_SENPOU'     => new CustomElement('Event sentence, male, place only'),
1496            'HEAD:_EVENT_DEFN:_SENU'       => new CustomElement('Event sentence, unknown sex, place only'),
1497            'HEAD:_PLAC_DEFN'              => new CustomElement('Place definition'),
1498            'HEAD:_PLAC_DEFN:_PREP'        => new CustomElement('Place preposition'),
1499            'INDI:*:ADDR:_EMAIL'           => new CustomElement(I18N::translate('Email')),
1500            'INDI:*:ADDR:_LIST1'           => new CustomElement('Include in the “newsletter” group'),
1501            'INDI:*:ADDR:_LIST2'           => new CustomElement('Include in the “family association” group'),
1502            'INDI:*:ADDR:_LIST3'           => new CustomElement('Include in the “birthday” group'),
1503            'INDI:*:ADDR:_LIST4'           => new CustomElement('Include in the “research” group'),
1504            'INDI:*:ADDR:_LIST5'           => new CustomElement('Include in the “christmas” group'),
1505            'INDI:*:ADDR:_LIST6'           => new CustomElement('Include in the “holiday” group'),
1506            'INDI:*:ADDR:_NAME'            => new CustomElement(I18N::translate('Name of addressee')),
1507            'INDI:*:ADDR:_PRIV'            => new CustomElement(I18N::translate('Private')),
1508            'INDI:*:ADDR:_SORT'            => new CustomElement('The spelling of a name to be used when sorting addresses for a report'),
1509            'INDI:*:ADDR:_TAG'             => new CustomElement('Tag'),
1510            'INDI:*:PLAC:_TAG'             => new CustomElement('Tag'),
1511            'INDI:*:PLAC:_VERI'            => new CustomElement(I18N::translate('Verified')),
1512            'INDI:*:SOUR:DATE'             => new DateValue(I18N::translate('Date')),
1513            'INDI:*:SOUR:_VERI'            => new CustomElement(I18N::translate('Verified')),
1514            'INDI:*:_PRIV'                 => new CustomElement(I18N::translate('Private')),
1515            'INDI:EVEN:_OVER'              => new CustomElement('Event sentence override'),
1516            'INDI:SOUR:_VERI'              => new CustomElement(I18N::translate('Verified')),
1517            'INDI:_TAG'                    => new CustomElement('Tag'),
1518            'INDI:_TAG2'                   => new CustomElement('Tag #2'),
1519            'INDI:_TAG3'                   => new CustomElement('Tag #3'),
1520            'INDI:_TAG4'                   => new CustomElement('Tag #4'),
1521            'INDI:_TAG5'                   => new CustomElement('Tag #5'),
1522            'INDI:_TAG6'                   => new CustomElement('Tag #6'),
1523            'INDI:_TAG7'                   => new CustomElement('Tag #7'),
1524            'INDI:_TAG8'                   => new CustomElement('Tag #8'),
1525            'INDI:_TAG9'                   => new CustomElement('Tag #9'),
1526            'INDI:_TODO'                   => new CustomElement(I18N::translate('Research task')),
1527            'INDI:_TODO:PRTY'              => new CustomElement(I18N::translate('Priority')),
1528            'INDI:_TODO:_CAT'              => new CustomElement(I18N::translate('Category')),
1529            'INDI:_TODO:_CDATE'            => new CustomElement(I18N::translate('Completion date')),
1530            'INDI:_TODO:_LOCL'             => new CustomElement(I18N::translate('Location')),
1531            'INDI:_TODO:_RDATE'            => new CustomElement(I18N::translate('Reminder date')),
1532            'INDI:_UID'                    => new PafUid(I18N::translate('Unique identifier')),
1533            'INDI:_URL'                    => new AddressWebPage(I18N::translate('URL')),
1534            'OBJE:_DATE'                   => new CustomElement(I18N::translate('Date')),
1535            'OBJE:_PRIM'                   => new CustomElement(I18N::translate('Highlighted image')),
1536            'OBJE:_SCBK'                   => new CustomElement(I18N::translate('Scrapbook')),
1537            'OBJE:_SOUND'                  => new CustomElement(I18N::translate('Audio')),
1538            'OBJE:_TYPE'                   => new CustomElement(I18N::translate('Type')),
1539            'OBJE:_UID'                    => new PafUid(I18N::translate('Unique identifier')),
1540            'REPO:_UID'                    => new PafUid(I18N::translate('Unique identifier')),
1541            'SOUR:_ITALIC'                 => new CustomElement('The source title should be printed in italic on reports'),
1542            'SOUR:_PAREN'                  => new CustomElement('The source title should be printed within parentheses on reports'),
1543            'SOUR:_QUOTED'                 => new CustomElement('The source title should be printed within quotes on reports'),
1544            'SOUR:_TAG'                    => new CustomElement('Exclude the source citation detail on reports'),
1545            'SOUR:_TAG2'                   => new CustomElement('Exclude the source citation on reports'),
1546            'SOUR:_TAG3'                   => new CustomElement('Include the source citation detail text on reports'),
1547            'SOUR:_TAG4'                   => new CustomElement('Include the source citation detail notes on reports'),
1548            'SOUR:_UID'                    => new PafUid(I18N::translate('Unique identifier')),
1549        ];
1550    }
1551
1552    /**
1553     * @return array<string,ElementInterface>
1554     */
1555    private function myHeritageTags(): array
1556    {
1557        return [
1558            'FAM:*:_UID'                  => new PafUid(I18N::translate('Unique identifier')),
1559            'FAM:*:RIN'                   => new AutomatedRecordId(I18N::translate('Record ID number')),
1560            'HEAD:DATE:_TIMEZONE'         => new CustomElement(I18N::translate('Time zone')),
1561            'HEAD:SOUR:_RTLSAVE'          => new CustomElement(I18N::translate('Text direction')), // ?
1562            'HEAD:_RINS'                  => new CustomElement(I18N::translate('Record ID number')), // ?
1563            'HEAD:_UID'                   => new PafUid(I18N::translate('Unique identifier')),
1564            'HEAD:_PROJECT_GUID'          => new PafUid(I18N::translate('Unique identifier')),
1565            'HEAD:_EXPORTED_FROM_SITE_ID' => new CustomElement(I18N::translate('Site identification code')),
1566            'HEAD:_DESCRIPTION_AWARE'     => new CustomElement(I18N::translate('Description')), // ?
1567            'INDI:*:_UID'                 => new PafUid(I18N::translate('Unique identifier')),
1568            'INDI:*:RIN'                  => new AutomatedRecordId(I18N::translate('Record ID number')),
1569            '*:_UPD'                      => new CustomElement(I18N::translate('Updated at')),
1570        ];
1571    }
1572
1573    /**
1574     * @return array<string,ElementInterface>
1575     */
1576    private function personalAncestralFileTags(): array
1577    {
1578        return [
1579            'FAM:_UID'        => new PafUid(I18N::translate('Unique identifier')),
1580            'INDI:NAME:_ADPN' => new NamePersonal(I18N::translate('Adopted name'), []),
1581            'INDI:NAME:_AKA'  => new NamePersonal(I18N::translate('Also known as'), []),
1582            'INDI:NAME:_AKAN' => new NamePersonal(I18N::translate('Also known as'), []),
1583            'INDI:ADDR'       => new AddressLine(I18N::translate('Address')),
1584            'INDI:ADDR:ADR1'  => new AddressLine1(I18N::translate('Address line 1')),
1585            'INDI:ADDR:ADR2'  => new AddressLine2(I18N::translate('Address line 2')),
1586            'INDI:ADDR:CITY'  => new AddressCity(I18N::translate('City')),
1587            'INDI:ADDR:CTRY'  => new AddressCountry(I18N::translate('Country')),
1588            'INDI:ADDR:POST'  => new AddressPostalCode(I18N::translate('Postal code')),
1589            'INDI:ADDR:STAE'  => new AddressState(I18N::translate('State')),
1590            'INDI:ADDR:_NAME' => new CustomElement(I18N::translate('Name of addressee')),
1591            'INDI:EMAIL'      => new AddressEmail(I18N::translate('Email address')),
1592            'INDI:FAX'        => new AddressFax(I18N::translate('Fax')),
1593            'INDI:PHON'       => new PhoneNumber(I18N::translate('Phone')),
1594            'INDI:URL'        => new CustomElement(I18N::translate('URL')),
1595            'INDI:_UID'       => new PafUid(I18N::translate('Unique identifier')),
1596            'OBJE:_UID'       => new PafUid(I18N::translate('Unique identifier')),
1597            'REPO:_UID'       => new PafUid(I18N::translate('Unique identifier')),
1598            'SOUR:_UID'       => new PafUid(I18N::translate('Unique identifier')),
1599        ];
1600    }
1601
1602    /**
1603     * @return array<string,ElementInterface>
1604     */
1605    private function phpGedViewTags(): array
1606    {
1607        return [
1608            'FAM:CHAN:_PGVU'        => new WebtreesUser(I18N::translate('Author of last change')),
1609            'FAM:COMM'              => new CustomElement(I18N::translate('Comment')),
1610            'FAM:FACT'              => new CustomFact(I18N::translate('Fact')),
1611            'INDI:*:ASSO'           => new XrefAssociate(I18N::translate('Associate')),
1612            'INDI:*:ASSO:RELA'      => new RelationIsDescriptor(I18N::translate('Relationship')),
1613            'INDI:*:PLAC:_HEB'      => new NoteStructure(I18N::translate('Place in Hebrew')),
1614            'INDI:ADDR'             => new AddressLine(I18N::translate('Address')),
1615            'INDI:BIRT:DATE:TIME'   => new TimeValue(I18N::translate('Time of birth')),
1616            'INDI:BURI:CEME'        => new CustomElement(I18N::translate('Cemetery')),
1617            'INDI:CHAN:_PGVU'       => new WebtreesUser(I18N::translate('Author of last change')),
1618            'INDI:COMM'             => new CustomElement(I18N::translate('Comment')),
1619            'INDI:DEAT:DATE:TIME'   => new TimeValue(I18N::translate('Time of death')),
1620            'INDI:EMAIL'            => new AddressEmail(I18N::translate('Email address')),
1621            'INDI:NAME:_HEB'        => new NamePersonal(I18N::translate('Name in Hebrew'), []),
1622            'INDI:_FNRL'            => new CustomIndividualEvent(I18N::translate('Funeral')),
1623            'INDI:_HOL'             => new CustomIndividualEvent(I18N::translate('Holocaust')),
1624            'INDI:_MILI'            => new CustomIndividualEvent(I18N::translate('Military')),
1625            'INDI:_PGV_OBJS'        => new XrefMedia(I18N::translate('Re-order media')),
1626            'NOTE:CHAN:_PGVU'       => new WebtreesUser(I18N::translate('Author of last change')),
1627            'OBJE:CHAN:_PGVU'       => new WebtreesUser(I18N::translate('Author of last change')),
1628            'OBJE:_PRIM'            => new CustomElement(I18N::translate('Highlighted image')),
1629            'OBJE:_THUM'            => new CustomElement(I18N::translate('Thumbnail image')),
1630            'REPO:CHAN:_PGVU'       => new WebtreesUser(I18N::translate('Author of last change')),
1631            'SOUR:CHAN:_PGVU'       => new WebtreesUser(I18N::translate('Author of last change')),
1632            'SOUR:SERV'             => new CustomElement(I18N::translate('Remote server')),
1633            'SOUR:URL'              => new AddressWebPage(I18N::translate('URL')),
1634            'SOUR:URL:TYPE'         => new CustomElement(I18N::translate('Type')), // e.g. "FamilySearch"
1635            'SOUR:URL:_BLOCK'       => new CustomElement(I18N::translate('Block')), // "e.g. "false"
1636            'SOUR:_DBID'            => new CustomElement(I18N::translate('Database name')),
1637            'SOUR:_DBID:_PASS'      => new CustomElement(I18N::translate('Database password')),
1638            'SOUR:_DBID:_PASS:RESN' => new RestrictionNotice(I18N::translate('Restriction')),
1639            'SOUR:_DBID:_USER'      => new CustomElement(I18N::translate('Database user account')),
1640        ];
1641    }
1642
1643    /**
1644     * @return array<string,ElementInterface>
1645     */
1646    private function reunionTags(): array
1647    {
1648        return [
1649            'FAM:_UID'   => new PafUid(I18N::translate('Unique identifier')),
1650            'INDI:CITN'  => new CustomElement(I18N::translate('Citizenship')),
1651            'INDI:EMAL'  => new AddressEmail(I18N::translate('Email address')),
1652            'INDI:_LEGA' => new CustomElement(I18N::translate('Legatee')),
1653            'INDI:_MDCL' => new CustomElement(I18N::translate('Medical')),
1654            'INDI:_PURC' => /* I18N: GEDCOM tag _PURC */ new CustomElement(I18N::translate('Land purchase')),
1655            'INDI:_SALE' => /* I18N: GEDCOM tag _SALE */ new CustomElement(I18N::translate('Land sale')),
1656            'INDI:_UID'  => new PafUid(I18N::translate('Unique identifier')),
1657            'OBJE:_UID'  => new PafUid(I18N::translate('Unique identifier')),
1658            'REPO:_UID'  => new PafUid(I18N::translate('Unique identifier')),
1659            'SOUR:_UID'  => new PafUid(I18N::translate('Unique identifier')),
1660        ];
1661    }
1662
1663    /**
1664     * @return array<string,ElementInterface>
1665     */
1666    private function rootsMagicTags(): array
1667    {
1668        return [
1669            'FAM:_UID'          => new PafUid(I18N::translate('Unique identifier')),
1670            'INDI:_DNA'         => new CustomElement(I18N::translate('DNA markers')),
1671            'INDI:_UID'         => new PafUid(I18N::translate('Unique identifier')),
1672            'INDI:_WEBTAG'      => new CustomElement(I18N::translate('External link')),
1673            'INDI:_WEBTAG:NAME' => new CustomElement(I18N::translate('Text')),
1674            'INDI:_WEBTAG:URL'  => new AddressWebPage(I18N::translate('URL')),
1675            'OBJE:_UID'         => new PafUid(I18N::translate('Unique identifier')),
1676            'REPO:_UID'         => new PafUid(I18N::translate('Unique identifier')),
1677            'SOUR:_BIBL'        => new CustomElement(I18N::translate('Bibliography')),
1678            'SOUR:_SUBQ'        => new CustomElement(I18N::translate('Abbreviation')),
1679            'SOUR:_UID'         => new PafUid(I18N::translate('Unique identifier')),
1680        ];
1681    }
1682
1683    /**
1684     * @return array<string,ElementInterface>
1685     */
1686    private function theMasterGenealogistTags(): array
1687    {
1688        return [
1689            'INDI:*:_SDATE' => new DateValue(I18N::translate('Sort date')),
1690            'INDI:NAME:_DATE'  => new DateValue(I18N::translate('Date')),
1691        ];
1692    }
1693
1694    /**
1695     * Custom tags for webtrees.
1696     *
1697     * @return array<string,ElementInterface>
1698     */
1699    private function webtreesTags(): array
1700    {
1701        return [
1702            'FAM:CHAN:_WT_USER'           => new WebtreesUser(I18N::translate('Author of last change')),
1703            'FAM:*:_ASSO'                 => new XrefAssociate(I18N::translate('Associate')),
1704            'FAM:*:_ASSO:NOTE'            => new NoteStructure(I18N::translate('Note')),
1705            'FAM:*:_ASSO:RELA'            => new RelationIsDescriptor(I18N::translate('Relationship')),
1706            'FAM:*:_ASSO:SOUR'            => new XrefSource(I18N::translate('Source citation')),
1707            'FAM:*:_ASSO:SOUR:DATA'       => new SourceData(I18N::translate('Data')),
1708            'FAM:*:_ASSO:SOUR:DATA:DATE'  => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
1709            'FAM:*:_ASSO:SOUR:DATA:TEXT'  => new TextFromSource(I18N::translate('Text')),
1710            'FAM:*:_ASSO:SOUR:EVEN'       => new EventTypeCitedFrom(I18N::translate('Event')),
1711            'FAM:*:_ASSO:SOUR:EVEN:ROLE'  => new RoleInEvent(I18N::translate('Role')),
1712            'FAM:*:_ASSO:SOUR:NOTE'       => new NoteStructure(I18N::translate('Note')),
1713            'FAM:*:_ASSO:SOUR:OBJE'       => new XrefMedia(I18N::translate('Media object')),
1714            'FAM:*:_ASSO:SOUR:PAGE'       => new WhereWithinSource(I18N::translate('Citation details')),
1715            'FAM:*:_ASSO:SOUR:QUAY'       => new CertaintyAssessment(I18N::translate('Quality of data')),
1716            'INDI:CHAN:_WT_USER'          => new WebtreesUser(I18N::translate('Author of last change')),
1717            'INDI:*:_ASSO'                => new XrefAssociate(I18N::translate('Associate')),
1718            'INDI:*:_ASSO:NOTE'           => new NoteStructure(I18N::translate('Note')),
1719            'INDI:*:_ASSO:RELA'           => new RelationIsDescriptor(I18N::translate('Relationship')),
1720            'INDI:*:_ASSO:SOUR'           => new XrefSource(I18N::translate('Source citation')),
1721            'INDI:*:_ASSO:SOUR:DATA'      => new SourceData(I18N::translate('Data')),
1722            'INDI:*:_ASSO:SOUR:DATA:DATE' => new EntryRecordingDate(I18N::translate('Date of entry in original source')),
1723            'INDI:*:_ASSO:SOUR:DATA:TEXT' => new TextFromSource(I18N::translate('Text')),
1724            'INDI:*:_ASSO:SOUR:EVEN'      => new EventTypeCitedFrom(I18N::translate('Event')),
1725            'INDI:*:_ASSO:SOUR:EVEN:ROLE' => new RoleInEvent(I18N::translate('Role')),
1726            'INDI:*:_ASSO:SOUR:NOTE'      => new NoteStructure(I18N::translate('Note')),
1727            'INDI:*:_ASSO:SOUR:OBJE'      => new XrefMedia(I18N::translate('Media object')),
1728            'INDI:*:_ASSO:SOUR:PAGE'      => new WhereWithinSource(I18N::translate('Citation details')),
1729            'INDI:*:_ASSO:SOUR:QUAY'      => new CertaintyAssessment(I18N::translate('Quality of data')),
1730            'NOTE:CHAN:_WT_USER'          => new WebtreesUser(I18N::translate('Author of last change')),
1731            'NOTE:RESN'                   => new RestrictionNotice(I18N::translate('Restriction')),
1732            'OBJE:CHAN:_WT_USER'          => new WebtreesUser(I18N::translate('Author of last change')),
1733            'OBJE:RESN'                   => new RestrictionNotice(I18N::translate('Restriction')),
1734            'REPO:CHAN:_WT_USER'          => new WebtreesUser(I18N::translate('Author of last change')),
1735            'REPO:RESN'                   => new RestrictionNotice(I18N::translate('Restriction')),
1736            'SOUR:CHAN:_WT_USER'          => new WebtreesUser(I18N::translate('Author of last change')),
1737            'SOUR:RESN'                   => new RestrictionNotice(I18N::translate('Restriction')),
1738            'SUBM:CHAN:_WT_USER'          => new WebtreesUser(I18N::translate('Author of last change')),
1739            'SUBM:RESN'                   => new RestrictionNotice(I18N::translate('Restriction')),
1740            '_LOC:CHAN:_WT_USER'          => new WebtreesUser(I18N::translate('Author of last change')),
1741            '_LOC:RESN'                   => new RestrictionNotice(I18N::translate('Restriction')),
1742        ];
1743    }
1744
1745    /**
1746     * @return array<string,array<int,array<int,string>>>
1747     */
1748    private function webtreesSubTags(): array
1749    {
1750        return [
1751            'FAM'              => [['_UID', '0:M']],
1752            'FAM:*:SOUR'       => [['NOTE', '0:0']],
1753            'FAM:*:SOUR:DATA'  => [['TEXT', '0:1']],
1754            'FAM:ANUL'         => [['_ASSO', '0:M', 'NOTE']],
1755            'FAM:CENS'         => [['_ASSO', '0:M', 'NOTE']],
1756            'FAM:CHAN'         => [['_WT_USER', '0:1']],
1757            'FAM:DIV'          => [['_ASSO', '0:M', 'NOTE']],
1758            'FAM:DIVF'         => [['_ASSO', '0:M', 'NOTE']],
1759            'FAM:ENGA'         => [['_ASSO', '0:M', 'NOTE']],
1760            'FAM:EVEN'         => [['_ASSO', '0:M', 'NOTE']],
1761            'FAM:MARB'         => [['_ASSO', '0:M', 'NOTE']],
1762            'FAM:MARC'         => [['_ASSO', '0:M', 'NOTE']],
1763            'FAM:MARL'         => [['_ASSO', '0:M', 'NOTE']],
1764            'FAM:MARR'         => [['_ASSO', '2:M', 'NOTE']],
1765            'FAM:MARS'         => [['_ASSO', '0:M', 'NOTE']],
1766            'FAM:SLGS'         => [['_ASSO', '0:M', 'NOTE']],
1767            'FAM:SOUR:DATA'    => [['TEXT', '0:1']],
1768            'INDI'             => [['_UID', '0:M']],
1769            'INDI:*:SOUR:DATA' => [['TEXT', '0:1']],
1770            'INDI:ADOP'        => [['_ASSO', '0:M', 'NOTE']],
1771            'INDI:BAPL'        => [['_ASSO', '0:M', 'NOTE']],
1772            'INDI:BAPM'        => [['_ASSO', '2:M', 'NOTE']],
1773            'INDI:BARM'        => [['_ASSO', '0:M', 'NOTE']],
1774            'INDI:BASM'        => [['_ASSO', '0:M', 'NOTE']],
1775            'INDI:BIRT'        => [['_ASSO', '0:M', 'NOTE'], ['FAMC', '0:0']],
1776            'INDI:BURI'        => [['_ASSO', '0:M', 'NOTE']],
1777            'INDI:CENS'        => [['_ASSO', '0:M', 'NOTE']],
1778            'INDI:CHAN'        => [['_WT_USER', '0:1']],
1779            'INDI:CHR'         => [['_ASSO', '2:M', 'NOTE']],
1780            'INDI:CHRA'        => [['_ASSO', '0:M', 'NOTE']],
1781            'INDI:CONF'        => [['_ASSO', '0:M', 'NOTE']],
1782            'INDI:CONL'        => [['_ASSO', '0:M', 'NOTE']],
1783            'INDI:CREM'        => [['_ASSO', '0:M', 'NOTE']],
1784            'INDI:DEAT'        => [['_ASSO', '0:M', 'NOTE']],
1785            'INDI:EDUC'        => [['_ASSO', '0:M', 'NOTE']],
1786            'INDI:EMIG'        => [['_ASSO', '0:M', 'NOTE']],
1787            'INDI:ENDL'        => [['_ASSO', '0:M', 'NOTE']],
1788            'INDI:EVEN'        => [['_ASSO', '0:M', 'NOTE']],
1789            'INDI:GRAD'        => [['_ASSO', '0:M', 'NOTE']],
1790            'INDI:IMMI'        => [['_ASSO', '0:M', 'NOTE']],
1791            'INDI:NAME:FONE'   => [['NPFX', '0:0'], ['GIVN', '0:0'], ['SPFX', '0:0'], ['SURN', '0:0'], ['NSFX', '0:0'], ['NICK', '0:0']],
1792            'INDI:NAME:ROMN'   => [['NPFX', '0:0'], ['GIVN', '0:0'], ['SPFX', '0:0'], ['SURN', '0:0'], ['NSFX', '0:0'], ['NICK', '0:0']],
1793            'INDI:NATU'        => [['_ASSO', '0:M', 'NOTE']],
1794            'INDI:OCCU'        => [['_ASSO', '0:M', 'NOTE']],
1795            'INDI:ORDN'        => [['_ASSO', '0:M', 'NOTE']],
1796            'INDI:PROB'        => [['_ASSO', '0:M', 'NOTE']],
1797            'INDI:PROP'        => [['_ASSO', '0:M', 'NOTE']],
1798            'INDI:RESI'        => [['_ASSO', '0:M', 'NOTE']],
1799            'INDI:RETI'        => [['_ASSO', '0:M', 'NOTE']],
1800            'INDI:SLGC'        => [['_ASSO', '0:M', 'NOTE']],
1801            'INDI:SOUR:DATA'   => [['TEXT', '0:1']],
1802            'INDI:TITL'        => [['_ASSO', '0:M', 'NOTE']],
1803            'INDI:WILL'        => [['_ASSO', '0:M', 'NOTE']],
1804            'NOTE'             => [['RESN', '0:1', 'CHAN']],
1805            'NOTE:CHAN'        => [['_WT_USER', '0:1']],
1806            'NOTE:SOUR'        => [['NOTE', '0:0']],
1807            'NOTE:SOUR:DATA'   => [['TEXT', '0:1']],
1808            'OBJE'             => [['RESN', '0:1', 'CHAN'], ['_UID', '0:M']],
1809            'OBJE:CHAN'        => [['_WT_USER', '0:1']],
1810            'OBJE:SOUR'        => [['NOTE', '0:0']],
1811            'OBJE:SOUR:DATA'   => [['TEXT', '0:1']],
1812            'REPO'             => [['RESN', '0:1', 'CHAN'], ['_UID', '0:M']],
1813            'REPO:CHAN'        => [['_WT_USER', '0:1']],
1814            'SOUR'             => [['RESN', '0:1', 'CHAN'], ['_UID', '0:M']],
1815            'SOUR:CHAN'        => [['_WT_USER', '0:1']],
1816            'SUBM'             => [['RESN', '0:1', 'CHAN']],
1817            'SUBM:CHAN'        => [['_WT_USER', '0:1']],
1818        ];
1819    }
1820
1821    /**
1822     * @return array<string,array<int,array<int,string>>>
1823     */
1824    private function customSubTags(): array
1825    {
1826        $custom_family_tags     = array_filter(explode(',', Site::getPreference('CUSTOM_FAMILY_TAGS')));
1827        $custom_individual_tags = array_filter(explode(',', Site::getPreference('CUSTOM_INDIVIDUAL_TAGS')));
1828
1829        $subtags = [
1830            'FAM'  => array_map(static fn (string $tag): array => [$tag, '0:M'], $custom_family_tags),
1831            'INDI' => array_map(static fn (string $tag): array => [$tag, '0:M'], $custom_individual_tags),
1832        ];
1833
1834        if (Site::getPreference('CUSTOM_TIME_TAGS') === '1') {
1835            $subtags['INDI:BIRT:DATE'][] = ['TIME', '0:1'];
1836            $subtags['INDI:DEAT:DATE'][] = ['TIME', '0:1'];
1837        }
1838
1839        if (Site::getPreference('CUSTOM_GEDCOM_L_TAGS') === '1') {
1840            $subtags['FAM'][]               = ['_ASSO', '0:M'];
1841            $subtags['FAM'][]               = ['_STAT', '0:1'];
1842            $subtags['FAM'][]               = ['_UID', '0:M'];
1843            $subtags['FAM:*:ADDR']          = [['_NAME', '0:1:?', 'ADR1']];
1844            $subtags['FAM:*:PLAC']          = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1845            $subtags['FAM:ENGA:PLAC']       = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1846            $subtags['FAM:MARB:PLAC']       = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1847            $subtags['FAM:MARR']            = [['_WITN', '0:1']];
1848            $subtags['FAM:MARR:PLAC']       = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1849            $subtags['FAM:SLGS:PLAC']       = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1850            $subtags['INDI'][]              = ['_UID', '0:M'];
1851            $subtags['INDI:*:ADDR']         = [['_NAME', '0:1:?', 'ADR1']];
1852            $subtags['INDI:*:PLAC']         = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1853            $subtags['INDI:ADOP:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1854            $subtags['INDI:BAPL:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1855            $subtags['INDI:BAPM']           = [['_GODP', '0:1'], ['_WITN', '0:1']];
1856            $subtags['INDI:BAPM:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1857            $subtags['INDI:BARM:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1858            $subtags['INDI:BASM:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1859            $subtags['INDI:BIRT:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1860            $subtags['INDI:BLES:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1861            $subtags['INDI:BURI:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1862            $subtags['INDI:CENS:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1863            $subtags['INDI:CHR']            = [['_GODP', '0:1'], ['_WITN', '0:1']];
1864            $subtags['INDI:CHR:PLAC']       = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1865            $subtags['INDI:CHRA:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1866            $subtags['INDI:CONF:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1867            $subtags['INDI:CONL:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1868            $subtags['INDI:CREM:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1869            $subtags['INDI:DEAT:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1870            $subtags['INDI:EMIG:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1871            $subtags['INDI:ENDL:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1872            $subtags['INDI:EVEN:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1873            $subtags['INDI:FCOM:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1874            $subtags['INDI:IMMI:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1875            $subtags['INDI:NAME']           = [['_RUFN', '0:1']];
1876            $subtags['INDI:NATU:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1877            $subtags['INDI:ORDN:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1878            $subtags['INDI:RESI:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1879            $subtags['INDI:SLGC:PLAC']      = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1880            $subtags['NOTE']                = [['_UID', '0:M']];
1881            $subtags['OBJE']                = [['_PRIM', '0:1:?'], ['_UID', '0:M']];
1882            $subtags['REPO']                = [['_UID', '0:M']];
1883            $subtags['REPO:ADDR']           = [['_NAME', '0:1', 'ADR1']];
1884            $subtags['SOUR']                = [['_UID', '0:M']];
1885            $subtags['SOUR:DATA:EVEN:PLAC'] = [['_POST', '0:1'], ['_MAIDENHEAD', '0:1:?'], ['_LOC', '0:1']];
1886            $subtags['SUBM']                = [['_UID', '0:M']];
1887            $subtags['SUBM:ADDR']           = [['_NAME', '0:1', 'ADR1']];
1888        }
1889
1890        return $subtags;
1891    }
1892
1893    /**
1894     * @param ElementFactoryInterface $element_factory
1895     * @param bool                    $include_custom_tags
1896     *
1897     * @return void
1898     */
1899    public function registerTags(ElementFactoryInterface $element_factory, bool $include_custom_tags): void
1900    {
1901        // Standard GEDCOM.
1902        $element_factory->registerTags($this->gedcom551Tags());
1903
1904        // webtrees extensions.
1905        $element_factory->registerTags($this->webtreesTags());
1906
1907        if ($include_custom_tags) {
1908            // webtrees extensions.
1909            $element_factory->registerSubTags($this->webtreesSubTags());
1910
1911            // Third-party extensions.
1912            $element_factory->registerTags($this->aldfaerTags());
1913            $element_factory->registerTags($this->ancestryTags());
1914            $element_factory->registerTags($this->brothersKeeperTags());
1915            $element_factory->registerTags($this->familySearchTags());
1916            $element_factory->registerTags($this->familyTreeBuilderTags());
1917            $element_factory->registerTags($this->familyTreeMakerTags());
1918            $element_factory->registerTags($this->gedcomLTags());
1919            $element_factory->registerTags($this->geneatique());
1920            $element_factory->registerTags($this->genPlusWinTags());
1921            $element_factory->registerTags($this->heredis());
1922            $element_factory->registerTags($this->legacyTags());
1923            $element_factory->registerTags($this->myHeritageTags());
1924            $element_factory->registerTags($this->personalAncestralFileTags());
1925            $element_factory->registerTags($this->phpGedViewTags());
1926            $element_factory->registerTags($this->reunionTags());
1927            $element_factory->registerTags($this->rootsMagicTags());
1928            $element_factory->registerTags($this->theMasterGenealogistTags());
1929
1930            // Creating tags from all the above are grouped into one place
1931            $element_factory->registerSubTags($this->customSubTags());
1932        }
1933    }
1934}
1935