@treeviz/gedcom-parser 2.1.12 → 2.1.16

package/dist/kinship-translator/index.js

@@ -9,11 +9,12 @@ var __export = (target, all) => {
 
 // src/kinship-translator/kinship-translator.basic.ts
 var KinshipTranslatorBasic = class {
-  constructor(path, displayName = "givenname") {
+  constructor(path, displayName = "givenname", nameOrder = "first-last") {
     this.isOfSpouse = false;
     this.isSpouseOf = false;
     this._path = path;
     this.displayName = displayName;
+    this.nameOrder = nameOrder;
   }
   get path() {
     return this._path;
@@ -608,7 +609,7 @@ var KinshipTranslatorHU = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "last-first"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {
@@ -822,7 +823,7 @@ var KinshipTranslatorEn = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "first-last"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {
@@ -1032,7 +1033,7 @@ var KinshipTranslatorFr = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "first-last"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {
@@ -1370,7 +1371,7 @@ var KinshipTranslatorEs = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "first-last"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {
@@ -1677,7 +1678,7 @@ var KinshipTranslatorRu = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "first-last"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {
@@ -1913,7 +1914,7 @@ var KinshipTranslatorJa = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "last-first"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {
@@ -2162,7 +2163,7 @@ var KinshipTranslatorZh = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "last-first"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {
@@ -2231,22 +2232,30 @@ var KinshipTranslatorZh = class extends KinshipTranslatorBasic {
 };
 
 // src/kinship-translator/kinship-translator.ts
+var nameOrderForLang = (lang) => lang === "hu" || lang === "ja" || lang === "zh" ? "last-first" : "first-last";
 var KinshipTranslator = class {
-  constructor(person1, person2, lang = "en", entirePath, displayName = "givenname") {
+  constructor(person1, person2, lang = "en", entirePath, displayName = "givenname", nameOrder) {
     this.displayName = displayName;
     this.lang = lang;
     this.entirePath = entirePath;
     this.person1 = person1;
     this.person2 = typeof person2 === "string" ? this.person1.getGedcom()?.indi(person2) : person2;
     this.path = this.person1.path(this.person2);
+    const order = nameOrder ?? nameOrderForLang(lang);
+    this.nameOrder = order;
     if (translators_exports[lang]) {
       this.translator = new translators_exports[lang](
         this.path ?? [],
-        displayName
+        displayName,
+        order
       );
     }
     if (!this.translator) {
-      this.translator = new KinshipTranslatorEn(this.path ?? [], displayName);
+      this.translator = new KinshipTranslatorEn(
+        this.path ?? [],
+        displayName,
+        order
+      );
     }
   }
   get path0() {
@@ -2291,14 +2300,16 @@ var KinshipTranslator = class {
           showMainPerson,
           this.lang,
           false,
-          this.displayName
+          this.displayName,
+          this.nameOrder
         ),
         relative: this.path?.[index - 1]?.indi.kinship(
           path2.indi.id,
           showMainPerson,
           this.lang,
           false,
-          this.displayName
+          this.displayName,
+          this.nameOrder
         )
       }));
       return path;
@@ -2344,244 +2355,6 @@ var getKinshipTranslatorClass = () => {
   return KinshipTranslatorClass;
 };
 
-// src/utils/get-all-prop.ts
-var getAllProp = (indi, prop) => {
-  return prop && (indi?.get(prop)?.toList().values() ?? []).filter(Boolean) || [];
-};
-
-// src/utils/date-formatter.ts
-var ACCEPTED_DATE_FORMATS = [
-  "yyyy.MM.dd.",
-  "yyyy-MM-dd",
-  "MM/dd/yyyy"
-];
-var ACCEPTED_DATE_FORMATS_REGEX = new RegExp(
-  `(${ACCEPTED_DATE_FORMATS.map(
-    (acceptedFormat) => acceptedFormat.replace(/[^.\-/]/g, "\\d")
-  ).join("|")})`,
-  "gi"
-);
-var commonDateFormatter = (date, format2 = "yyyy", prefix = "") => {
-  const formattedDate = date?.toValue(format2);
-  if (!formattedDate) {
-    return void 0;
-  }
-  return `${prefix}${formattedDate}`.trim();
-};
-var noteDateFormatter = (date, format2 = "yyyy", prefix = "", shortNote = true, showNote = true) => {
-  const rawDate = commonDateFormatter(date, format2, "");
-  if (!rawDate) {
-    return void 0;
-  }
-  const note = date?.toNote(shortNote) ?? "";
-  return `${prefix}${note && showNote ? i18n.t(`${note} {{date}}`, { date: rawDate }) : rawDate}`;
-};
-var marriageDateFormatter = (fam, showDays = false, showPlaces = false, shortNote = true, showNote = true, showDisplayTextIfNoDate = true, showAllEvents = false, dateFormatPattern) => {
-  const fullDateFormat = i18n.t("dateFormat");
-  const marriageDates = [];
-  const marriagePlaces = [];
-  const marriages = (fam?.toValueList().values() ?? []).flatMap((fam2) => {
-    const family = fam2;
-    const marrEvents = (family?.MARR?.toList().values() ?? []).filter(
-      Boolean
-    );
-    if (marrEvents.length === 0) {
-      const displayText = family?.get("DISPLAYTEXT")?.toValue() ?? "";
-      if (showDisplayTextIfNoDate && displayText) {
-        const displayDate = displayText.match(
-          ACCEPTED_DATE_FORMATS_REGEX
-        )?.[0];
-        if (displayDate) {
-          marriagePlaces.push(displayText.replace(displayDate, ""));
-          const marriageDate = createCommonDate(
-            fam2?.getGedcom(),
-            void 0,
-            family
-          );
-          marriageDate.value = displayDate;
-          marriageDates.push(marriageDate);
-        } else {
-          marriagePlaces.push(displayText);
-          marriageDates.push(void 0);
-          return ["\u221E"];
-        }
-      }
-      return [];
-    }
-    const eventsToProcess = showAllEvents ? marrEvents : marrEvents.slice(0, 1);
-    return eventsToProcess.map((marrEvent) => {
-      const marriageEventDetail = marrEvent;
-      const marriageDate = marriageEventDetail?.DATE;
-      const marriagePlace = showPlaces ? marriageEventDetail?.PLAC?.value : void 0;
-      marriagePlaces.push(marriagePlace);
-      marriageDates.push(marriageDate);
-      const formattedDate = noteDateFormatter(
-        marriageDate,
-        showDays ? fullDateFormat : "yyyy",
-        "\u221E",
-        shortNote,
-        showNote
-      );
-      return formattedDate ? formattedDate : void 0;
-    });
-  });
-  const marriageArray = marriages.length ? marriages.filter(Boolean) : [];
-  const datesArray = marriageArray.filter(Boolean);
-  const placesArray = marriagePlaces.filter(Boolean);
-  const dates = datesArray.join(" ").trim();
-  return {
-    rawArray: marriageDates,
-    inArray: datesArray,
-    inOrder: dates,
-    places: placesArray,
-    marriage: marriageArray,
-    ...showPlaces ? {
-      marriages,
-      marriagePlaces
-    } : {}
-  };
-};
-var dateFormatter = (indi, showMarriages = false, showDays = false, showPlaces = false, shortNote = true, showNote = true, isOnStage, showAllEvents = false, dateFormatPattern) => {
-  const fullDateFormat = i18n.t("dateFormat");
-  const birthEvents = getAllProp(indi, "BIRT");
-  const firstBirthValue = birthEvents[0];
-  const deathEvents = getAllProp(indi, "DEAT");
-  const firstDeathValue = deathEvents[0];
-  const birth = commonDateFormatter(
-    firstBirthValue?.DATE,
-    showDays ? fullDateFormat : "yyyy"
-  );
-  const birthPlace = showPlaces ? firstBirthValue?.PLAC?.value : void 0;
-  const death = commonDateFormatter(
-    firstDeathValue?.DATE,
-    showDays ? fullDateFormat : "yyyy"
-  );
-  const deathPlace = showPlaces ? firstDeathValue?.PLAC?.value : void 0;
-  const marriagePlaces = [];
-  const marriages = [];
-  if (showMarriages || isOnStage) {
-    (indi?.get("FAMS")?.toValueList().values() ?? []).forEach((fam) => {
-      const famRef = fam?.ref;
-      const marriageDates = marriageDateFormatter(
-        famRef,
-        showDays,
-        showPlaces,
-        shortNote,
-        showNote,
-        true,
-        showAllEvents);
-      marriages.push(...marriageDates?.marriage ?? []);
-      marriagePlaces.push(...marriageDates?.marriagePlaces ?? []);
-    });
-  }
-  const birthStrings = [];
-  const birthPlaces = [];
-  const eventsToProcess = showAllEvents ? birthEvents : birthEvents.slice(0, 1);
-  eventsToProcess.forEach((birthEvent) => {
-    const birthDate = commonDateFormatter(
-      birthEvent?.DATE,
-      showDays ? fullDateFormat : "yyyy"
-    );
-    const birthEventNote = birthEvent?.DATE?.toNote(shortNote) ?? "";
-    const birthEventPlace = showPlaces ? birthEvent?.PLAC?.value : void 0;
-    if (birthDate) {
-      birthStrings.push(
-        `*${birthEventNote && showNote ? i18n.t(`${birthEventNote} {{date}}`, {
-          date: birthDate
-        }) : birthDate}`
-      );
-    }
-    birthPlaces.push(birthEventPlace);
-  });
-  const deathStrings = [];
-  const deathPlaces = [];
-  const deathEventsToProcess = showAllEvents ? deathEvents : deathEvents.slice(0, 1);
-  deathEventsToProcess.forEach((deathEvent) => {
-    const deathDate = commonDateFormatter(
-      deathEvent?.DATE,
-      showDays ? fullDateFormat : "yyyy"
-    );
-    const deathEventNote = deathEvent?.DATE?.toNote(shortNote) ?? "";
-    const deathEventPlace = showPlaces ? deathEvent?.PLAC?.value : void 0;
-    if (deathDate) {
-      deathStrings.push(
-        `\u2020${deathEventNote && showNote ? i18n.t(`${deathEventNote} {{date}}`, {
-          date: deathDate
-        }) : deathDate}`
-      );
-    }
-    deathPlaces.push(deathEventPlace);
-  });
-  const birthString = birthStrings[0] ?? "";
-  const deathString = deathStrings[0] ?? "";
-  const marriageArray = marriages.length ? marriages.filter(Boolean) : [];
-  const datesArray = !birth && !death ? marriageArray : [...birthStrings, ...marriageArray, ...deathStrings];
-  const placesArray = !birth && !death ? marriagePlaces : [...birthPlaces, ...marriagePlaces, ...deathPlaces];
-  const nonNullDatesArray = datesArray.filter(Boolean);
-  const dates = nonNullDatesArray.join(" ").trim();
-  return {
-    inArray: nonNullDatesArray,
-    inOrder: dates,
-    places: placesArray,
-    birth: birthString,
-    marriage: marriageArray,
-    death: deathString,
-    ...showPlaces ? {
-      birthPlace,
-      deathPlace,
-      ...showMarriages ? { marriages, marriagePlaces } : {}
-    } : {},
-    ...showAllEvents ? {
-      births: birthStrings,
-      birthPlaces,
-      deaths: deathStrings,
-      deathPlaces
-    } : {}
-  };
-};
-
-// src/utils/range.ts
-var toTuple = (r) => {
-  if (Array.isArray(r)) {
-    const [s2, e2] = r;
-    return [
-      s2 === void 0 ? void 0 : Number(s2),
-      e2 === void 0 ? void 0 : Number(e2)
-    ];
-  }
-  if (r === "-" || r === "") return [void 0, void 0];
-  const [s, e] = r.split("-");
-  return [s ? Number(s) : void 0, e ? Number(e) : void 0];
-};
-var isValidRange = (range) => {
-  if (!Array.isArray(range) && range !== "" && range !== "-" && !/^\d*-\d*$/.test(range)) {
-    return false;
-  }
-  if (Array.isArray(range) && range.some((r) => typeof r === "string" && isNaN(Number(r)))) {
-    return false;
-  }
-  return true;
-};
-var inRange = (year, range, trueIfNoYear = false) => {
-  if (!isValidRange(range)) {
-    return false;
-  }
-  if (!year) {
-    return trueIfNoYear;
-  }
-  const [start = -Infinity, end = Infinity] = toTuple(range);
-  if (!start && !end) {
-    return true;
-  }
-  if (start && !end) {
-    return Number(year) >= Number(start);
-  }
-  if (!start && end) {
-    return Number(year) <= Number(end);
-  }
-  return Number(start) <= Number(year) && Number(year) <= Number(end);
-};
-
 // src/constants/constants.ts
 var ID_REG = /^@[_a-zA-Z0-9]+@/;
 var ID_GETTER_REG = /^(?<at>@)?(?<letter>[A-Z])?/i;
@@ -2666,1087 +2439,1355 @@ var objeXrefKey = (obje, fallback = 0) => {
   return `@O${fallback}@`;
 };
 var objeNoteValue = (obje) => mediaIdValue(obje, "FILE.NOTE") || mediaIdValue(obje, "NOTE") || "";
-var List = class _List {
-  // length = 0;
-  constructor(items) {
-    this.items = {};
+
+// src/classes/common.ts
+var Common = class _Common {
+  constructor(gedcom, id, main, parent) {
     this.isListable = true;
-    this.marker = void 0;
-    if (items) {
-      this.concat(items);
+    this._gedcom = gedcom;
+    this._main = main;
+    this._parent = parent;
+    this.initUniqueId();
+    if (id) {
+      this._id = id;
+    } else {
+      delete this._id;
     }
   }
-  get length() {
-    return this.values().length;
-  }
-  has(indi) {
-    return !!this.item(
-      typeof indi === "string" ? indi : indi?.id ?? ""
-    );
+  set type(type) {
+    if (type) {
+      this.uniqueId = this.uniqueId?.replace(/^[^:]+/, `~${type}`);
+    }
+    this._type = type;
   }
-  get(name) {
-    const propList = new _List();
-    this.entries().forEach(([key, item]) => {
-      propList.item(key, item.get(name));
-    });
-    return propList;
+  get type() {
+    return this._type;
   }
-  getIf(name, condition, name2) {
-    const propList = new _List();
-    this.entries().forEach(([key, item]) => {
-      const passedItem = item.getIf(name, condition, name2);
-      if (passedItem) {
-        propList.item(key, passedItem);
+  initUniqueId() {
+    if (this._gedcom) {
+      this.uniqueId = `~Common:${this._gedcom.refcount++}`;
+    }
+  }
+  set uniqueId(id) {
+    const currentId = this._uniqueId;
+    if (this._gedcom?.reflist && id) {
+      this._uniqueId = id;
+      if (currentId && this._gedcom.reflist[currentId]) {
+        delete this._gedcom.reflist[currentId];
       }
-    });
-    return propList;
+      this._gedcom.reflist[id] = this;
+    }
   }
-  keys() {
-    return Object.keys(this.items);
+  get uniqueId() {
+    return this._uniqueId;
   }
-  values() {
-    return Object.values(this.items);
+  set id(id) {
+    this._id = idGetter(id);
   }
-  entries() {
-    return Object.entries(this.items);
+  get id() {
+    return idGetter(this._id);
   }
-  setLength(_type) {
+  set value(value) {
+    this._value = value;
   }
-  first() {
-    return this.index(0);
+  get value() {
+    return this._value;
   }
-  last() {
-    return this.index(this.keys().length - 1);
+  /**
+   * Set the gedcom reference for this object
+   * @param gedcom - The GedComType to set as the gedcom reference
+   */
+  setGedcom(gedcom) {
+    this._gedcom = gedcom;
   }
-  index(index) {
-    const keys = this.keys();
-    const key = keys[index];
-    return key && this.items[key];
+  // avoid to override
+  get originalValue() {
+    return this._value;
   }
-  item(name, value) {
-    if (arguments.length > 1) {
-      set(this.items, name, value);
-      this.setLength();
+  get ref() {
+    if (typeof this.value === "string" && isId(this.value) && this.refType) {
+      return this._gedcom?.[getListTag(this.refType)]?.item(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.value
+      );
     }
-    return get(this.items, name);
+    return this;
   }
-  removeItem(name) {
-    unset(this.items, name);
-    this.setLength();
+  get main() {
+    return this._main;
   }
-  exclude(excludedList) {
-    excludedList.keys().forEach((itemId) => {
-      delete this.items[itemId];
-    });
-    this.setLength();
-    return this;
+  get parent() {
+    return this._parent;
   }
-  concat(items) {
-    if (Array.isArray(items)) {
-      items.forEach((item) => {
-        this.append(item);
-      });
-    } else {
-      Object.assign(this.items, items ?? {});
+  addRef(refNode) {
+    if (typeof refNode.value === "string" && isId(refNode.value) && refNode.refType) {
+      if (!this._refs) {
+        this._refs = new List();
+      }
+      this._refs.item(refNode.value, refNode);
     }
-    this.setLength();
-    return this;
   }
-  merge(mergedList) {
-    this.concat(mergedList?.items);
-    return this;
+  getRefs() {
+    return this._refs;
   }
-  intersection(mergedList) {
-    const inter = intersectionBy(
-      this.values(),
-      mergedList?.values() ?? [],
-      "id"
-    );
-    return new _List(inter);
+  exportValue() {
+    return this.value;
   }
-  difference(mergedList) {
-    const inter = differenceBy(
-      this.values(),
-      mergedList?.values() ?? [],
-      "id"
-    );
-    return new _List(inter);
+  removeValue() {
+    delete this._value;
   }
-  prepend(item) {
-    if (item.id) {
-      let increase = true;
-      if (this.items[item.id]) {
-        delete this.items[item.id];
-        increase = false;
-      }
-      this.items = Object.assign(
-        {
-          [item.id]: item
-        },
-        this.items
-      );
-      if (increase) {
-        this.setLength("increase");
-      }
+  set(name, value) {
+    if (isGedcomTrailerTag(name)) {
+      return void 0;
     }
-    return this;
+    if (typeof value === "string") {
+      const usedValue = createCommon(this._gedcom, void 0, this.main);
+      usedValue.value = value;
+      set(this, name, usedValue);
+    } else {
+      set(this, name, value);
+    }
+    return get(this, name);
   }
-  append(item) {
-    if (item.id) {
-      let increase = true;
-      if (this.items[item.id]) {
-        delete this.items[item.id];
-        increase = false;
-      }
-      this.items[item.id] = item;
-      if (increase) {
-        this.setLength("increase");
+  assign(name, value, unique = false) {
+    if (isGedcomTrailerTag(name)) {
+      return void 0;
+    }
+    let curValue = this.get(name);
+    if (curValue?.isListable) {
+      if (curValue instanceof _Common) {
+        curValue = new List().concat({ ...[curValue] });
+        this.set(name, curValue);
       }
+      const values = [
+        ...curValue.values(),
+        ...value instanceof List ? value.values() : [value]
+      ];
+      curValue.concat({
+        ...!unique ? values : uniqBy(
+          values,
+          (value2) => value2 instanceof _Common ? value2?.value : void 0
+        )
+      });
+    } else {
+      this.set(name, value);
     }
-    return this;
+    return get(this, name);
   }
-  delete(item) {
-    if (item.id && this.items[item.id]) {
-      delete this.items[item.id];
-      this.setLength("decrease");
+  get(name) {
+    if (!name.includes(".")) {
+      return get(this, name);
     }
-    return this;
-  }
-  copy(ClassName = _List) {
-    const newList = new ClassName();
-    Object.assign(newList.items, this.items);
-    newList.setLength();
-    return newList;
-  }
-  except(item, ClassName = _List) {
-    return this.copy(ClassName).delete(item);
+    const nameParts = name.split(".");
+    let last = this;
+    for (const part of nameParts) {
+      const indexPart = Number(part);
+      const itemIndex = part.match(/items\[(?<itemIndex>\d+)\]/)?.groups?.itemIndex;
+      const itemId = part.match(/items\[(?<itemId>@[A-Z]+\d+@)\]/)?.groups?.itemId;
+      const usedPart = itemId || itemIndex;
+      if (last instanceof List) {
+        if (!isNaN(indexPart)) {
+          last = last.index(indexPart);
+        } else {
+          if (usedPart) {
+            last = last.item(usedPart);
+          } else {
+            last = last?.index(0)?.get(part);
+          }
+        }
+      } else {
+        const usedIndex = Number(itemIndex ?? indexPart);
+        if (!isNaN(usedIndex)) {
+          last = last?.toList().index(usedIndex);
+        } else {
+          last = last?.get(itemId ?? part);
+        }
+      }
+      if (!last) {
+        break;
+      }
+    }
+    return last;
   }
-  forEach(iterate) {
-    this.entries().forEach(([key, item], index) => {
-      iterate(item, key, index);
-    });
+  remove(name) {
+    unset(this, name);
   }
-  map(iterate) {
-    return this.entries().map(([key, item], index) => {
-      return iterate(item, key, index);
-    });
+  getGedcom() {
+    return this._gedcom;
   }
-  reduce(iterate, initialValue) {
-    return this.entries().reduce((acc, [key, item], index) => {
-      return iterate(acc, item, key, index);
-    }, initialValue);
+  getIf(name, condition, name2) {
+    const nameParts = name.split(".");
+    const name2Parts = name2.split(".");
+    if (nameParts.length !== name2Parts.length) {
+      throw new Error("Tag pathes must be of the same depth");
+    }
+    if (nameParts.length > 1 && nameParts[0] !== name2Parts[0]) {
+      throw new Error("Final tags must be siblings");
+    }
+    const valueCommon = this.get(name);
+    if (valueCommon instanceof _Common) {
+      return valueCommon?.toValue() !== condition ? void 0 : this.get(name2);
+    }
+    const valueCommon2 = this.get(name2)?.toList();
+    const ifList = new List();
+    valueCommon?.forEach((item, key) => {
+      const pair = valueCommon2?.item(key);
+      ifList.item(key, item?.toValue() !== condition ? void 0 : pair);
+    });
+    return ifList;
   }
-  filter(filters, ClassName = _List) {
-    const newList = new ClassName();
-    const isIterator = typeof filters === "function";
-    this.entries().forEach(([itemId, item], index) => {
-      if (isIterator) {
-        filters(item, itemId, index) && newList.item(itemId, item);
+  toString() {
+    return this.value?.toString() || "";
+  }
+  toValue() {
+    return this.value;
+  }
+  toProp(tag) {
+    const prop = this.get(tag);
+    return prop;
+  }
+  toList() {
+    return new List().concat(
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      this.id ? { [this.id]: this } : { ...[this] }
+    );
+  }
+  index(i) {
+    return this.toList()?.index(i);
+  }
+  toValueList() {
+    return new List().concat(
+      this.value ? { [this.value]: this } : (
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        { ...[this] }
+      )
+    );
+  }
+  standardizeObject(tag, options) {
+    if (tag === "OBJE" && options?.obje?.standardize && "standardizeMedia" in this) {
+      const standardize = this.standardizeMedia;
+      return standardize.call(
+        this,
+        options.obje.namespace,
+        options.obje.override,
+        this.isAncestry() ? ancestryMediaFileUrl : void 0,
+        options.gedcomVersion
+      );
+    }
+  }
+  toJson(tag, options) {
+    const json = this.toObject(tag, options);
+    return JSON.stringify(json);
+  }
+  toObject(tag, options) {
+    this.standardizeObject(tag, options);
+    const validKeys = getValidKeys(this);
+    let json = {};
+    validKeys.forEach((key) => {
+      if (options?.persist && (key === "DAY" || key === "MONTH" || key === "YEAR")) {
         return;
       }
-      if (!Object.keys(filters).length || Object.entries(filters).every(([key, value]) => {
-        let itemValue;
-        if (key === "id") {
-          itemValue = item.toProp("id");
-        } else {
-          itemValue = item.toProp(key)?.toValue();
-        }
-        if (Array.isArray(value)) {
-          return value.includes(itemValue);
+      if (key === "id" && this.id !== void 0) {
+        json.id = this.id;
+      } else if (key === "_id" && this._id !== void 0) {
+        json.id = this._id;
+      } else if (key === "value" && this.value !== void 0) {
+        json.value = this.value;
+      } else if (key === "_value" && this._value !== void 0) {
+        json.value = this._value;
+      } else {
+        const validKey = key;
+        const prop = this.get(validKey);
+        if (typeof prop?.toObject === "function") {
+          if (prop instanceof _Common) {
+            json[validKey] = prop.toObject(validKey, options);
+          } else if (prop instanceof List) {
+            json = {
+              ...json,
+              ...prop.toObject(validKey, options)
+            };
+          }
         }
-        return itemValue === value;
-      })) {
-        newList.item(itemId, item);
       }
     });
-    return newList;
+    return json;
   }
-  find(filters, _ClassName = _List) {
-    let foundItem;
-    const isIterator = typeof filters === "function";
-    this.entries().find(([itemId, item], index) => {
-      if (isIterator) {
-        if (filters(item, itemId, index)) {
-          foundItem = item;
-          return true;
-        }
-        return false;
+  merge(other, override = false, avoidKeys = []) {
+    if (!other) {
+      return this;
+    }
+    const validKeys = getValidKeys(other);
+    validKeys.forEach((validKey) => {
+      if (avoidKeys.includes(validKey)) {
+        return;
       }
-      if (!Object.keys(filters).length || Object.entries(filters).every(([key, value]) => {
-        let itemValue;
-        if (key === "id") {
-          itemValue = item.toProp("id");
-        } else {
-          itemValue = item.toProp(key)?.toValue();
-        }
-        if (Array.isArray(value)) {
-          return value.includes(itemValue);
+      const current = this.get(validKey);
+      const mergeValue = other.get(validKey);
+      if (mergeValue) {
+        if (current instanceof _Common && !current.isListable) {
+          if (override) {
+            this.set(validKey, mergeValue);
+          }
+        } else if (current instanceof _Common || current instanceof List) {
+          this.assign(validKey, mergeValue, true);
+        } else if (!current || override && validKey !== "id" && validKey !== "_id") {
+          this.set(validKey, mergeValue);
         }
-        return itemValue === value;
-      })) {
-        foundItem = item;
-        return true;
       }
-      return false;
     });
-    return foundItem;
+    return this;
   }
-  orderBy(orders, ClassName = _List) {
-    const newList = new ClassName();
-    const isIterator = typeof orders === "function";
-    if (!isIterator && (!orders || !Object.keys(orders).length)) {
-      return newList.merge(this);
+  clone(newId = false, avoidKeys = []) {
+    const ctor = this.constructor;
+    const instance = new ctor(
+      this._gedcom,
+      this._id,
+      this._main,
+      this._parent
+    );
+    if (newId && this._id) {
+      instance.id = `IFT${this._id.replace(/[^0-9]/g, "")}`;
     }
-    const sortedItems = this.entries().toSorted(
-      ([itemAId, itemA], [itemBId, itemB]) => {
-        if (isIterator) {
-          return orders(itemA, itemAId, itemB, itemBId);
-        }
-        const [key, { direction, getter }] = Object.entries(
-          typeof orders === "string" ? { [orders]: { direction: "ASC" } } : orders
-        )[0];
-        const rawA = itemA.get(key);
-        const rawB = itemB.get(key);
-        let valueA = rawA?.toValue();
-        let valueB = rawB?.toValue();
-        if (getter && typeof getter === "function") {
-          valueA = getter(valueA, rawA);
-          valueB = getter(valueB, rawB);
-        }
-        let sortValue = 0;
-        if (!valueA && valueA !== 0 && !valueB && valueB !== 0) {
-          sortValue = 0;
-        } else if (!valueB && valueB !== 0) {
-          sortValue = 1;
-        } else if (!valueA && valueA !== 0) {
-          sortValue = -1;
-        } else if (valueA < valueB) {
-          sortValue = -1;
-        } else if (valueA > valueB) {
-          sortValue = 1;
+    const cloned = createProxy(instance);
+    cloned.merge(this, true, avoidKeys);
+    return cloned;
+  }
+  // fromGedcom<T = typeof this>(value: string) {
+  fromGedcom(_value) {
+  }
+  toGedcom(tag, level = 0, options) {
+    const gedcom = this.toGedcomLines(tag, level, options);
+    return gedcom.join("\n");
+  }
+  toGedcomLines(tag, level = 0, options) {
+    this.standardizeObject(tag, options);
+    const validKeys = getValidKeys(this);
+    const gedcom = [];
+    const isGedcom7Export = options?.gedcomVersion === "7.0";
+    validKeys.forEach((key) => {
+      const validKey = key;
+      if (isGedcom7Export && validKey === "CONC") {
+        return;
+      }
+      const prop = this.get(validKey);
+      if (typeof prop?.toGedcomLines === "function") {
+        if (prop instanceof _Common) {
+          const value = prop.exportValue();
+          gedcom.push(
+            `${level} ${validKey}${value ? ` ${value}` : ""}`
+          );
+          gedcom.push(
+            ...prop.toGedcomLines(validKey, level + 1, options)
+          );
+        } else if (prop instanceof List) {
+          gedcom.push(
+            ...prop.toGedcomLines(validKey, level, options)
+          );
         }
-        return sortValue * (direction === "DESC" ? -1 : 1);
       }
-    );
-    sortedItems.forEach(([key, value]) => {
-      newList.item(key, value);
     });
-    return newList;
+    return gedcom;
   }
-  groupBy(groups, sort, minOccurance = -1, lessOccuranceLabel = "Appearing less than 5 times", ClassName = _List) {
-    const groupped = {};
-    const isIterator = typeof groups === "function";
-    if (!isIterator && (!groups || !Object.keys(groups).length)) {
-      groupped.Unknown = new ClassName().merge(this);
-      groupped.Unknown.marker = "Unknown";
-      return groupped;
-    }
-    this.forEach((item, itemId) => {
-      const group = [];
-      if (isIterator) {
-        const newGroups = groups(item, itemId);
-        group.push(
-          ...Array.isArray(newGroups) ? newGroups : [newGroups]
-        );
-      } else {
-        const [key, { getter }] = Object.entries(
-          typeof groups === "string" ? { [groups]: {} } : groups
-        )[0];
-        const raw = item.get(key)?.index(0);
-        let value = raw?.toValue();
-        if (getter && typeof getter === "function") {
-          value = getter(value, raw);
-        }
-        if (value) {
-          group.push(value);
-        }
-      }
-      if (!group.length) {
-        group.push("Unknown");
-      }
-      group.forEach((g) => {
-        const newGroup = typeof g === "string" ? { group: g } : g;
-        if (!groupped[newGroup.group]) {
-          groupped[newGroup.group] = new ClassName();
-          groupped[newGroup.group].marker = newGroup.marker ?? newGroup.group;
-        }
-        groupped[newGroup.group]?.append(item);
-      });
-    });
-    if (sort) {
-      return Object.entries(groupped).toSorted(([ak, a], [bk, b]) => {
-        if (typeof sort === "function") {
-          return sort(a, ak, b, bk);
-        }
-        if (ak === "Unknown") {
-          return 1;
-        }
-        if (bk === "Unknown") {
-          return -1;
-        }
-        if (sort === "group") {
-          return ak.localeCompare(bk);
-        }
-        return (b?.length ?? 0) - (a?.length ?? 0);
-      }).reduce((acc, [key, value]) => {
-        if (minOccurance > -1 && (value?.length ?? 0) < minOccurance) {
-          const otherKey = lessOccuranceLabel;
-          acc[otherKey] = acc[otherKey] && value ? acc[otherKey].merge(value) : value;
-        } else {
-          acc[key] = value;
-        }
-        return acc;
-      }, {});
-    }
-    return groupped;
-  }
-  findIndex(item) {
-    if (!item?.id) {
-      return -1;
-    }
-    return this.keys().findIndex((key) => key === item.id);
+  getHeadRecord() {
+    return get(this, "HEAD") || get(this.getGedcom(), "HEAD");
   }
-  getItems() {
-    return this.items;
+  getOriginalHeadRecord() {
+    return get(this, ORIG_HEAD_TAG) || get(this.getGedcom(), ORIG_HEAD_TAG) || get(this.getHeadRecord(), ORIG_HEAD_TAG);
   }
-  toJson(tag, options) {
-    const json = this.toObject(tag, options);
-    return JSON.stringify(json);
+  getSourceHeads() {
+    const heads = [this.getOriginalHeadRecord(), this.getHeadRecord()];
+    return heads.filter((head, index) => {
+      return Boolean(head && heads.indexOf(head) === index);
+    });
   }
-  toObject(tag, options) {
-    const json = {};
-    this.entries().forEach(([_, item]) => {
-      const validTag = getValidTag(tag);
-      if (json[validTag]) {
-        if (!Array.isArray(json[validTag])) {
-          json[validTag] = [json[validTag]];
-        }
-        json[validTag].push(
-          item.toObject(validTag, options)
-        );
-      } else {
-        json[validTag] = item.toObject(
-          validTag,
-          options
-        );
+  getFromSourceHeads(path) {
+    for (const head of this.getSourceHeads()) {
+      const value = get(head, path);
+      if (value !== void 0 && value !== null && value !== "") {
+        return value;
       }
+    }
+    return void 0;
+  }
+  sourStartsWith(prefix) {
+    return this.getSourceHeads().some((head) => {
+      const sour = get(head, "SOUR.value");
+      return !!sour?.toLowerCase()?.startsWith(prefix);
     });
-    return json;
   }
-  toGedcom(tag, level = 0, options) {
-    const gedcom = this.toGedcomLines(tag, level, options);
-    return gedcom.join("\n");
+  isGenoPro() {
+    return this.sourStartsWith("genopro");
   }
-  toGedcomLines(tag, level = 0, options) {
-    const gedcom = [];
-    this.entries().forEach(([_, item]) => {
-      const validTag = getValidTag(tag);
-      const xref = item.id;
-      const payload = item.exportValue?.();
-      if (xref) {
-        gedcom.push(
-          `${level} ${xref} ${validTag}${payload ? ` ${payload}` : ""}`
-        );
-      } else {
-        gedcom.push(
-          `${level} ${validTag}${payload ? ` ${payload}` : ""}`
-        );
-      }
-      gedcom.push(
-        ...item.toGedcomLines(
-          validTag,
-          level + 1,
-          options
-        )
-      );
-    });
-    return gedcom;
+  isAhnenblatt() {
+    return this.sourStartsWith("ahnenblatt");
   }
-  toValue() {
-    const propList = new _List();
-    this.entries().forEach(([key, item]) => {
-      propList.item(key, item?.toValue());
-    });
-    return propList;
+  isGeni() {
+    return this.sourStartsWith("geni");
   }
-  // @deprecated use get instead
-  toProp(tag) {
-    return this.get(tag);
+  isAncestry() {
+    return this.sourStartsWith("ancestry");
   }
-  toList() {
-    return new _List().concat(this.items);
+  isMyHeritage() {
+    return this.sourStartsWith("myheritage");
   }
-  toValueList() {
-    const newList = new _List();
-    this.values().forEach((value) => {
-      value.value && newList.item(value.value, value);
+  /**
+   * Get the source type as a string (for prefixing tree IDs and names)
+   * Returns the detected source type or undefined if unknown
+   */
+  getSourceType() {
+    if (this.isAncestry()) return "Ancestry";
+    if (this.isMyHeritage()) return "MyHeritage";
+    if (this.isFamilySearch()) return "FamilySearch";
+    if (this.isGNO2GED()) return "GNO2GED";
+    if (this.isGenoPro()) return "GenoPro";
+    if (this.isAhnenblatt()) return "Ahnenblatt";
+    if (this.isGeni()) return "Geni";
+    return void 0;
+  }
+  isFamilySearch() {
+    return this.getSourceHeads().some((head) => {
+      const sourName = get(head, "SOUR.NAME.value");
+      return sourName === "FamilySearch API";
     });
-    return newList;
   }
-};
-
-// src/classes/common.ts
-var Common = class _Common {
-  constructor(gedcom, id, main, parent) {
-    this.isListable = true;
-    this._gedcom = gedcom;
-    this._main = main;
-    this._parent = parent;
-    this.initUniqueId();
-    if (id) {
-      this._id = id;
-    } else {
-      delete this._id;
-    }
+  isGNO2GED() {
+    return this.getSourceHeads().some((head) => {
+      const sour = get(head, "SOUR.value");
+      return sour === "GNO2GED";
+    });
   }
-  set type(type) {
-    if (type) {
-      this.uniqueId = this.uniqueId?.replace(/^[^:]+/, `~${type}`);
-    }
-    this._type = type;
+  getAncestryTreeId() {
+    return this.getFromSourceHeads("SOUR._TREE.RIN.value") || (get(this, "HEAD.SOUR._TREE.RIN.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.RIN.value"));
   }
-  get type() {
-    return this._type;
+  getMyHeritageTreeId() {
+    return this.getFromSourceHeads("_EXPORTED_FROM_SITE_ID.value") || (get(this, "HEAD._EXPORTED_FROM_SITE_ID.value") || get(this.getGedcom(), "HEAD._EXPORTED_FROM_SITE_ID.value"));
   }
-  initUniqueId() {
-    if (this._gedcom) {
-      this.uniqueId = `~Common:${this._gedcom.refcount++}`;
+  getTreeId() {
+    if (this?.isAncestry()) {
+      const id = this.getAncestryTreeId();
+      if (id !== void 0) return id;
     }
-  }
-  set uniqueId(id) {
-    const currentId = this._uniqueId;
-    if (this._gedcom?.reflist && id) {
-      this._uniqueId = id;
-      if (currentId && this._gedcom.reflist[currentId]) {
-        delete this._gedcom.reflist[currentId];
-      }
-      this._gedcom.reflist[id] = this;
+    if (this?.isMyHeritage()) {
+      const id = this.getMyHeritageTreeId();
+      if (id !== void 0) return id;
+    }
+    if (this?.isFamilySearch()) {
+      const id = this.getFamilySearchTreeId();
+      if (id !== void 0) return id;
+    }
+    if (this?.isGNO2GED()) {
+      const id = this.getGNO2GEDTreeId();
+      if (id !== void 0) return id;
+    }
+    if (this?.isAhnenblatt()) {
+      const id = this.getAhnenblattTreeId();
+      if (id !== void 0) return id;
+    }
+    if (this?.isGeni()) {
+      const id = this.getGeniTreeId();
+      if (id !== void 0) return id;
+    }
+    if (this?.isGenoPro()) {
+      const id = this.getGenoProTreeId();
+      if (id !== void 0) return id;
     }
+    return this.getUniversalTreeId();
   }
-  get uniqueId() {
-    return this._uniqueId;
+  getAncestryTreeName() {
+    return this.getFromSourceHeads("SOUR._TREE.value") || (get(this, "HEAD.SOUR._TREE.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.value"));
   }
-  set id(id) {
-    this._id = idGetter(id);
+  getMyHeritageTreeName() {
+    const path = "HEAD.FILE.value";
+    const treeDetails = get(this, path) || get(this.getGedcom(), path);
+    return treeDetails?.match(
+      /Exported by MyHeritage.com from (?<tree>.+) in.+$/
+    )?.groups?.tree;
   }
-  get id() {
-    return idGetter(this._id);
+  getFamilySearchTreeId() {
+    const rin = this.getFromSourceHeads("SOUR._TREE.RIN.value") || get(this, "HEAD.SOUR._TREE.RIN.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.RIN.value");
+    if (rin) {
+      return rin;
+    }
+    return "familysearch";
   }
-  set value(value) {
-    this._value = value;
-  }
-  get value() {
-    return this._value;
-  }
-  /**
-   * Set the gedcom reference for this object
-   * @param gedcom - The GedComType to set as the gedcom reference
-   */
-  setGedcom(gedcom) {
-    this._gedcom = gedcom;
-  }
-  // avoid to override
-  get originalValue() {
-    return this._value;
-  }
-  get ref() {
-    if (typeof this.value === "string" && isId(this.value) && this.refType) {
-      return this._gedcom?.[getListTag(this.refType)]?.item(
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.value
-      );
+  getFamilySearchTreeName() {
+    const treeName = this.getFromSourceHeads("SOUR._TREE.value") || get(this, "HEAD.SOUR._TREE.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.value");
+    if (treeName) {
+      return treeName;
     }
-    return this;
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    return fileName || "FamilySearch Import";
   }
-  get main() {
-    return this._main;
+  getAhnenblattTreeId() {
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    if (fileName) {
+      const idMatch = fileName.match(/_(\d+)/);
+      if (idMatch) {
+        return idMatch[1];
+      }
+    }
+    return void 0;
   }
-  get parent() {
-    return this._parent;
+  getAhnenblattTreeName() {
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    return fileName?.replace(/\.ged$/i, "").replace(/_/g, " ");
   }
-  addRef(refNode) {
-    if (typeof refNode.value === "string" && isId(refNode.value) && refNode.refType) {
-      if (!this._refs) {
-        this._refs = new List();
+  getGeniTreeId() {
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    if (fileName) {
+      const idMatch = fileName.match(/_(\d+)/);
+      if (idMatch) {
+        return idMatch[1];
       }
-      this._refs.item(refNode.value, refNode);
     }
+    return void 0;
   }
-  getRefs() {
-    return this._refs;
+  getGeniTreeName() {
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    return fileName?.replace(/\.ged$/i, "").replace(/_/g, " ");
   }
-  exportValue() {
-    return this.value;
+  getGenoProTreeId() {
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    if (fileName) {
+      const idMatch = fileName.match(/_(\d+)/);
+      if (idMatch) {
+        return idMatch[1];
+      }
+    }
+    return void 0;
   }
-  removeValue() {
-    delete this._value;
+  getGenoProTreeName() {
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    return fileName?.replace(/\.ged$/i, "").replace(/_/g, " ");
   }
-  set(name, value) {
-    if (isGedcomTrailerTag(name)) {
-      return void 0;
-    }
-    if (typeof value === "string") {
-      const usedValue = createCommon(this._gedcom, void 0, this.main);
-      usedValue.value = value;
-      set(this, name, usedValue);
-    } else {
-      set(this, name, value);
+  getGNO2GEDTreeId() {
+    const rin = get(this, "HEAD._TREE.RIN.value") || get(this.getGedcom(), "HEAD._TREE.RIN.value");
+    if (rin) {
+      return rin;
     }
-    return get(this, name);
+    return `gno_${this._gedcom?.refcount || "unknown"}`;
   }
-  assign(name, value, unique = false) {
-    if (isGedcomTrailerTag(name)) {
-      return void 0;
+  getGNO2GEDTreeName() {
+    const treeName = get(this, "HEAD._TREE.value") || get(this.getGedcom(), "HEAD._TREE.value");
+    if (treeName) {
+      return treeName;
     }
-    let curValue = this.get(name);
-    if (curValue?.isListable) {
-      if (curValue instanceof _Common) {
-        curValue = new List().concat({ ...[curValue] });
-        this.set(name, curValue);
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    return fileName || "GNO2GED Export";
+  }
+  /**
+   * Universal tree ID getter for unknown/unrecognized GEDCOM sources
+   * Tries to extract an ID from various common locations
+   */
+  getUniversalTreeId() {
+    const sourceType = this.getSourceType();
+    const prefix = sourceType ? sourceType.toLowerCase() : "tree";
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    if (fileName) {
+      const idMatch = fileName.match(/_(\d+)/);
+      if (idMatch) {
+        return `${prefix}_${idMatch[1]}`;
       }
-      const values = [
-        ...curValue.values(),
-        ...value instanceof List ? value.values() : [value]
-      ];
-      curValue.concat({
-        ...!unique ? values : uniqBy(
-          values,
-          (value2) => value2 instanceof _Common ? value2?.value : void 0
-        )
-      });
-    } else {
-      this.set(name, value);
     }
-    return get(this, name);
+    return `${prefix}_${this._gedcom?.refcount || "unknown"}`;
   }
-  get(name) {
-    if (!name.includes(".")) {
-      return get(this, name);
+  /**
+   * Universal tree name getter for unknown/unrecognized GEDCOM sources
+   * Tries to extract a name from various common locations
+   */
+  getUniversalTreeName() {
+    const sourceType = this.getSourceType();
+    const prefix = sourceType ? `${sourceType}-` : "";
+    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
+    if (fileName) {
+      const cleanName = fileName.replace(/\.ged$/i, "").replace(/_/g, " ");
+      return `${prefix}${cleanName}`;
     }
-    const nameParts = name.split(".");
-    let last = this;
-    for (const part of nameParts) {
-      const indexPart = Number(part);
-      const itemIndex = part.match(/items\[(?<itemIndex>\d+)\]/)?.groups?.itemIndex;
-      const itemId = part.match(/items\[(?<itemId>@[A-Z]+\d+@)\]/)?.groups?.itemId;
-      const usedPart = itemId || itemIndex;
-      if (last instanceof List) {
-        if (!isNaN(indexPart)) {
-          last = last.index(indexPart);
-        } else {
-          if (usedPart) {
-            last = last.item(usedPart);
-          } else {
-            last = last?.index(0)?.get(part);
-          }
-        }
-      } else {
-        const usedIndex = Number(itemIndex ?? indexPart);
-        if (!isNaN(usedIndex)) {
-          last = last?.toList().index(usedIndex);
-        } else {
-          last = last?.get(itemId ?? part);
-        }
-      }
-      if (!last) {
-        break;
-      }
+    const sourName = this.getFromSourceHeads("SOUR.NAME.value") || get(this, "HEAD.SOUR.NAME.value") || get(this.getGedcom(), "HEAD.SOUR.NAME.value");
+    if (sourName) {
+      return `${prefix}${sourName}`;
     }
-    return last;
-  }
-  remove(name) {
-    unset(this, name);
-  }
-  getGedcom() {
-    return this._gedcom;
+    const sourValue = this.getFromSourceHeads("SOUR.value") || get(this, "HEAD.SOUR.value") || get(this.getGedcom(), "HEAD.SOUR.value");
+    if (sourValue) {
+      return `${prefix}${sourValue}`;
+    }
+    return `${prefix}Unknown Tree`;
   }
-  getIf(name, condition, name2) {
-    const nameParts = name.split(".");
-    const name2Parts = name2.split(".");
-    if (nameParts.length !== name2Parts.length) {
-      throw new Error("Tag pathes must be of the same depth");
+  getTreeName() {
+    if (this?.isAncestry()) {
+      const name = this.getAncestryTreeName();
+      if (name) return name;
     }
-    if (nameParts.length > 1 && nameParts[0] !== name2Parts[0]) {
-      throw new Error("Final tags must be siblings");
+    if (this?.isMyHeritage()) {
+      const name = this.getMyHeritageTreeName();
+      if (name) return name;
     }
-    const valueCommon = this.get(name);
-    if (valueCommon instanceof _Common) {
-      return valueCommon?.toValue() !== condition ? void 0 : this.get(name2);
+    if (this?.isFamilySearch()) {
+      const name = this.getFamilySearchTreeName();
+      if (name) return name;
     }
-    const valueCommon2 = this.get(name2)?.toList();
-    const ifList = new List();
-    valueCommon?.forEach((item, key) => {
-      const pair = valueCommon2?.item(key);
-      ifList.item(key, item?.toValue() !== condition ? void 0 : pair);
-    });
-    return ifList;
-  }
-  toString() {
-    return this.value?.toString() || "";
-  }
-  toValue() {
-    return this.value;
-  }
-  toProp(tag) {
-    const prop = this.get(tag);
-    return prop;
-  }
-  toList() {
-    return new List().concat(
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      this.id ? { [this.id]: this } : { ...[this] }
-    );
-  }
-  index(i) {
-    return this.toList()?.index(i);
+    if (this?.isGNO2GED()) {
+      const name = this.getGNO2GEDTreeName();
+      if (name) return name;
+    }
+    if (this?.isAhnenblatt()) {
+      const name = this.getAhnenblattTreeName();
+      if (name) return name;
+    }
+    if (this?.isGeni()) {
+      const name = this.getGeniTreeName();
+      if (name) return name;
+    }
+    if (this?.isGenoPro()) {
+      const name = this.getGenoProTreeName();
+      if (name) return name;
+    }
+    return this.getUniversalTreeName();
   }
-  toValueList() {
-    return new List().concat(
-      this.value ? { [this.value]: this } : (
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        { ...[this] }
-      )
-    );
-  }
-  standardizeObject(tag, options) {
-    if (tag === "OBJE" && options?.obje?.standardize && "standardizeMedia" in this) {
-      const standardize = this.standardizeMedia;
-      return standardize.call(
-        this,
-        options.obje.namespace,
-        options.obje.override,
-        this.isAncestry() ? ancestryMediaFileUrl : void 0,
-        options.gedcomVersion
-      );
-    }
-  }
-  toJson(tag, options) {
-    const json = this.toObject(tag, options);
-    return JSON.stringify(json);
-  }
-  toObject(tag, options) {
-    this.standardizeObject(tag, options);
-    const validKeys = getValidKeys(this);
-    let json = {};
-    validKeys.forEach((key) => {
-      if (options?.persist && (key === "DAY" || key === "MONTH" || key === "YEAR")) {
-        return;
-      }
-      if (key === "id" && this.id !== void 0) {
-        json.id = this.id;
-      } else if (key === "_id" && this._id !== void 0) {
-        json.id = this._id;
-      } else if (key === "value" && this.value !== void 0) {
-        json.value = this.value;
-      } else if (key === "_value" && this._value !== void 0) {
-        json.value = this._value;
-      } else {
-        const validKey = key;
-        const prop = this.get(validKey);
-        if (typeof prop?.toObject === "function") {
-          if (prop instanceof _Common) {
-            json[validKey] = prop.toObject(validKey, options);
-          } else if (prop instanceof List) {
-            json = {
-              ...json,
-              ...prop.toObject(validKey, options)
-            };
-          }
-        }
+};
+var createProxy = (target) => {
+  return new Proxy(target, {
+    get(t, prop, receiver) {
+      if (prop === "unwrapped") {
+        return target;
       }
-    });
-    return json;
-  }
-  merge(other, override = false, avoidKeys = []) {
-    if (!other) {
-      return this;
-    }
-    const validKeys = getValidKeys(other);
-    validKeys.forEach((validKey) => {
-      if (avoidKeys.includes(validKey)) {
-        return;
+      if (prop in t) {
+        return Reflect.get(t, prop, receiver);
       }
-      const current = this.get(validKey);
-      const mergeValue = other.get(validKey);
-      if (mergeValue) {
-        if (current instanceof _Common || current instanceof List) {
-          this.assign(validKey, mergeValue, true);
-        } else if (!current || override && validKey !== "id" && validKey !== "_id") {
-          this.set(validKey, mergeValue);
+      if (!isOnlyMainProp(prop)) {
+        const ref = t.ref;
+        if (ref && prop in ref) {
+          return Reflect.get(ref, prop, receiver);
         }
       }
-    });
-    return this;
-  }
-  clone(newId = false, avoidKeys = []) {
-    const ctor = this.constructor;
-    const instance = new ctor(
-      this._gedcom,
-      this._id,
-      this._main,
-      this._parent
-    );
-    if (newId && this._id) {
-      instance.id = `IFT${this._id.replace(/[^0-9]/g, "")}`;
     }
-    const cloned = createProxy(instance);
-    cloned.merge(this, true, avoidKeys);
-    return cloned;
+  });
+};
+var createCommon = (gedcom, id, main, parent) => {
+  return createProxy(
+    new Common(gedcom, id, main, parent)
+  );
+};
+var isOnlyMainProp = (key) => {
+  return key === "_gedcom" || key === "_main" || key === "_parent" || key === "_uniqueId" || key === "_type" || key === "_refs" || key === "id" || key === "_id";
+};
+var isValidKey = (common, key) => {
+  const prop = get(common, key);
+  return key !== "_gedcom" && key !== "_main" && key !== "_parent" && key !== "_uniqueId" && key !== "_refs" && key !== "_type" && !(typeof key === "string" && isGedcomTrailerTag(key)) && (key === "id" || key === "_id" || key === "value" || key === "_value" || prop instanceof Common || prop instanceof List);
+};
+var getValidKeys = (common) => {
+  return Object.keys(common).filter((key) => {
+    return isValidKey(common, key);
+  });
+};
+var getValidTag = (tag) => {
+  return tag.replace(/^@@/, "");
+};
+var getListTag = (tag) => {
+  return `@@${tag}`;
+};
+var isId = (string) => {
+  return ID_REG.test(string);
+};
+var idGetter = (id) => {
+  if (id === void 0) {
+    return void 0;
   }
-  // fromGedcom<T = typeof this>(value: string) {
-  fromGedcom(_value) {
+  let newId = `${id}`;
+  const parts = newId?.match(ID_GETTER_REG)?.groups;
+  if (!parts?.at && !parts?.letter) {
+    newId = `@U${newId}`;
+  } else if (!parts.at) {
+    newId = `@${newId}`;
+  } else if (!parts.letter) {
+    newId = newId.replace(/^@/, "@U");
   }
-  toGedcom(tag, level = 0, options) {
-    const gedcom = this.toGedcomLines(tag, level, options);
-    return gedcom.join("\n");
+  if (!newId.endsWith("@")) {
+    newId = `${newId}@`;
   }
-  toGedcomLines(tag, level = 0, options) {
-    this.standardizeObject(tag, options);
-    const validKeys = getValidKeys(this);
-    const gedcom = [];
-    const isGedcom7Export = options?.gedcomVersion === "7.0";
-    validKeys.forEach((key) => {
-      const validKey = key;
-      if (isGedcom7Export && validKey === "CONC") {
-        return;
-      }
-      const prop = this.get(validKey);
-      if (typeof prop?.toGedcomLines === "function") {
-        if (prop instanceof _Common) {
-          const value = prop.exportValue();
-          gedcom.push(
-            `${level} ${validKey}${value ? ` ${value}` : ""}`
-          );
-          gedcom.push(
-            ...prop.toGedcomLines(validKey, level + 1, options)
-          );
-        } else if (prop instanceof List) {
-          gedcom.push(
-            ...prop.toGedcomLines(validKey, level, options)
-          );
-        }
-      }
-    });
-    return gedcom;
+  return newId;
+};
+
+// src/classes/list.ts
+var List = class _List {
+  // length = 0;
+  constructor(items) {
+    this.items = {};
+    this.isListable = true;
+    this.marker = void 0;
+    if (items) {
+      this.concat(items);
+    }
   }
-  getHeadRecord() {
-    return get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+  get length() {
+    return this.values().length;
   }
-  getOriginalHeadRecord() {
-    return get(this, ORIG_HEAD_TAG) || get(this.getGedcom(), ORIG_HEAD_TAG) || get(this.getHeadRecord(), ORIG_HEAD_TAG);
+  has(indi) {
+    return !!this.item(
+      typeof indi === "string" ? indi : indi?.id ?? ""
+    );
   }
-  getSourceHeads() {
-    const heads = [this.getOriginalHeadRecord(), this.getHeadRecord()];
-    return heads.filter((head, index) => {
-      return Boolean(head && heads.indexOf(head) === index);
+  get(name) {
+    const propList = new _List();
+    this.entries().forEach(([key, item]) => {
+      propList.item(key, item.get(name));
     });
+    return propList;
   }
-  getFromSourceHeads(path) {
-    for (const head of this.getSourceHeads()) {
-      const value = get(head, path);
-      if (value !== void 0 && value !== null && value !== "") {
-        return value;
+  getIf(name, condition, name2) {
+    const propList = new _List();
+    this.entries().forEach(([key, item]) => {
+      const passedItem = item.getIf(name, condition, name2);
+      if (passedItem) {
+        propList.item(key, passedItem);
       }
-    }
-    return void 0;
-  }
-  sourStartsWith(prefix) {
-    return this.getSourceHeads().some((head) => {
-      const sour = get(head, "SOUR.value");
-      return !!sour?.toLowerCase()?.startsWith(prefix);
     });
+    return propList;
   }
-  isGenoPro() {
-    return this.sourStartsWith("genopro");
+  keys() {
+    return Object.keys(this.items);
   }
-  isAhnenblatt() {
-    return this.sourStartsWith("ahnenblatt");
+  values() {
+    return Object.values(this.items);
   }
-  isGeni() {
-    return this.sourStartsWith("geni");
+  entries() {
+    return Object.entries(this.items);
   }
-  isAncestry() {
-    return this.sourStartsWith("ancestry");
+  setLength(_type) {
   }
-  isMyHeritage() {
-    return this.sourStartsWith("myheritage");
+  first() {
+    return this.index(0);
   }
-  /**
-   * Get the source type as a string (for prefixing tree IDs and names)
-   * Returns the detected source type or undefined if unknown
-   */
-  getSourceType() {
-    if (this.isAncestry()) return "Ancestry";
-    if (this.isMyHeritage()) return "MyHeritage";
-    if (this.isFamilySearch()) return "FamilySearch";
-    if (this.isGNO2GED()) return "GNO2GED";
-    if (this.isGenoPro()) return "GenoPro";
-    if (this.isAhnenblatt()) return "Ahnenblatt";
-    if (this.isGeni()) return "Geni";
-    return void 0;
+  last() {
+    return this.index(this.keys().length - 1);
   }
-  isFamilySearch() {
-    return this.getSourceHeads().some((head) => {
-      const sourName = get(head, "SOUR.NAME.value");
-      return sourName === "FamilySearch API";
-    });
+  index(index) {
+    const keys = this.keys();
+    const key = keys[index];
+    return key && this.items[key];
   }
-  isGNO2GED() {
-    return this.getSourceHeads().some((head) => {
-      const sour = get(head, "SOUR.value");
-      return sour === "GNO2GED";
-    });
+  item(name, value) {
+    if (arguments.length > 1) {
+      set(this.items, name, value);
+      this.setLength();
+    }
+    return get(this.items, name);
   }
-  getAncestryTreeId() {
-    return this.getFromSourceHeads("SOUR._TREE.RIN.value") || (get(this, "HEAD.SOUR._TREE.RIN.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.RIN.value"));
+  removeItem(name) {
+    unset(this.items, name);
+    this.setLength();
   }
-  getMyHeritageTreeId() {
-    return this.getFromSourceHeads("_EXPORTED_FROM_SITE_ID.value") || (get(this, "HEAD._EXPORTED_FROM_SITE_ID.value") || get(this.getGedcom(), "HEAD._EXPORTED_FROM_SITE_ID.value"));
+  exclude(excludedList) {
+    excludedList.keys().forEach((itemId) => {
+      delete this.items[itemId];
+    });
+    this.setLength();
+    return this;
   }
-  getTreeId() {
-    if (this?.isAncestry()) {
-      const id = this.getAncestryTreeId();
-      if (id !== void 0) return id;
-    }
-    if (this?.isMyHeritage()) {
-      const id = this.getMyHeritageTreeId();
-      if (id !== void 0) return id;
-    }
-    if (this?.isFamilySearch()) {
-      const id = this.getFamilySearchTreeId();
-      if (id !== void 0) return id;
-    }
-    if (this?.isGNO2GED()) {
-      const id = this.getGNO2GEDTreeId();
-      if (id !== void 0) return id;
-    }
-    if (this?.isAhnenblatt()) {
-      const id = this.getAhnenblattTreeId();
-      if (id !== void 0) return id;
-    }
-    if (this?.isGeni()) {
-      const id = this.getGeniTreeId();
-      if (id !== void 0) return id;
-    }
-    if (this?.isGenoPro()) {
-      const id = this.getGenoProTreeId();
-      if (id !== void 0) return id;
+  concat(items) {
+    if (Array.isArray(items)) {
+      items.forEach((item) => {
+        this.append(item);
+      });
+    } else {
+      Object.assign(this.items, items ?? {});
     }
-    return this.getUniversalTreeId();
+    this.setLength();
+    return this;
   }
-  getAncestryTreeName() {
-    return this.getFromSourceHeads("SOUR._TREE.value") || (get(this, "HEAD.SOUR._TREE.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.value"));
+  merge(mergedList) {
+    this.concat(mergedList?.items);
+    return this;
   }
-  getMyHeritageTreeName() {
-    const path = "HEAD.FILE.value";
-    const treeDetails = get(this, path) || get(this.getGedcom(), path);
-    return treeDetails?.match(
-      /Exported by MyHeritage.com from (?<tree>.+) in.+$/
-    )?.groups?.tree;
+  intersection(mergedList) {
+    const inter = intersectionBy(
+      this.values(),
+      mergedList?.values() ?? [],
+      "id"
+    );
+    return new _List(inter);
   }
-  getFamilySearchTreeId() {
-    const rin = this.getFromSourceHeads("SOUR._TREE.RIN.value") || get(this, "HEAD.SOUR._TREE.RIN.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.RIN.value");
-    if (rin) {
-      return rin;
-    }
-    return "familysearch";
+  difference(mergedList) {
+    const inter = differenceBy(
+      this.values(),
+      mergedList?.values() ?? [],
+      "id"
+    );
+    return new _List(inter);
   }
-  getFamilySearchTreeName() {
-    const treeName = this.getFromSourceHeads("SOUR._TREE.value") || get(this, "HEAD.SOUR._TREE.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.value");
-    if (treeName) {
-      return treeName;
+  prepend(item) {
+    if (item.id) {
+      let increase = true;
+      if (this.items[item.id]) {
+        delete this.items[item.id];
+        increase = false;
+      }
+      this.items = Object.assign(
+        {
+          [item.id]: item
+        },
+        this.items
+      );
+      if (increase) {
+        this.setLength("increase");
+      }
     }
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    return fileName || "FamilySearch Import";
+    return this;
   }
-  getAhnenblattTreeId() {
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    if (fileName) {
-      const idMatch = fileName.match(/_(\d+)/);
-      if (idMatch) {
-        return idMatch[1];
+  append(item) {
+    if (item.id) {
+      let increase = true;
+      if (this.items[item.id]) {
+        delete this.items[item.id];
+        increase = false;
+      }
+      this.items[item.id] = item;
+      if (increase) {
+        this.setLength("increase");
       }
     }
-    return void 0;
-  }
-  getAhnenblattTreeName() {
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    return fileName?.replace(/\.ged$/i, "").replace(/_/g, " ");
+    return this;
   }
-  getGeniTreeId() {
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    if (fileName) {
-      const idMatch = fileName.match(/_(\d+)/);
-      if (idMatch) {
-        return idMatch[1];
-      }
+  delete(item) {
+    if (item.id && this.items[item.id]) {
+      delete this.items[item.id];
+      this.setLength("decrease");
     }
-    return void 0;
+    return this;
   }
-  getGeniTreeName() {
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    return fileName?.replace(/\.ged$/i, "").replace(/_/g, " ");
+  copy(ClassName = _List) {
+    const newList = new ClassName();
+    Object.assign(newList.items, this.items);
+    newList.setLength();
+    return newList;
   }
-  getGenoProTreeId() {
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    if (fileName) {
-      const idMatch = fileName.match(/_(\d+)/);
-      if (idMatch) {
-        return idMatch[1];
-      }
-    }
-    return void 0;
+  except(item, ClassName = _List) {
+    return this.copy(ClassName).delete(item);
   }
-  getGenoProTreeName() {
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    return fileName?.replace(/\.ged$/i, "").replace(/_/g, " ");
+  forEach(iterate) {
+    this.entries().forEach(([key, item], index) => {
+      iterate(item, key, index);
+    });
   }
-  getGNO2GEDTreeId() {
-    const rin = get(this, "HEAD._TREE.RIN.value") || get(this.getGedcom(), "HEAD._TREE.RIN.value");
-    if (rin) {
-      return rin;
-    }
-    return `gno_${this._gedcom?.refcount || "unknown"}`;
+  map(iterate) {
+    return this.entries().map(([key, item], index) => {
+      return iterate(item, key, index);
+    });
   }
-  getGNO2GEDTreeName() {
-    const treeName = get(this, "HEAD._TREE.value") || get(this.getGedcom(), "HEAD._TREE.value");
-    if (treeName) {
-      return treeName;
-    }
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    return fileName || "GNO2GED Export";
+  reduce(iterate, initialValue) {
+    return this.entries().reduce((acc, [key, item], index) => {
+      return iterate(acc, item, key, index);
+    }, initialValue);
   }
-  /**
-   * Universal tree ID getter for unknown/unrecognized GEDCOM sources
-   * Tries to extract an ID from various common locations
-   */
-  getUniversalTreeId() {
-    const sourceType = this.getSourceType();
-    const prefix = sourceType ? sourceType.toLowerCase() : "tree";
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    if (fileName) {
-      const idMatch = fileName.match(/_(\d+)/);
-      if (idMatch) {
-        return `${prefix}_${idMatch[1]}`;
+  filter(filters, ClassName = _List) {
+    const newList = new ClassName();
+    const isIterator = typeof filters === "function";
+    this.entries().forEach(([itemId, item], index) => {
+      if (isIterator) {
+        filters(item, itemId, index) && newList.item(itemId, item);
+        return;
       }
-    }
-    return `${prefix}_${this._gedcom?.refcount || "unknown"}`;
+      if (!Object.keys(filters).length || Object.entries(filters).every(([key, value]) => {
+        let itemValue;
+        if (key === "id") {
+          itemValue = item.toProp("id");
+        } else {
+          itemValue = item.toProp(key)?.toValue();
+        }
+        if (Array.isArray(value)) {
+          return value.includes(itemValue);
+        }
+        return itemValue === value;
+      })) {
+        newList.item(itemId, item);
+      }
+    });
+    return newList;
   }
-  /**
-   * Universal tree name getter for unknown/unrecognized GEDCOM sources
-   * Tries to extract a name from various common locations
-   */
-  getUniversalTreeName() {
-    const sourceType = this.getSourceType();
-    const prefix = sourceType ? `${sourceType}-` : "";
-    const fileName = get(this, "HEAD.FILE.value") || get(this.getGedcom(), "HEAD.FILE.value");
-    if (fileName) {
-      const cleanName = fileName.replace(/\.ged$/i, "").replace(/_/g, " ");
-      return `${prefix}${cleanName}`;
-    }
-    const sourName = this.getFromSourceHeads("SOUR.NAME.value") || get(this, "HEAD.SOUR.NAME.value") || get(this.getGedcom(), "HEAD.SOUR.NAME.value");
-    if (sourName) {
-      return `${prefix}${sourName}`;
-    }
-    const sourValue = this.getFromSourceHeads("SOUR.value") || get(this, "HEAD.SOUR.value") || get(this.getGedcom(), "HEAD.SOUR.value");
-    if (sourValue) {
-      return `${prefix}${sourValue}`;
-    }
-    return `${prefix}Unknown Tree`;
+  find(filters, _ClassName = _List) {
+    let foundItem;
+    const isIterator = typeof filters === "function";
+    this.entries().find(([itemId, item], index) => {
+      if (isIterator) {
+        if (filters(item, itemId, index)) {
+          foundItem = item;
+          return true;
+        }
+        return false;
+      }
+      if (!Object.keys(filters).length || Object.entries(filters).every(([key, value]) => {
+        let itemValue;
+        if (key === "id") {
+          itemValue = item.toProp("id");
+        } else {
+          itemValue = item.toProp(key)?.toValue();
+        }
+        if (Array.isArray(value)) {
+          return value.includes(itemValue);
+        }
+        return itemValue === value;
+      })) {
+        foundItem = item;
+        return true;
+      }
+      return false;
+    });
+    return foundItem;
   }
-  getTreeName() {
-    if (this?.isAncestry()) {
-      const name = this.getAncestryTreeName();
-      if (name) return name;
-    }
-    if (this?.isMyHeritage()) {
-      const name = this.getMyHeritageTreeName();
-      if (name) return name;
-    }
-    if (this?.isFamilySearch()) {
-      const name = this.getFamilySearchTreeName();
-      if (name) return name;
-    }
-    if (this?.isGNO2GED()) {
-      const name = this.getGNO2GEDTreeName();
-      if (name) return name;
+  orderBy(orders, ClassName = _List) {
+    const newList = new ClassName();
+    const isIterator = typeof orders === "function";
+    if (!isIterator && (!orders || !Object.keys(orders).length)) {
+      return newList.merge(this);
     }
-    if (this?.isAhnenblatt()) {
-      const name = this.getAhnenblattTreeName();
-      if (name) return name;
+    const sortedItems = this.entries().toSorted(
+      ([itemAId, itemA], [itemBId, itemB]) => {
+        if (isIterator) {
+          return orders(itemA, itemAId, itemB, itemBId);
+        }
+        const [key, { direction, getter }] = Object.entries(
+          typeof orders === "string" ? { [orders]: { direction: "ASC" } } : orders
+        )[0];
+        const rawA = itemA.get(key);
+        const rawB = itemB.get(key);
+        let valueA = rawA?.toValue();
+        let valueB = rawB?.toValue();
+        if (getter && typeof getter === "function") {
+          valueA = getter(valueA, rawA);
+          valueB = getter(valueB, rawB);
+        }
+        let sortValue = 0;
+        if (!valueA && valueA !== 0 && !valueB && valueB !== 0) {
+          sortValue = 0;
+        } else if (!valueB && valueB !== 0) {
+          sortValue = 1;
+        } else if (!valueA && valueA !== 0) {
+          sortValue = -1;
+        } else if (valueA < valueB) {
+          sortValue = -1;
+        } else if (valueA > valueB) {
+          sortValue = 1;
+        }
+        return sortValue * (direction === "DESC" ? -1 : 1);
+      }
+    );
+    sortedItems.forEach(([key, value]) => {
+      newList.item(key, value);
+    });
+    return newList;
+  }
+  groupBy(groups, sort, minOccurance = -1, lessOccuranceLabel = "Appearing less than 5 times", ClassName = _List) {
+    const groupped = {};
+    const isIterator = typeof groups === "function";
+    if (!isIterator && (!groups || !Object.keys(groups).length)) {
+      groupped.Unknown = new ClassName().merge(this);
+      groupped.Unknown.marker = "Unknown";
+      return groupped;
     }
-    if (this?.isGeni()) {
-      const name = this.getGeniTreeName();
-      if (name) return name;
+    this.forEach((item, itemId) => {
+      const group = [];
+      if (isIterator) {
+        const newGroups = groups(item, itemId);
+        group.push(
+          ...Array.isArray(newGroups) ? newGroups : [newGroups]
+        );
+      } else {
+        const [key, { getter }] = Object.entries(
+          typeof groups === "string" ? { [groups]: {} } : groups
+        )[0];
+        const raw = item.get(key)?.index(0);
+        let value = raw?.toValue();
+        if (getter && typeof getter === "function") {
+          value = getter(value, raw);
+        }
+        if (value) {
+          group.push(value);
+        }
+      }
+      if (!group.length) {
+        group.push("Unknown");
+      }
+      group.forEach((g) => {
+        const newGroup = typeof g === "string" ? { group: g } : g;
+        if (!groupped[newGroup.group]) {
+          groupped[newGroup.group] = new ClassName();
+          groupped[newGroup.group].marker = newGroup.marker ?? newGroup.group;
+        }
+        groupped[newGroup.group]?.append(item);
+      });
+    });
+    if (sort) {
+      return Object.entries(groupped).toSorted(([ak, a], [bk, b]) => {
+        if (typeof sort === "function") {
+          return sort(a, ak, b, bk);
+        }
+        if (ak === "Unknown") {
+          return 1;
+        }
+        if (bk === "Unknown") {
+          return -1;
+        }
+        if (sort === "group") {
+          return ak.localeCompare(bk);
+        }
+        return (b?.length ?? 0) - (a?.length ?? 0);
+      }).reduce((acc, [key, value]) => {
+        if (minOccurance > -1 && (value?.length ?? 0) < minOccurance) {
+          const otherKey = lessOccuranceLabel;
+          acc[otherKey] = acc[otherKey] && value ? acc[otherKey].merge(value) : value;
+        } else {
+          acc[key] = value;
+        }
+        return acc;
+      }, {});
     }
-    if (this?.isGenoPro()) {
-      const name = this.getGenoProTreeName();
-      if (name) return name;
+    return groupped;
+  }
+  findIndex(item) {
+    if (!item?.id) {
+      return -1;
     }
-    return this.getUniversalTreeName();
+    return this.keys().findIndex((key) => key === item.id);
+  }
+  getItems() {
+    return this.items;
+  }
+  toJson(tag, options) {
+    const json = this.toObject(tag, options);
+    return JSON.stringify(json);
+  }
+  toObject(tag, options) {
+    const json = {};
+    this.entries().forEach(([_, item]) => {
+      const validTag = getValidTag(tag);
+      if (json[validTag]) {
+        if (!Array.isArray(json[validTag])) {
+          json[validTag] = [json[validTag]];
+        }
+        json[validTag].push(
+          item.toObject(validTag, options)
+        );
+      } else {
+        json[validTag] = item.toObject(
+          validTag,
+          options
+        );
+      }
+    });
+    return json;
+  }
+  toGedcom(tag, level = 0, options) {
+    const gedcom = this.toGedcomLines(tag, level, options);
+    return gedcom.join("\n");
+  }
+  toGedcomLines(tag, level = 0, options) {
+    const gedcom = [];
+    this.entries().forEach(([_, item]) => {
+      const validTag = getValidTag(tag);
+      const xref = item.id;
+      const payload = item.exportValue?.();
+      if (xref) {
+        gedcom.push(
+          `${level} ${xref} ${validTag}${payload ? ` ${payload}` : ""}`
+        );
+      } else {
+        gedcom.push(
+          `${level} ${validTag}${payload ? ` ${payload}` : ""}`
+        );
+      }
+      gedcom.push(
+        ...item.toGedcomLines(
+          validTag,
+          level + 1,
+          options
+        )
+      );
+    });
+    return gedcom;
+  }
+  toValue() {
+    const propList = new _List();
+    this.entries().forEach(([key, item]) => {
+      propList.item(key, item?.toValue());
+    });
+    return propList;
+  }
+  // @deprecated use get instead
+  toProp(tag) {
+    return this.get(tag);
+  }
+  toList() {
+    return new _List().concat(this.items);
+  }
+  toValueList() {
+    const newList = new _List();
+    this.values().forEach((value) => {
+      value.value && newList.item(value.value, value);
+    });
+    return newList;
+  }
+};
+
+// src/utils/get-all-prop.ts
+var getAllProp = (indi, prop) => {
+  return prop && (indi?.get(prop)?.toList().values() ?? []).filter(Boolean) || [];
+};
+
+// src/utils/date-formatter.ts
+var ACCEPTED_DATE_FORMATS = [
+  "yyyy.MM.dd.",
+  "yyyy-MM-dd",
+  "MM/dd/yyyy"
+];
+var ACCEPTED_DATE_FORMATS_REGEX = new RegExp(
+  `(${ACCEPTED_DATE_FORMATS.map(
+    (acceptedFormat) => acceptedFormat.replace(/[^.\-/]/g, "\\d")
+  ).join("|")})`,
+  "gi"
+);
+var firstDate = (date) => {
+  if (!date) return void 0;
+  if (isCommonDate(date)) return date;
+  if (date instanceof List) {
+    return firstDate(
+      date.index(0)
+    );
+  }
+  const node = date;
+  if (typeof node.toValue === "function") {
+    return node;
   }
+  return void 0;
 };
-var createProxy = (target) => {
-  return new Proxy(target, {
-    get(t, prop, receiver) {
-      if (prop === "unwrapped") {
-        return target;
-      }
-      if (prop in t) {
-        return Reflect.get(t, prop, receiver);
-      }
-      if (!isOnlyMainProp(prop)) {
-        const ref = t.ref;
-        if (ref && prop in ref) {
-          return Reflect.get(ref, prop, receiver);
+var dateNote = (date, shortNote = true) => {
+  if (date && typeof date.toNote === "function") {
+    return date.toNote(shortNote) ?? "";
+  }
+  return "";
+};
+var commonDateFormatter = (date, format2 = "yyyy", prefix = "") => {
+  const used = firstDate(date);
+  const formattedDate = used?.toValue(format2);
+  if (!formattedDate) {
+    return void 0;
+  }
+  return `${prefix}${formattedDate}`.trim();
+};
+var noteDateFormatter = (date, format2 = "yyyy", prefix = "", shortNote = true, showNote = true) => {
+  const used = firstDate(date);
+  const rawDate = commonDateFormatter(used, format2, "");
+  if (!rawDate) {
+    return void 0;
+  }
+  const note = dateNote(used, shortNote);
+  return `${prefix}${note && showNote ? i18n.t(`${note} {{date}}`, { date: rawDate }) : rawDate}`;
+};
+var marriageDateFormatter = (fam, showDays = false, showPlaces = false, shortNote = true, showNote = true, showDisplayTextIfNoDate = true, showAllEvents = false, dateFormatPattern) => {
+  const fullDateFormat = i18n.t("dateFormat");
+  const marriageDates = [];
+  const marriagePlaces = [];
+  const marriages = (fam?.toValueList().values() ?? []).flatMap((fam2) => {
+    const family = fam2;
+    const marrEvents = (family?.MARR?.toList().values() ?? []).filter(
+      Boolean
+    );
+    if (marrEvents.length === 0) {
+      const displayText = family?.get("DISPLAYTEXT")?.toValue() ?? "";
+      if (showDisplayTextIfNoDate && displayText) {
+        const displayDate = displayText.match(
+          ACCEPTED_DATE_FORMATS_REGEX
+        )?.[0];
+        if (displayDate) {
+          marriagePlaces.push(displayText.replace(displayDate, ""));
+          const marriageDate = createCommonDate(
+            fam2?.getGedcom(),
+            void 0,
+            family
+          );
+          marriageDate.value = displayDate;
+          marriageDates.push(marriageDate);
+        } else {
+          marriagePlaces.push(displayText);
+          marriageDates.push(void 0);
+          return ["\u221E"];
         }
       }
+      return [];
     }
+    const eventsToProcess = showAllEvents ? marrEvents : marrEvents.slice(0, 1);
+    return eventsToProcess.map((marrEvent) => {
+      const marriageEventDetail = marrEvent;
+      const marriageDate = marriageEventDetail?.DATE;
+      const marriagePlace = showPlaces ? marriageEventDetail?.PLAC?.value : void 0;
+      marriagePlaces.push(marriagePlace);
+      marriageDates.push(marriageDate);
+      const formattedDate = noteDateFormatter(
+        marriageDate,
+        showDays ? fullDateFormat : "yyyy",
+        "\u221E",
+        shortNote,
+        showNote
+      );
+      return formattedDate ? formattedDate : void 0;
+    });
   });
+  const marriageArray = marriages.length ? marriages.filter(Boolean) : [];
+  const datesArray = marriageArray.filter(Boolean);
+  const placesArray = marriagePlaces.filter(Boolean);
+  const dates = datesArray.join(" ").trim();
+  return {
+    rawArray: marriageDates,
+    inArray: datesArray,
+    inOrder: dates,
+    places: placesArray,
+    marriage: marriageArray,
+    ...showPlaces ? {
+      marriages,
+      marriagePlaces
+    } : {}
+  };
 };
-var createCommon = (gedcom, id, main, parent) => {
-  return createProxy(
-    new Common(gedcom, id, main, parent)
+var dateFormatter = (indi, showMarriages = false, showDays = false, showPlaces = false, shortNote = true, showNote = true, isOnStage, showAllEvents = false, dateFormatPattern) => {
+  const fullDateFormat = i18n.t("dateFormat");
+  const birthEvents = getAllProp(indi, "BIRT");
+  const firstBirthValue = birthEvents[0];
+  const deathEvents = getAllProp(indi, "DEAT");
+  const firstDeathValue = deathEvents[0];
+  const birth = commonDateFormatter(
+    firstBirthValue?.DATE,
+    showDays ? fullDateFormat : "yyyy"
   );
-};
-var isOnlyMainProp = (key) => {
-  return key === "_gedcom" || key === "_main" || key === "_parent" || key === "_uniqueId" || key === "_type" || key === "_refs" || key === "id" || key === "_id";
-};
-var isValidKey = (common, key) => {
-  const prop = get(common, key);
-  return key !== "_gedcom" && key !== "_main" && key !== "_parent" && key !== "_uniqueId" && key !== "_refs" && key !== "_type" && !(typeof key === "string" && isGedcomTrailerTag(key)) && (key === "id" || key === "_id" || key === "value" || key === "_value" || prop instanceof Common || prop instanceof List);
-};
-var getValidKeys = (common) => {
-  return Object.keys(common).filter((key) => {
-    return isValidKey(common, key);
+  const birthPlace = showPlaces ? firstBirthValue?.PLAC?.value : void 0;
+  const death = commonDateFormatter(
+    firstDeathValue?.DATE,
+    showDays ? fullDateFormat : "yyyy"
+  );
+  const deathPlace = showPlaces ? firstDeathValue?.PLAC?.value : void 0;
+  const marriagePlaces = [];
+  const marriages = [];
+  if (showMarriages || isOnStage) {
+    (indi?.get("FAMS")?.toValueList().values() ?? []).forEach((fam) => {
+      const famRef = fam?.ref;
+      const marriageDates = marriageDateFormatter(
+        famRef,
+        showDays,
+        showPlaces,
+        shortNote,
+        showNote,
+        true,
+        showAllEvents);
+      marriages.push(...marriageDates?.marriage ?? []);
+      marriagePlaces.push(...marriageDates?.marriagePlaces ?? []);
+    });
+  }
+  const birthStrings = [];
+  const birthPlaces = [];
+  const eventsToProcess = showAllEvents ? birthEvents : birthEvents.slice(0, 1);
+  eventsToProcess.forEach((birthEvent) => {
+    const birthDateNode = firstDate(birthEvent?.DATE);
+    const birthDate = commonDateFormatter(
+      birthDateNode,
+      showDays ? fullDateFormat : "yyyy"
+    );
+    const birthEventNote = dateNote(birthDateNode, shortNote);
+    const birthEventPlace = showPlaces ? birthEvent?.PLAC?.value : void 0;
+    if (birthDate) {
+      birthStrings.push(
+        `*${birthEventNote && showNote ? i18n.t(`${birthEventNote} {{date}}`, {
+          date: birthDate
+        }) : birthDate}`
+      );
+    }
+    birthPlaces.push(birthEventPlace);
   });
+  const deathStrings = [];
+  const deathPlaces = [];
+  const deathEventsToProcess = showAllEvents ? deathEvents : deathEvents.slice(0, 1);
+  deathEventsToProcess.forEach((deathEvent) => {
+    const deathDateNode = firstDate(deathEvent?.DATE);
+    const deathDate = commonDateFormatter(
+      deathDateNode,
+      showDays ? fullDateFormat : "yyyy"
+    );
+    const deathEventNote = dateNote(deathDateNode, shortNote);
+    const deathEventPlace = showPlaces ? deathEvent?.PLAC?.value : void 0;
+    if (deathDate) {
+      deathStrings.push(
+        `\u2020${deathEventNote && showNote ? i18n.t(`${deathEventNote} {{date}}`, {
+          date: deathDate
+        }) : deathDate}`
+      );
+    }
+    deathPlaces.push(deathEventPlace);
+  });
+  const birthString = birthStrings[0] ?? "";
+  const deathString = deathStrings[0] ?? "";
+  const marriageArray = marriages.length ? marriages.filter(Boolean) : [];
+  const datesArray = !birth && !death ? marriageArray : [...birthStrings, ...marriageArray, ...deathStrings];
+  const placesArray = !birth && !death ? marriagePlaces : [...birthPlaces, ...marriagePlaces, ...deathPlaces];
+  const nonNullDatesArray = datesArray.filter(Boolean);
+  const dates = nonNullDatesArray.join(" ").trim();
+  return {
+    inArray: nonNullDatesArray,
+    inOrder: dates,
+    places: placesArray,
+    birth: birthString,
+    marriage: marriageArray,
+    death: deathString,
+    ...showPlaces ? {
+      birthPlace,
+      deathPlace,
+      ...showMarriages ? { marriages, marriagePlaces } : {}
+    } : {},
+    ...showAllEvents ? {
+      births: birthStrings,
+      birthPlaces,
+      deaths: deathStrings,
+      deathPlaces
+    } : {}
+  };
 };
-var getValidTag = (tag) => {
-  return tag.replace(/^@@/, "");
-};
-var getListTag = (tag) => {
-  return `@@${tag}`;
+
+// src/utils/range.ts
+var toTuple = (r) => {
+  if (Array.isArray(r)) {
+    const [s2, e2] = r;
+    return [
+      s2 === void 0 ? void 0 : Number(s2),
+      e2 === void 0 ? void 0 : Number(e2)
+    ];
+  }
+  if (r === "-" || r === "") return [void 0, void 0];
+  const [s, e] = r.split("-");
+  return [s ? Number(s) : void 0, e ? Number(e) : void 0];
 };
-var isId = (string) => {
-  return ID_REG.test(string);
+var isValidRange = (range) => {
+  if (!Array.isArray(range) && range !== "" && range !== "-" && !/^\d*-\d*$/.test(range)) {
+    return false;
+  }
+  if (Array.isArray(range) && range.some((r) => typeof r === "string" && isNaN(Number(r)))) {
+    return false;
+  }
+  return true;
 };
-var idGetter = (id) => {
-  if (id === void 0) {
-    return void 0;
+var inRange = (year, range, trueIfNoYear = false) => {
+  if (!isValidRange(range)) {
+    return false;
   }
-  let newId = `${id}`;
-  const parts = newId?.match(ID_GETTER_REG)?.groups;
-  if (!parts?.at && !parts?.letter) {
-    newId = `@U${newId}`;
-  } else if (!parts.at) {
-    newId = `@${newId}`;
-  } else if (!parts.letter) {
-    newId = newId.replace(/^@/, "@U");
+  if (!year) {
+    return trueIfNoYear;
   }
-  if (!newId.endsWith("@")) {
-    newId = `${newId}@`;
+  const [start = -Infinity, end = Infinity] = toTuple(range);
+  if (!start && !end) {
+    return true;
   }
-  return newId;
+  if (start && !end) {
+    return Number(year) >= Number(start);
+  }
+  if (!start && end) {
+    return Number(year) <= Number(end);
+  }
+  return Number(start) <= Number(year) && Number(year) <= Number(end);
 };
 
 // src/classes/date.ts
@@ -3800,6 +3841,8 @@ var formatDateWithComponents = (date, hasDay, hasMonth, hasYear, noteValue, base
 var CommonDate = class extends Common {
   constructor(gedcom, id, main, parent) {
     super(gedcom, id, main, parent);
+    /** One DATE per event — merge must not turn this into a List. */
+    this.isListable = false;
     delete this.id;
   }
   get calendar() {
@@ -7320,14 +7363,15 @@ var Indi = class extends Common {
     }
     return foundPath;
   }
-  kinship(other, showMainPerson, lang = "en", entirePath, displayName = "givenname") {
+  kinship(other, showMainPerson, lang = "en", entirePath, displayName = "givenname", nameOrder) {
     const KinshipTranslatorClass2 = getKinshipTranslatorClass();
     const translator = new KinshipTranslatorClass2(
       this,
       other,
       lang,
       entirePath,
-      showMainPerson ? displayName : void 0
+      showMainPerson ? displayName : void 0,
+      nameOrder
     );
     return translator.translate(!!showMainPerson);
   }
@@ -8321,7 +8365,7 @@ var KinshipTranslatorDe = class extends KinshipTranslatorBasic {
   }
   of(relation) {
     const formattedName = nameFormatter(this.path?.[0]?.indi, {
-      nameOrder: "first-last"
+      nameOrder: this.nameOrder
     });
     let name = formattedName.inOrder.filter(Boolean).join(" ");
     if (this.displayName === "none") {