@treeviz/gedcom-parser 2.0.10 → 2.1.0

package/dist/kinship-translator/index.js

@@ -1846,6 +1846,11 @@ var inRange = (year, range, trueIfNoYear = false) => {
 // src/constants/constants.ts
 var ID_REG = /^@[_a-zA-Z0-9]+@/;
 var ID_GETTER_REG = /^(?<at>@)?(?<letter>[A-Z])?/i;
+var ORIG_HEAD_TAG = "_ORIGHEAD";
+
+// src/utils/gedcom-trailer.ts
+var GEDCOM_TRAILER_TAG = "TRLR";
+var isGedcomTrailerTag = (tag) => tag === GEDCOM_TRAILER_TAG;
 var List = class _List {
   // length = 0;
   constructor(items) {
@@ -2221,11 +2226,17 @@ var List = class _List {
     const gedcom = [];
     this.entries().forEach(([_, item]) => {
       const validTag = getValidTag(tag);
-      const validKey = item.id;
-      const validValue = validKey ? validTag : item.exportValue();
-      gedcom.push(
-        `${level} ${validKey || validTag}${validValue ? ` ${validValue}` : ""}`
-      );
+      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,
@@ -2356,6 +2367,9 @@ var Common = class _Common {
     delete this._value;
   }
   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;
@@ -2366,6 +2380,9 @@ var Common = class _Common {
     return get(this, name);
   }
   assign(name, value, unique = false) {
+    if (isGedcomTrailerTag(name)) {
+      return void 0;
+    }
     let curValue = this.get(name);
     if (curValue?.isListable) {
       if (curValue instanceof _Common) {
@@ -2477,12 +2494,14 @@ var Common = class _Common {
     );
   }
   standardizeObject(tag, options) {
-    if (tag === "OBJE" && !options?.original && options?.obje?.standardize && options?.obje?.namespace && "standardizeMedia" in this) {
+    if (tag === "OBJE" && options?.obje?.standardize && "standardizeMedia" in this) {
       const standardize = this.standardizeMedia;
       return standardize.call(
         this,
         options.obje.namespace,
-        options.obje.override
+        options.obje.override,
+        void 0,
+        options.gedcomVersion
       );
     }
   }
@@ -2509,7 +2528,7 @@ var Common = class _Common {
         if (typeof prop?.toObject === "function") {
           if (prop instanceof _Common) {
             json[validKey] = prop.toObject(validKey, options);
-          } else {
+          } else if (prop instanceof List) {
             json = {
               ...json,
               ...prop.toObject(validKey, options)
@@ -2567,8 +2586,12 @@ var Common = class _Common {
     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) {
@@ -2579,7 +2602,7 @@ var Common = class _Common {
           gedcom.push(
             ...prop.toGedcomLines(validKey, level + 1, options)
           );
-        } else {
+        } else if (prop instanceof List) {
           gedcom.push(
             ...prop.toGedcomLines(validKey, level, options)
           );
@@ -2588,30 +2611,47 @@ var Common = class _Common {
     });
     return gedcom;
   }
+  getHeadRecord() {
+    return get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+  }
+  getOriginalHeadRecord() {
+    return get(this, ORIG_HEAD_TAG) || get(this.getGedcom(), ORIG_HEAD_TAG) || get(this.getHeadRecord(), ORIG_HEAD_TAG);
+  }
+  getSourceHeads() {
+    const heads = [this.getOriginalHeadRecord(), this.getHeadRecord()];
+    return heads.filter((head, index) => {
+      return Boolean(head && heads.indexOf(head) === index);
+    });
+  }
+  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);
+    });
+  }
   isGenoPro() {
-    const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
-    const sour = get(head, "SOUR.value");
-    return !!sour?.toLowerCase()?.startsWith("genopro");
+    return this.sourStartsWith("genopro");
   }
   isAhnenblatt() {
-    const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
-    const sour = get(head, "SOUR.value");
-    return !!sour?.toLowerCase()?.startsWith("ahnenblatt");
+    return this.sourStartsWith("ahnenblatt");
   }
   isGeni() {
-    const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
-    const sour = get(head, "SOUR.value");
-    return !!sour?.toLowerCase()?.startsWith("geni");
+    return this.sourStartsWith("geni");
   }
   isAncestry() {
-    const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
-    const sour = get(head, "SOUR.value");
-    return !!sour?.toLowerCase()?.startsWith("ancestry");
+    return this.sourStartsWith("ancestry");
   }
   isMyHeritage() {
-    const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
-    const sour = get(head, "SOUR.value");
-    return !!sour?.toLowerCase()?.startsWith("myheritage");
+    return this.sourStartsWith("myheritage");
   }
   /**
    * Get the source type as a string (for prefixing tree IDs and names)
@@ -2628,22 +2668,22 @@ var Common = class _Common {
     return void 0;
   }
   isFamilySearch() {
-    const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
-    const sourName = get(head, "SOUR.NAME.value");
-    return sourName === "FamilySearch API";
+    return this.getSourceHeads().some((head) => {
+      const sourName = get(head, "SOUR.NAME.value");
+      return sourName === "FamilySearch API";
+    });
   }
   isGNO2GED() {
-    const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
-    const sour = get(head, "SOUR.value");
-    return sour === "GNO2GED";
+    return this.getSourceHeads().some((head) => {
+      const sour = get(head, "SOUR.value");
+      return sour === "GNO2GED";
+    });
   }
   getAncestryTreeId() {
-    const path = "HEAD.SOUR._TREE.RIN.value";
-    return get(this, path) || get(this.getGedcom(), path);
+    return this.getFromSourceHeads("SOUR._TREE.RIN.value") || (get(this, "HEAD.SOUR._TREE.RIN.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.RIN.value"));
   }
   getMyHeritageTreeId() {
-    const path = "HEAD._EXPORTED_FROM_SITE_ID.value";
-    return get(this, path) || get(this.getGedcom(), path);
+    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"));
   }
   getTreeId() {
     if (this?.isAncestry()) {
@@ -2677,8 +2717,7 @@ var Common = class _Common {
     return this.getUniversalTreeId();
   }
   getAncestryTreeName() {
-    const path = "HEAD.SOUR._TREE.value";
-    return get(this, path) || get(this.getGedcom(), path);
+    return this.getFromSourceHeads("SOUR._TREE.value") || (get(this, "HEAD.SOUR._TREE.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.value"));
   }
   getMyHeritageTreeName() {
     const path = "HEAD.FILE.value";
@@ -2688,14 +2727,14 @@ var Common = class _Common {
     )?.groups?.tree;
   }
   getFamilySearchTreeId() {
-    const rin = get(this, "HEAD.SOUR._TREE.RIN.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.RIN.value");
+    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";
   }
   getFamilySearchTreeName() {
-    const treeName = get(this, "HEAD.SOUR._TREE.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.value");
+    const treeName = this.getFromSourceHeads("SOUR._TREE.value") || get(this, "HEAD.SOUR._TREE.value") || get(this.getGedcom(), "HEAD.SOUR._TREE.value");
     if (treeName) {
       return treeName;
     }
@@ -2787,11 +2826,11 @@ var Common = class _Common {
       const cleanName = fileName.replace(/\.ged$/i, "").replace(/_/g, " ");
       return `${prefix}${cleanName}`;
     }
-    const sourName = get(this, "HEAD.SOUR.NAME.value") || get(this.getGedcom(), "HEAD.SOUR.NAME.value");
+    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 = get(this, "HEAD.SOUR.value") || get(this.getGedcom(), "HEAD.SOUR.value");
+    const sourValue = this.getFromSourceHeads("SOUR.value") || get(this, "HEAD.SOUR.value") || get(this.getGedcom(), "HEAD.SOUR.value");
     if (sourValue) {
       return `${prefix}${sourValue}`;
     }
@@ -2857,7 +2896,7 @@ var isOnlyMainProp = (key) => {
 };
 var isValidKey = (common, key) => {
   const prop = get(common, key);
-  return key !== "_gedcom" && key !== "_main" && key !== "_parent" && key !== "_uniqueId" && key !== "_refs" && key !== "_type" && (key === "id" || key === "_id" || key === "value" || key === "_value" || prop instanceof Common || prop instanceof List);
+  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) => {
@@ -2904,7 +2943,11 @@ var STANDARD_QUALIFIERS = {
   BEF: "Bef.",
   BEFORE: "Bef.",
   AFT: "Aft.",
-  AFTER: "Aft."
+  AFTER: "Aft.",
+  CAL: "Abt.",
+  // calculated ≈ about for display
+  EST: "Abt."
+  // estimated ≈ about for display
 };
 var EXPORT_QUALIFIERS = {
   "Abt.": "ABT",
@@ -2912,6 +2955,11 @@ var EXPORT_QUALIFIERS = {
   "Aft.": "AFT"
 };
 var GEDCOM_MONTHS = /\b(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\b/g;
+var CALENDAR_PREFIX = /^(?<calendar>GREGORIAN|JULIAN|FRENCH_R|HEBREW)\b\s+/i;
+var isGedcomDateValueForm = (value) => (
+  // Require space/end after the token so display forms like "Abt." are not opaque.
+  /^(FROM|TO|BET|AFT|BEF|ABT|CAL|EST|INT)(\s|$)/i.test(value) || /\bAND\b/i.test(value)
+);
 var NOTE_MARKER = "####";
 var formatDateWithComponents = (date, hasDay, hasMonth, hasYear, noteValue, baseFormat = "dd MMM yyyy", locale) => {
   const hasNote = baseFormat.includes("NOTE");
@@ -2936,29 +2984,45 @@ var CommonDate = class extends Common {
     super(gedcom, id, main, parent);
     delete this.id;
   }
+  get calendar() {
+    return this._calendar;
+  }
   set value(value) {
     if (value) {
-      const noteRegExp = /^(?<note>[a-zA-Z]+\.)/;
-      const noteMatch = value.match(noteRegExp)?.groups;
       let validValue = value;
+      const calendarMatch = validValue.match(CALENDAR_PREFIX);
+      if (calendarMatch?.groups?.calendar) {
+        this._calendar = calendarMatch.groups.calendar.toUpperCase();
+        validValue = validValue.slice(calendarMatch[0].length);
+      } else {
+        this._calendar = void 0;
+      }
+      const noteRegExp = /^(?<note>[a-zA-Z]+\.)/;
+      const noteMatch = validValue.match(noteRegExp)?.groups;
       if (noteMatch?.note) {
         this.NOTE = this.NOTE || createCommon(this._gedcom, void 0, this.main);
         this.NOTE.value = noteMatch?.note;
-        validValue = value.replace(noteRegExp, "");
+        validValue = validValue.replace(noteRegExp, "");
       } else {
-        const qualifierMatch = value.match(
-          /^(?<qualifier>ABT|ABOUT|BEF|BEFORE|AFT|AFTER)\b\s*/i
+        const qualifierMatch = validValue.match(
+          /^(?<qualifier>ABT|ABOUT|BEF|BEFORE|AFT|AFTER|CAL|EST)\b\s*/i
         );
         const qualifier = qualifierMatch?.groups?.qualifier?.toUpperCase();
         const note = qualifier ? STANDARD_QUALIFIERS[qualifier] : void 0;
         if (note) {
           this.NOTE = this.NOTE || createCommon(this._gedcom, void 0, this.main);
           this.NOTE.value = note;
-          validValue = value.slice(qualifierMatch[0].length);
+          validValue = validValue.slice(qualifierMatch[0].length);
         }
       }
       const acceptedDate = this.isValidDateFormat(validValue);
-      if (acceptedDate) {
+      if (isGedcomDateValueForm(validValue.trim())) {
+        delete this.DAY;
+        delete this.MONTH;
+        delete this.YEAR;
+        this._date = void 0;
+        this._value = value;
+      } else if (acceptedDate) {
         this.DAY = this.DAY || createCommon(this._gedcom, void 0, this.main);
         this.DAY.value = format(acceptedDate, "dd");
         this.MONTH = this.MONTH || createCommon(this._gedcom, void 0, this.main);
@@ -3061,6 +3125,15 @@ var CommonDate = class extends Common {
     );
   }
   exportValue() {
+    if (typeof this._value === "string") {
+      const withoutCalendar = this._value.replace(CALENDAR_PREFIX, "");
+      if (isGedcomDateValueForm(withoutCalendar.trim())) {
+        return this._value.replace(
+          /^((?:GREGORIAN|JULIAN|FRENCH_R|HEBREW)\s+)?(FROM|TO|BET|AFT|BEF|ABT|CAL|EST|INT)\b/i,
+          (_m, cal, q) => `${cal || ""}${q.toUpperCase()}`
+        );
+      }
+    }
     const formatted = this.toValue("NOTE dd MMM yyyy", null);
     if (!formatted) {
       return formatted;
@@ -3068,10 +3141,14 @@ var CommonDate = class extends Common {
     const note = this.NOTE?.value?.trim();
     const qualifier = note ? EXPORT_QUALIFIERS[note] : void 0;
     const standardized = qualifier ? formatted.replace(note, qualifier) : formatted;
-    return standardized.replace(
+    const withMonths = standardized.replace(
       GEDCOM_MONTHS,
       (month) => month.toUpperCase()
     );
+    if (this._calendar && this._calendar !== "GREGORIAN") {
+      return `${this._calendar} ${withMonths}`;
+    }
+    return withMonths;
   }
   toGedcomLines(tag, level = 0, options) {
     const internal = new RegExp(
@@ -3532,6 +3609,257 @@ var cacheDiscoveredPath = (gedcom, path) => {
   }
 };
 
+// src/utils/fact-edit.ts
+var SINGLETON_TAGS = /* @__PURE__ */ new Set(["BIRT", "DEAT", "SSN", "SEX", "DSCR"]);
+var firstRecord = (node) => {
+  if (!node) {
+    return void 0;
+  }
+  if (node instanceof List) {
+    return node.index(0);
+  }
+  return node.index(0) ?? node;
+};
+var setDateOn = (gedcom, owner, parent, date) => {
+  const trimmed = date.trim();
+  if (!trimmed) {
+    return;
+  }
+  let dateNode = parent.get("DATE");
+  if (!dateNode || dateNode instanceof List) {
+    dateNode = createCommonDate(gedcom, void 0, owner, parent);
+    dateNode.type = "DATE";
+    parent.set("DATE", dateNode);
+  }
+  dateNode.value = trimmed;
+};
+var fillFact = (gedcom, owner, event, input) => {
+  if (input.value?.trim()) {
+    event.value = input.value.trim();
+  }
+  if (input.type?.trim()) {
+    event.set("TYPE", input.type.trim());
+  }
+  if (input.date) {
+    setDateOn(gedcom, owner, event, input.date);
+  }
+  if (input.place?.trim()) {
+    event.set("PLAC", input.place.trim());
+  }
+  if (input.note?.trim()) {
+    event.set("NOTE", input.note.trim());
+  }
+};
+var addIndividualFact = (indi, input) => {
+  const gedcom = indi.getGedcom();
+  if (!gedcom) {
+    return void 0;
+  }
+  const tag = input.tag;
+  let event = SINGLETON_TAGS.has(tag) ? firstRecord(indi.get(tag)) : void 0;
+  if (!event) {
+    event = createCommon(gedcom, void 0, indi);
+    event.type = tag;
+    if (SINGLETON_TAGS.has(tag)) {
+      indi.set(tag, event);
+    } else {
+      indi.assign(tag, event);
+    }
+  }
+  fillFact(gedcom, indi, event, input);
+  return event;
+};
+var addFamilyFact = (fam, input) => {
+  const gedcom = fam.getGedcom();
+  if (!gedcom) {
+    return void 0;
+  }
+  const event = createCommon(gedcom, void 0, fam);
+  event.type = input.tag;
+  fam.assign(input.tag, event);
+  fillFact(gedcom, fam, event, input);
+  return event;
+};
+var addNonEvent = (owner, input) => {
+  const gedcom = owner.getGedcom();
+  const eventType = input.event?.trim().toUpperCase();
+  if (!gedcom || !eventType) {
+    return void 0;
+  }
+  const no = createCommon(gedcom, void 0, owner);
+  no.type = "NO";
+  no.value = eventType;
+  if (input.date?.trim()) {
+    setDateOn(gedcom, owner, no, input.date);
+  }
+  if (input.note?.trim()) {
+    no.set("NOTE", input.note.trim());
+  }
+  owner.assign("NO", no);
+  return no;
+};
+
+// src/utils/family-edit.ts
+var PEDIGREE_VALUES = [
+  "birth" /* BIRTH */,
+  "adopted" /* ADOPTED */,
+  "foster" /* FOSTER */,
+  "step" /* STEP */,
+  "sealing" /* SEALING */
+];
+var toGedcomPedigree = (value) => {
+  const normalized = String(value || "birth" /* BIRTH */).toLowerCase();
+  if (normalized === "biological" /* BIOLOGICAL */ || normalized === "birth" /* BIRTH */) {
+    return "birth" /* BIRTH */;
+  }
+  const match = PEDIGREE_VALUES.find((item) => item === normalized);
+  return match ?? "birth" /* BIRTH */;
+};
+var pointerIds = (tag) => {
+  if (!tag) {
+    return [];
+  }
+  if (tag instanceof List) {
+    return tag.values().map((item) => item?.toValue?.()).filter((value2) => !!value2);
+  }
+  const value = tag.toValue?.();
+  return value ? [String(value)] : [];
+};
+var firstPointerId = (tag) => pointerIds(tag)[0];
+var makePointer = (gedcom, parent, value, refType) => {
+  const pointer = createCommon(gedcom, void 0, parent);
+  pointer.value = value;
+  pointer.refType = refType;
+  return pointer;
+};
+var familyHasParent = (fam, indiId) => pointerIds(fam.get("HUSB")).includes(indiId) || pointerIds(fam.get("WIFE")).includes(indiId);
+var familyHasChild = (fam, indiId) => pointerIds(fam.get("CHIL")).includes(indiId);
+var spouseTagFor = (indi, fam) => {
+  const husbId = firstPointerId(fam.get("HUSB"));
+  const wifeId = firstPointerId(fam.get("WIFE"));
+  if (husbId === indi.id) {
+    return "HUSB";
+  }
+  if (wifeId === indi.id) {
+    return "WIFE";
+  }
+  if (indi.isFemale()) {
+    return wifeId && wifeId !== indi.id ? "HUSB" : "WIFE";
+  }
+  if (indi.isMale()) {
+    return husbId && husbId !== indi.id ? "WIFE" : "HUSB";
+  }
+  return husbId ? "WIFE" : "HUSB";
+};
+var canAttachAsSpouse = (fam, indi) => {
+  if (!indi.id) {
+    return false;
+  }
+  if (familyHasParent(fam, indi.id)) {
+    return true;
+  }
+  const tag = spouseTagFor(indi, fam);
+  const occupied = firstPointerId(fam.get(tag));
+  return !occupied || occupied === indi.id;
+};
+var pointerByValue = (tag, id) => {
+  if (!tag) {
+    return void 0;
+  }
+  const fromValues = tag.toValueList?.().item(id);
+  if (fromValues) {
+    return fromValues;
+  }
+  return tag.toList()?.values().find((item) => item?.toValue?.() === id);
+};
+var setChildPedigree = (fam, child, pedigree, parent) => {
+  if (!fam.id || !child.id) {
+    return;
+  }
+  const pedi = toGedcomPedigree(pedigree);
+  const famc = pointerByValue(child.get("FAMC"), fam.id);
+  if (famc) {
+    famc.set("PEDI", pedi);
+  }
+  const chil = pointerByValue(fam.get("CHIL"), child.id);
+  if (!chil) {
+    return;
+  }
+  const setFather = !parent || parent.isMale() || parent.isUnknownSex();
+  const setMother = !parent || parent.isFemale() || parent.isUnknownSex();
+  if (setFather) {
+    chil.set("_FREL", pedi);
+  }
+  if (setMother) {
+    chil.set("_MREL", pedi);
+  }
+};
+var attachSpouseToFamily = (fam, indi) => {
+  const gedcom = fam.getGedcom() ?? indi.getGedcom();
+  if (!indi.id || !fam.id || !gedcom) {
+    return false;
+  }
+  if (!canAttachAsSpouse(fam, indi)) {
+    return false;
+  }
+  const tag = spouseTagFor(indi, fam);
+  if (firstPointerId(fam.get(tag)) !== indi.id) {
+    fam.set(tag, makePointer(gedcom, fam, indi.id, "INDI"));
+  }
+  indi.assign("FAMS", makePointer(gedcom, indi, fam.id, "FAM"), true);
+  return true;
+};
+var attachChildToFamily = (fam, child, pedigree, parent) => {
+  const gedcom = fam.getGedcom() ?? child.getGedcom();
+  if (!child.id || !fam.id || !gedcom) {
+    return false;
+  }
+  if (!familyHasChild(fam, child.id)) {
+    fam.assign("CHIL", makePointer(gedcom, fam, child.id, "INDI"), true);
+  }
+  const existingFamc = pointerByValue(child.get("FAMC"), fam.id);
+  if (!existingFamc) {
+    child.assign("FAMC", makePointer(gedcom, child, fam.id, "FAM"), true);
+  }
+  setChildPedigree(fam, child, pedigree, parent);
+  return true;
+};
+var findReusableParentChildFamily = (parent, child) => {
+  if (!parent.id || !child.id) {
+    return void 0;
+  }
+  let reusableFamc;
+  let already = false;
+  child.getFamilies("FAMC")?.forEach((fam) => {
+    if (!fam) {
+      return;
+    }
+    if (familyHasParent(fam, parent.id) && familyHasChild(fam, child.id)) {
+      already = true;
+      return;
+    }
+    if (!reusableFamc && canAttachAsSpouse(fam, parent)) {
+      reusableFamc = fam;
+    }
+  });
+  if (already) {
+    return "already";
+  }
+  if (reusableFamc) {
+    return reusableFamc;
+  }
+  const parentFams = [];
+  parent.getFamilies("FAMS")?.forEach((fam) => {
+    if (fam) {
+      parentFams.push(fam);
+    }
+  });
+  if (parentFams.length === 1) {
+    return parentFams[0];
+  }
+  return void 0;
+};
+
 // src/utils/get-places.ts
 var getPlaces = (common, type = ["ALL" /* All */], maxLevel = 1, level = 0, mainKey) => {
   const types = Array.isArray(type) ? type : [type];
@@ -3596,16 +3924,58 @@ var getPlaces = (common, type = ["ALL" /* All */], maxLevel = 1, level = 0, main
   });
   return places;
 };
+
+// src/utils/local-media.ts
+var localMediaResolver;
+var isRemoteOrEmbeddedMediaUrl = (path) => {
+  if (!path) {
+    return false;
+  }
+  return path.startsWith("data:") || path.startsWith("blob:") || /^https?:\/\//i.test(path);
+};
+var resolveLocalMediaUrl = async (path) => {
+  if (!path) {
+    return void 0;
+  }
+  if (isRemoteOrEmbeddedMediaUrl(path)) {
+    return path;
+  }
+  const resolved = await localMediaResolver?.(path);
+  return resolved;
+};
 var implemented = (type, ...args) => {
 };
 
 // src/utils/media-utils.ts
 var getFileExtension = (filename) => {
-  const match = filename.match(/\.([^.]+)$/);
-  return match ? match[1] : "";
+  if (!filename) {
+    return "";
+  }
+  if (filename.startsWith("data:")) {
+    const mime = filename.slice(5).split(";")[0] || "";
+    const subtype = (mime.split("/")[1] || "").toLowerCase();
+    if (subtype === "jpeg") {
+      return "jpg";
+    }
+    return subtype.split("+")[0] || "";
+  }
+  const withoutQuery = filename.split(/[?#]/)[0] || filename;
+  const match = withoutQuery.match(/\.([^.]+)$/);
+  return match ? match[1].toLowerCase() : "";
 };
 var isImageFormat = (format2) => {
-  if (!format2) return false;
+  if (!format2) {
+    return false;
+  }
+  let normalized = format2.toLowerCase().trim();
+  if (normalized.startsWith("data:")) {
+    normalized = getFileExtension(normalized);
+  } else if (normalized.includes("/")) {
+    normalized = normalized.split("/")[1]?.split("+")[0] || "";
+    if (normalized === "jpeg") {
+      normalized = "jpg";
+    }
+  }
   const imageFormats = [
     "jpg",
     "jpeg",
@@ -3617,7 +3987,11 @@ var isImageFormat = (format2) => {
     "tiff",
     "tif"
   ];
-  return imageFormats.includes(format2.toLowerCase());
+  return imageFormats.includes(normalized);
+};
+var resolveObjeForm = (obje) => {
+  const value = obje?.get?.("FILE.FORM")?.toValue?.() ?? obje?.get?.("FORM")?.toValue?.();
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
 };
 var uniqueItemsCache = /* @__PURE__ */ new WeakMap();
 var setNestedGroup = (obj, key, value, uniqueCounting = true) => {
@@ -4162,6 +4536,34 @@ var Fam = class extends Common {
   getParents() {
     return this.getHusband().copy().merge(this.getWife());
   }
+  hasParent(indi) {
+    const indiId = typeof indi === "string" ? indi : indi?.id;
+    return !!indiId && familyHasParent(this, indiId);
+  }
+  hasChild(indi) {
+    const indiId = typeof indi === "string" ? indi : indi?.id;
+    return !!indiId && familyHasChild(this, indiId);
+  }
+  canAddSpouse(indi) {
+    return canAttachAsSpouse(this, indi);
+  }
+  addSpouse(indi) {
+    return attachSpouseToFamily(this, indi);
+  }
+  addChild(child, pedigree, parent) {
+    return attachChildToFamily(
+      this,
+      child,
+      pedigree,
+      parent
+    );
+  }
+  addFact(input) {
+    return addFamilyFact(this, input);
+  }
+  addNonEvent(input) {
+    return addNonEvent(this, input);
+  }
   toList() {
     return new Families().concat(
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -4262,19 +4664,51 @@ var ALLOWED_FACTS = [
   "OCCU",
   "OCCUPATIONS",
   "RESI",
+  "BIRT",
+  "DEAT",
   "BAPT",
+  "BAPM",
   "CHRI",
   "CHR",
+  "CHRA",
   "BURI",
-  "EDUC",
+  "CREM",
+  "ADOP",
+  "BARM",
+  "BASM",
+  "BLES",
+  "CONF",
+  "FCOM",
+  "ORDN",
+  "NATU",
+  "EMIG",
+  "IMMI",
+  "CENS",
+  "PROB",
+  "WILL",
   "GRAD",
+  "RETI",
+  "EDUC",
   "DIV",
-  "IMMI",
   "RELI",
+  "CAST",
+  "DSCR",
+  "NATI",
+  "PROP",
+  "SSN",
+  "TITL",
+  "ADDR",
+  "BAPL",
+  "CONL",
+  "ENDL",
+  "SLGC",
   "_MILT",
   "_MILTID",
   "FACT",
-  "_ORIG"
+  "_ORIG",
+  "_WLNK",
+  "WWW",
+  "URL"
 ];
 var DISALLOWED_CUSTOM_FACTS = ["DNA Test", "Newspaper"];
 var CustomFactRenderers = {
@@ -4818,7 +5252,7 @@ var Indi = class extends Common {
     return result;
   }
   ancestryLink() {
-    const www = this._gedcom?.HEAD?.SOUR?.CORP?.WWW?.value;
+    const www = this.getFromSourceHeads("SOUR.CORP.WWW.value") || this._gedcom?.HEAD?.SOUR?.CORP?.WWW?.value;
     const tree = this.getAncestryTreeId();
     if (this.id) {
       return `https://${www}/family-tree/person/tree/${tree}/person/${this.id.replace(
@@ -4830,7 +5264,7 @@ var Indi = class extends Common {
   async ancestryMedia(namespace) {
     const list = {};
     const objeList = this.get("OBJE")?.toList().copy();
-    const www = this._gedcom?.HEAD?.SOUR?.CORP?.WWW?.value;
+    const www = this.getFromSourceHeads("SOUR.CORP.WWW.value") || this._gedcom?.HEAD?.SOUR?.CORP?.WWW?.value;
     const tree = this.getAncestryTreeId();
     if (objeList) {
       await Promise.all(
@@ -4848,10 +5282,14 @@ var Indi = class extends Common {
           const clone = obje?.get("_CLON._OID")?.toValue();
           const mser = obje?.get("_MSER._LKID")?.toValue();
           let url = obje?.get("FILE")?.toValue();
-          const title = obje?.get("TITL")?.toValue() ?? "";
-          const type = obje?.get("FORM")?.toValue() ?? "raw";
-          const imgId = clone || mser;
-          if (!www || !tree || !this.id) {
+          const title = obje?.get("FILE.TITL")?.toValue() ?? obje?.get("TITL")?.toValue() ?? "";
+          const type = resolveObjeForm(obje) ?? (url ? getFileExtension(url) : void 0) ?? "raw";
+          let imgId = clone || mser;
+          const hasEmbeddedOrLocalFile = !!url && (url.startsWith("data:") || url.startsWith("blob:") || !/^https?:\/\//i.test(url));
+          if (!hasEmbeddedOrLocalFile && (!www || !tree || !this.id)) {
+            return;
+          }
+          if (!this.id) {
             return;
           }
           if (!namespace && !url) {
@@ -4869,13 +5307,16 @@ var Indi = class extends Common {
             }
             url = url || `https://${www}/mediaui-viewer/tree/${tree}/media/${media}`;
           }
+          if (!imgId && hasEmbeddedOrLocalFile && url) {
+            imgId = typeof media === "string" && media || `local-${String(key).replace(/[@]/g, "")}-${getFileExtension(url) || "bin"}`;
+          }
           if (url && imgId) {
-            const id = `${tree}-${this.id}-${imgId}`;
+            const id = `${tree || "gedzip"}-${this.id}-${imgId}`;
             list[id] = {
               key,
               isPrimary,
               id,
-              tree,
+              tree: tree || "gedzip",
               imgId,
               person: this.id,
               title,
@@ -4890,7 +5331,7 @@ var Indi = class extends Common {
     return list;
   }
   myheritageLink(poolId = 0) {
-    const www = this._gedcom?.HEAD?.SOUR?.CORP?.value?.toLowerCase().replace(/^www\./gi, "");
+    const www = (this.getFromSourceHeads("SOUR.CORP.value") || this._gedcom?.HEAD?.SOUR?.CORP?.value)?.toLowerCase().replace(/^www\./gi, "");
     const site = this.getMyHeritageTreeId();
     const file = this._gedcom?.HEAD?.get("FILE")?.toValue()?.match(/Exported by MyHeritage.com from .+ in (?<site>.+) on .+$/)?.groups?.site;
     const normalizedFile = file?.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-");
@@ -4921,9 +5362,11 @@ var Indi = class extends Common {
       obje.standardizeMedia();
       const isPrimary = obje?.get("_PRIM")?.toValue() === "Y";
       const url = obje?.get("FILE")?.toValue();
-      const title = obje?.get("NOTE")?.toValue() ?? "";
-      const type = obje?.get("FORM")?.toValue() ?? "raw";
-      const imgId = obje?.get("_PHOTO_RIN")?.toValue();
+      const title = obje?.get("FILE.NOTE")?.toValue() ?? obje?.get("NOTE")?.toValue() ?? "";
+      const type = resolveObjeForm(obje) ?? (url ? getFileExtension(url) : void 0) ?? "raw";
+      const photoRin = obje?.get("_PHOTO_RIN")?.toValue();
+      const hasEmbeddedOrLocalFile = !!url && (url.startsWith("data:") || url.startsWith("blob:") || !/^https?:\/\//i.test(url));
+      const imgId = photoRin || (hasEmbeddedOrLocalFile && url ? `local-${String(key).replace(/[@]/g, "")}-${getFileExtension(url) || "bin"}` : void 0);
       if (url && imgId) {
         const id = `${tree}-${this.id}-${imgId}`;
         list[id] = {
@@ -5046,10 +5489,10 @@ var Indi = class extends Common {
       const isPrimary = obje?.get("_PRIM")?.toValue() === "Y";
       const url = obje?.get("FILE")?.toValue();
       const title = obje?.get("TITL")?.toValue() ?? "";
-      const type = obje?.get("FORM")?.toValue() ?? "raw";
+      const type = resolveObjeForm(obje) ?? (url ? getFileExtension(url) : void 0) ?? "raw";
       if (url) {
         const urlMatch = url.match(/\/([^/]+)\?hash=/);
-        const imgId = urlMatch?.[1] || `img-${index}-${Date.now().toString(36)}`;
+        const imgId = urlMatch?.[1] || (url.startsWith("data:") ? `data-${index}-${getFileExtension(url) || "bin"}` : `img-${index}-${Date.now().toString(36)}`);
         const id = `geni-${geniId}-${imgId}`;
         list[id] = {
           isPrimary,
@@ -5086,10 +5529,10 @@ var Indi = class extends Common {
       obje.standardizeMedia();
       const isPrimary = obje?.get("_PRIM")?.toValue() === "Y";
       const url = obje?.get("FILE")?.toValue();
-      const title = obje?.get("TITL")?.toValue() ?? "";
-      const type = obje?.get("FORM")?.toValue() ?? "raw";
+      const title = obje?.get("FILE.TITL")?.toValue() ?? obje?.get("TITL")?.toValue() ?? "";
+      const type = resolveObjeForm(obje) ?? (url ? getFileExtension(url) : void 0) ?? "raw";
       if (url) {
-        const imgId = `media-${index}-${url.split("/").pop()?.split("?")[0]?.substring(0, 20) || Date.now().toString(36)}`;
+        const imgId = `media-${index}-${url.startsWith("data:") ? getFileExtension(url) || "bin" : url.split("/").pop()?.split("?")[0]?.substring(0, 20) || Date.now().toString(36)}`;
         const id = `${treeId}-${this.id}-${imgId}`;
         list[id] = {
           isPrimary,
@@ -5129,7 +5572,20 @@ var Indi = class extends Common {
       cacheKey
     );
     if (cached !== void 0) {
-      return cached;
+      if (cached?.file && !isRemoteOrEmbeddedMediaUrl(cached.file)) {
+        const resolvedCached = await resolveLocalMediaUrl(cached.file);
+        if (resolvedCached && isRemoteOrEmbeddedMediaUrl(resolvedCached)) {
+          const refreshed = { ...cached, file: resolvedCached };
+          profilePictureCache(
+            this._gedcom,
+            cacheKey,
+            refreshed
+          );
+          return refreshed;
+        }
+      } else {
+        return cached;
+      }
     }
     const mediaList = await this.multimedia(namespace);
     if (!mediaList) {
@@ -5141,39 +5597,40 @@ var Indi = class extends Common {
       return void 0;
     }
     const mediaArray = Object.values(mediaList);
-    const primaryMedia = mediaArray.find(
-      (media) => media.isPrimary && isImageFormat(media.contentType || getFileExtension(media.url))
-    );
-    if (primaryMedia) {
-      const result = {
-        file: primaryMedia.url,
-        form: primaryMedia.contentType,
-        title: primaryMedia.title,
-        isPrimary: true
+    const toDisplayableProfile = async (media, isPrimary) => {
+      const resolvedFile = await resolveLocalMediaUrl(media.url);
+      if (!resolvedFile || !isRemoteOrEmbeddedMediaUrl(resolvedFile)) {
+        return void 0;
+      }
+      return {
+        file: resolvedFile,
+        form: media.contentType,
+        title: media.title,
+        isPrimary
       };
-      profilePictureCache(this._gedcom, cacheKey, result);
-      return result;
-    }
-    if (onlyPrimary) {
-      profilePictureCache(
-        this._gedcom,
-        cacheKey,
-        void 0
-      );
-      return void 0;
-    }
-    const secondaryMedia = mediaArray.find(
-      (media) => isImageFormat(media.contentType || getFileExtension(media.url))
+    };
+    const candidates = mediaArray.filter(
+      (media) => isImageFormat(
+        media.contentType || media.url || getFileExtension(media.url)
+      )
     );
-    if (secondaryMedia) {
-      const result = {
-        file: secondaryMedia.url,
-        form: secondaryMedia.contentType,
-        title: secondaryMedia.title,
-        isPrimary: false
-      };
-      profilePictureCache(this._gedcom, cacheKey, result);
-      return result;
+    const ordered = [
+      ...candidates.filter((media) => media.isPrimary),
+      ...candidates.filter((media) => !media.isPrimary)
+    ];
+    for (const media of ordered) {
+      if (onlyPrimary && !media.isPrimary) {
+        break;
+      }
+      const result = await toDisplayableProfile(media, !!media.isPrimary);
+      if (result) {
+        profilePictureCache(
+          this._gedcom,
+          cacheKey,
+          result
+        );
+        return result;
+      }
     }
     profilePictureCache(
       this._gedcom,
@@ -5411,6 +5868,156 @@ var Indi = class extends Common {
   isUnknownSex() {
     return !this.isMale() && !this.isFemale();
   }
+  addSpouse(other) {
+    if (!this.id || !other?.id || this.id === other.id || !this._gedcom) {
+      return void 0;
+    }
+    const existing = getFamilyWith(this, other.id);
+    if (existing) {
+      return existing;
+    }
+    const fam = this._gedcom.createFamily();
+    if (!fam.addSpouse(this) || !fam.addSpouse(other)) {
+      return void 0;
+    }
+    return fam;
+  }
+  addChild(child, pedigree) {
+    if (!this.id || !child?.id || this.id === child.id || !this._gedcom) {
+      return void 0;
+    }
+    const existing = findReusableParentChildFamily(
+      this,
+      child
+    );
+    if (existing === "already") {
+      const fam2 = child.getFamilies("FAMC")?.find(
+        (item) => !!item && item.hasParent(this.id) && item.hasChild(child.id)
+      );
+      if (fam2) {
+        setChildPedigree(
+          fam2,
+          child,
+          pedigree,
+          this
+        );
+      }
+      return fam2;
+    }
+    const fam = existing ?? this._gedcom.createFamily();
+    if (!fam.addSpouse(this)) {
+      return void 0;
+    }
+    if (!fam.addChild(child, pedigree, this)) {
+      return void 0;
+    }
+    return fam;
+  }
+  addParent(parent, pedigree) {
+    return parent.addChild(this, pedigree);
+  }
+  /**
+   * Link an existing top-level OBJE record to this individual (`1 OBJE @On@`).
+   */
+  attachMultimedia(objeOrKey, options) {
+    if (!this._gedcom || !this.id) {
+      return void 0;
+    }
+    const obje = typeof objeOrKey === "string" ? this._gedcom.obje(objeOrKey) : objeOrKey;
+    if (!obje?.id) {
+      return void 0;
+    }
+    const already = this.get("OBJE")?.toList()?.values()?.some((item) => item?.toValue?.() === obje.id);
+    if (!already) {
+      const pointer = makePointer(
+        this._gedcom,
+        this,
+        obje.id,
+        "OBJE"
+      );
+      this.assign("OBJE", pointer);
+    }
+    if (options?.primary) {
+      this.get("OBJE")?.toList()?.forEach((item) => {
+        const target = item?.refType === "OBJE" ? this._gedcom?.obje(
+          String(item.toValue())
+        ) : item;
+        if (!target) {
+          return;
+        }
+        if (target.id === obje.id) {
+          target.set("_PRIM", "Y");
+        } else if (target.get("_PRIM")?.toValue() === "Y") {
+          target.set("_PRIM", "N");
+        }
+      });
+      obje.set("_PRIM", "Y");
+    }
+    return obje;
+  }
+  detachMultimedia(objeKey) {
+    const list = this.get("OBJE")?.toList();
+    if (!list) {
+      return;
+    }
+    const toRemove = list.values().filter(
+      (item) => item?.toValue?.() === objeKey || item?.id === objeKey
+    );
+    toRemove.forEach((item) => {
+      if (item) {
+        list.delete(item);
+      }
+    });
+    if (list.length === 0) {
+      this.remove("OBJE");
+    }
+  }
+  /**
+   * Create a multimedia record and attach it to this person.
+   */
+  attachMediaFromUrl(url, options) {
+    if (!this._gedcom || !url) {
+      return void 0;
+    }
+    const obje = this._gedcom.createMultimediaRecord({
+      file: url,
+      form: options?.form,
+      title: options?.title,
+      mediType: options?.mediType,
+      primary: options?.primary,
+      gedcomVersion: options?.gedcomVersion
+    });
+    return this.attachMultimedia(obje, { primary: options?.primary });
+  }
+  /**
+   * Link a shared SNOTE record via `1 NOTE @Nn@` (GEDCOM 7).
+   */
+  attachSharedNote(noteOrKey) {
+    if (!this._gedcom || !this.id) {
+      return void 0;
+    }
+    const note = typeof noteOrKey === "string" ? this._gedcom.snote(noteOrKey) : noteOrKey;
+    if (!note?.id) {
+      return void 0;
+    }
+    const already = this.get("NOTE")?.toList()?.values()?.some((item) => item?.toValue?.() === note.id);
+    if (!already) {
+      const pointer = makePointer(
+        this._gedcom,
+        this,
+        note.id,
+        "SNOTE"
+      );
+      this.assign("NOTE", pointer);
+    }
+    return note;
+  }
+  addFact(input) {
+    return addIndividualFact(this, input);
+  }
+  addNonEvent(input) {
+    return addNonEvent(this, input);
+  }
   getParentType(id) {
     let indi;
     if (typeof id === "string" || typeof id === "number") {
@@ -5451,7 +6058,7 @@ var Indi = class extends Common {
       if (!famChild) {
         const childIndi = this._gedcom?.indi(child.id);
         const childState = childIndi?.get("FAMC")?.toList()?.filter((item) => item.value === family.id).index(0);
-        childType = childState?.get("PEDI")?.toValue() || "biological" /* BIOLOGICAL */;
+        childType = (childState?.get("PEDI") ?? childState?.get("PEDT"))?.toValue() || "biological" /* BIOLOGICAL */;
       } else {
         childType = famChild.get(usedRel)?.toValue() || "biological" /* BIOLOGICAL */;
       }
@@ -5611,7 +6218,9 @@ var Indi = class extends Common {
           }
         }
         if (kinship !== "child" || !breakAfterSpouse) {
-          indi.getBiologicalFathers().copy().merge(indi.getBiologicalMothers()).merge(indi.getFathers().copy().merge(indi.getMothers())).forEach((relative) => {
+          indi.getBiologicalFathers().copy().merge(indi.getBiologicalMothers()).merge(
+            indi.getFathers().copy().merge(indi.getMothers())
+          ).forEach((relative) => {
             if (!visited.has(relative)) {
               const currentRelation = indi.getParentType(relative);
               const isNonBiological = !!currentRelation && currentRelation !== "biological" /* BIOLOGICAL */;
@@ -6010,7 +6619,7 @@ var Indi = class extends Common {
             return;
           }
           const childState = child?.get("FAMC")?.toList()?.filter((item) => item.value === family.id).index(0);
-          const childType = childState?.get("PEDI")?.toValue() || "biological" /* BIOLOGICAL */;
+          const childType = (childState?.get("PEDI") ?? childState?.get("PEDT"))?.toValue() || "biological" /* BIOLOGICAL */;
           if (childType?.toLowerCase() === filter.PEDI.toLowerCase()) {
             children.append(child);
           }
@@ -6118,7 +6727,7 @@ var Indi = class extends Common {
       const child = this.id && family.CHIL?.toValueList()?.item(this.id);
       if (!child) {
         const childState = this?.get("FAMC")?.toList()?.filter((item) => item.value === family.id).index(0);
-        const parentType = childState?.get("PEDI")?.toValue() || "biological" /* BIOLOGICAL */;
+        const parentType = (childState?.get("PEDI") ?? childState?.get("PEDT"))?.toValue() || "biological" /* BIOLOGICAL */;
         if (parentType?.toLowerCase() === filter.PEDI.toLowerCase()) {
           parents.merge(family.getParents());
         }