gedcom-ts 2.0.2 → 2.1.0

package/dist/import/ReadGed.d.ts

@@ -1,21 +1,64 @@
 import { Person } from '../commons/Person';
 import { SplitGedcom } from "./SplitedInformations";
 import { Place } from "../commons/Place";
+import { type GedcomDatasetVersion } from "../utils/gedcom/datasetVersion";
+/**
+ * Graphe importé depuis un fichier GEDCOM. Les enregistrements de niveau `0` non intégrés au modèle
+ * typé (OBJE, REPO, SOUR, etc.) restent accessibles via {@link preservedTopLevelRecords}.
+ */
 export declare class ReadGed extends SplitGedcom {
+    private resolvedInformationFamilies;
+    private resolvedInformationNotes;
+    private famPointerToId;
+    private notePointerToId;
+    private objePayloadById;
+    /** Déduit du bloc `HEAD` (`GEDC`.`VERS`). */
+    datasetVersion: GedcomDatasetVersion;
     persons: Person[];
     mapPersons: Map<number, Person>;
     partnersMap: Map<number, Person[]>;
     childsMap: Map<number, Person[]>;
     mapFiles: Map<string, File>;
     placesMap: Map<string, Place>;
+    /**
+     * Index des pointeurs d’individu GEDCOM vers {@link Person.INDI} interne.
+     * Clés typiques : `Homer_Simpson` (xref textuelle), `I12` (xref `@I12@`).
+     */
+    private individualPointerToIndiNumber;
     constructor(gedcomContent?: string, mapFiles?: Map<string, File>, placesMap?: Map<string, Place>, mapPersons?: Map<number, Person>);
+    /**
+     * Empty genealogy (no INDI/FAM), same runtime shape as after {@link importGedFile}:
+     * `persons`, `partnersMap`, `childsMap`, `mapPersons`, `placesMap`, `mapFiles` are initialized.
+     */
+    static empty(options?: {
+        mapFiles?: Map<string, File>;
+        placesMap?: Map<string, Place>;
+    }): ReadGed;
     static fromGedcomFile(gedcomFile: File, mapFiles?: Map<string, File>, placesMap?: Map<string, Place>, mapPersons?: Map<number, Person>): Promise<ReadGed>;
     private finalizeAfterParse;
+    /**
+     * Reconstruit {@link partnersMap} et {@link childsMap} à partir des pointeurs `FAMS` / `FAMC`
+     * de chaque personne. Peut être rappelé après édition des liens ; chaque appel remplace les
+     * cartes (pas d’accumulation).
+     */
     groupPartners(): void;
     createDirectAncestries(person: Person): Person[];
     generateUniqueIndi(): number;
+    /**
+     * Résout un pointeur GEDCOM d’individu (`@Homer_Simpson@`, `Homer_Simpson`, `@I5@`, `I5`) vers la personne importée.
+     * Utile pour interpréter `1 CHIL @…@` ou `1 HUSB @…@` dans des fichiers à xref textuelle.
+     */
+    resolveIndividualPointer(raw: string): Person | undefined;
+    /** Enfants rattachés aux unions listées dans `parent.FAMS` (même logique que {@link childsMap}). */
+    getChildrenForParent(parent: Person): Person[];
+    /** Enfants d’une famille donnée (identifiant interne `F`, ex. `0` pour `@F0000@`). */
+    getChildrenOfFamily(familyId: number): Person[];
     private haveParentsOfPerson;
     private createPersons;
+    /**
+     * Xrefs textuelles `0 @Homer_Simpson@ INDI` → entiers uniques (après le max des `@I{n}@` du fichier).
+     */
+    private buildTextualIndiXrefToSyntheticIdMap;
     private buildPerson;
     private hydratePlacesFromActs;
     private upsertPlace;

package/dist/import/SplitedInformations.d.ts

@@ -1,13 +1,39 @@
 export declare class SplitGedcom {
+    /** Lignes du premier enregistrement `0 HEAD` (y compris la ligne `0 HEAD`), si présent. */
+    protected informationHeaderLines: string[] | null;
     protected informationPersons: string[][];
-    protected informationFamilies: Map<number, string[]>;
-    protected informationNotes: Map<number, string[]>;
+    /** Lignes sous `0 @F…@ FAM` indexées par libellé xref canonique (`1`, `famA`, …). */
+    protected informationFamiliesByLabel: Map<string, string[]>;
+    /** Lignes sous `0 @N…@ NOTE|SNOTE` indexées par libellé xref canonique. */
+    protected informationNotesByLabel: Map<string, string[]>;
+    /**
+     * Enregistrements `0 …` non intégrés au modèle typé (OBJE, REPO, SOUR, SUBM, FAM/NOTE à xref non
+     * numérique, etc.). Conservés dans l’ordre du fichier pour diagnostic ou futur re‑export.
+     * `0 TRLR` n’est pas conservé (terminaison standard).
+     */
+    private readonly _preservedTopLevelRecords;
+    get preservedTopLevelRecords(): readonly string[];
     constructor(gedcomContent?: string);
     protected ingestGedcomText(gedcomContent: string): void;
     protected ingestGedcomFileStream(file: File): Promise<void>;
     private ingestRecordBlock;
+    /** N’ajoute pas `0 TRLR` (terminaison du fichier). */
+    private preserveTopLevelRecord;
+    /** Tout enregistrement `0 @xref@ INDI` (xref numérique `@I1@` ou textuelle `@Homer_Simpson@`). */
+    private isIndiRecordFirstLine;
+    /**
+     * Retire de {@link preservedTopLevelRecords} les blocs `0 @O…@ OBJE` décodables et renvoie leurs
+     * charges utiles pour l’hydratation des pointeurs `OBJE` sous `INDI` / actes.
+     */
+    protected absorbStandaloneObjeBlocksInto(): Map<number, {
+        sourceUri: string;
+    }>;
+    private splitInformationHeader;
     private splitInformationPersons;
+    /** @returns `true` si le bloc a été stocké dans {@link informationFamiliesByLabel}. */
     private splitInformationFamilies;
+    /** @returns `true` si le bloc a été stocké dans {@link informationNotesByLabel}. */
     private splitInformationNotes;
-    private extractXrefId;
+    private extractFamRecordLabel;
+    private extractNoteRecordLabel;
 }