gedcom-ts 2.0.1 → 2.1.0

package/dist/commons/Act.d.ts

@@ -1,20 +1,46 @@
 import { DateAct } from "./DateAct";
 import { Place } from "./Place";
-import { Identificator } from "./Identificator.enum";
+import { GEDCOM_7_ALL_EVENT_TAGS } from "./gedcomEventTags";
 import { MultimediaFile, MultimediaFiles } from "./MultimediaFile";
 import { Notes } from "./Note";
-export type TypeAct = Identificator.BIRT | Identificator.DEAT | Identificator.MARR;
+export type TypeAct = (typeof GEDCOM_7_ALL_EVENT_TAGS)[number];
+export type ActConstructionOptions = {
+    /** GEDCOM 7 `1 EVEN` text payload (only used when `type` is `EVEN`). */
+    evenDescription?: string | null;
+    /** GEDCOM 7 required `2 TYPE` under `EVEN` (individual or family). */
+    evenTypeLabel?: string | null;
+    /** GEDCOM 7 `2 SDATE` (+ `3 TIME` / `3 PHRASE` importés comme pour `DATE`). */
+    sdateAct?: DateAct | null;
+    /** GEDCOM 7 `2 PHRASE` directement sous l’événement. */
+    eventPhrases?: readonly string[] | null;
+    /** Sous-lignes non modélisées avant la première balise d’ancrage (`DATE`, `PLAC`, …). */
+    preservedSubrecordPrefix?: readonly string[] | null;
+    /** Sous-lignes non modélisées après la première balise d’ancrage. */
+    preservedSubrecordSuffix?: readonly string[] | null;
+};
 export declare class Act {
     type: TypeAct;
     dateAct?: DateAct | null;
     place: Place | null;
     INDIS: number[];
+    evenDescription?: string | null;
+    evenTypeLabel?: string | null;
+    /** GEDCOM 7 `2 SDATE` (sous-structure analogue à `DATE`). */
+    sdateAct?: DateAct | null;
+    /** GEDCOM 7 `2 PHRASE` au niveau 2 sous l’événement. */
+    eventPhrases: string[];
+    /**
+     * Sous-lignes d’événement non modélisées (ex. `2 HUSB`, `4 PHRASE` sous `AGE`, `3 DATE` sous `STAT`, …),
+     * conservées pour limiter la perte à l’import / export.
+     */
+    preservedSubrecordPrefix: string[];
+    preservedSubrecordSuffix: string[];
     private newMultimediaFiles;
     multimediaFiles: MultimediaFiles;
     notes: Notes;
     get files(): MultimediaFile[];
     get keysFiles(): string[];
-    constructor(type: TypeAct, dateAct?: DateAct | null, place?: Place | null, indis?: number[] | null, multimediaFiles?: MultimediaFiles | null, newMultimediaFiles?: Map<string, MultimediaFile>, notes?: Notes);
+    constructor(type: TypeAct, dateAct?: DateAct | null, place?: Place | null, indis?: number[] | null, multimediaFiles?: MultimediaFiles | null, newMultimediaFiles?: Map<string, MultimediaFile>, notes?: Notes, options?: ActConstructionOptions | null);
     /**
      * Média rattaché à l’acte : `{indi}/{type}/{nomFichier}` (indi = premier INDI connu ou paramètre).
      * Suffixe `_1`, `_2`, … avant l’extension si le chemin est déjà pris sur cet acte.
@@ -24,8 +50,10 @@ export declare class Act {
     private mediaRelativePathsInUse;
     updateType(typeAct: TypeAct): void;
     addIndis(INDIS: number[]): void;
-    updatePlace(place: Place): void;
-    updateDateAct(dateAct: DateAct): void;
+    updatePlace(place: Place | null): void;
+    updateDateAct(dateAct: DateAct | null): void;
+    /** Remplace ou efface la date de tri `SDATE`. */
+    updateSdateAct(sdateAct: DateAct | null): void;
 }
 export declare class Acts {
     list: Act[];
@@ -34,8 +62,17 @@ export declare class Acts {
     removeFromIndex(indexAct: number): void;
     removeAll(): void;
     sortByDate(): void;
+    /** Date utilisée pour le tri : `DATE` si exploitable, sinon `SDATE`. */
+    private sortDateAct;
+    private hasSortableDate;
+    private compareByTypeOrder;
+    private compareMarriageAndDivorce;
+    private haveSameParticipants;
 }
 export declare class ActsByExtraction extends Acts {
-    extractActsInfo(lines: string[], INDIS: number[], mapFiles: Map<string, File>): void;
+    extractActsInfo(lines: string[], INDIS: number[], mapFiles: Map<string, File>, objePayloadById?: ReadonlyMap<number, {
+        sourceUri: string;
+    }>, textualIndiXrefToIndi?: ReadonlyMap<string, number>): void;
     private convertToActs;
+    private resolveTypeAct;
 }

package/dist/commons/DateAct.d.ts

@@ -1,8 +1,19 @@
 export declare enum TypeDateAct {
     BEF = "BEF",
     ABT = "ABT",
+    AFT = "AFT",
+    /** GEDCOM 5.5 / interop : date interprétée. */
+    INT = "INT",
+    /** Estimée. */
+    EST = "EST",
+    /** Calculée. */
+    CAL = "CAL",
+    BET = "BET",
+    FROM = "FROM",
     NULL = "NULL"
 }
+/** Qualificateur de date simple (hors BET/FROM). */
+export type TypeDateActSimpleQualifier = TypeDateAct.BEF | TypeDateAct.ABT | TypeDateAct.AFT | TypeDateAct.INT | TypeDateAct.EST | TypeDateAct.CAL;
 export declare enum MonthEnum {
     JAN = "JAN",
     FEB = "FEB",
@@ -26,9 +37,73 @@ export declare class DateAct {
     day?: Day;
     month?: Month;
     year?: number;
+    endDay?: Day;
+    endMonth?: Month;
+    endYear?: number;
+    /**
+     * Texte libre lié à la date : `3 PHRASE` sous `DATE` à l’import, ou fragment final `(...)` hérité 5.5.
+     */
+    datePhrase?: string | null;
+    /** `3 TIME` sous `DATE` / `SDATE` (GEDCOM 7). */
+    dateTime?: string | null;
+    /**
+     * Charge `DATE`/`SDATE` non résolvable en champs typés (URI GEDCOM 7, texte libre, combos exotiques) :
+     * conservée telle quelle pour l’export tant qu’aucune date structurée exploitable n’est présente.
+     */
+    verbatimDatePayload?: string | null;
     constructor(dateLine: string);
+    private applyVerbatimFallback;
+    /** Indique si l’on dispose d’une date structurée exportable (hors seul verbatim). */
+    private hasStructuredDateForExport;
     get date(): string | null;
+    /** Sous-ligne `3 TIME` (import GEDCOM 7). */
+    setDateTimeFromImport(fragment: string): void;
+    updateExactDate(year?: number, month?: Month, day?: Day): void;
+    /** Ajoute du texte issu d’un `3 PHRASE` sous `DATE` (import GEDCOM 7). */
+    appendDatePhraseFromImport(fragment: string): void;
+    updateQualifiedDate(typeDateAct: TypeDateActSimpleQualifier, year?: number, month?: Month, day?: Day): void;
+    updateBetweenDates(start: {
+        year: number;
+        month?: Month;
+        day?: Day;
+    }, end: {
+        year: number;
+        month?: Month;
+        day?: Day;
+    }): void;
+    updateFromToDates(start: {
+        year: number;
+        month?: Month;
+        day?: Day;
+    }, end: {
+        year: number;
+        month?: Month;
+        day?: Day;
+    }): void;
+    clearDate(): void;
+    /**
+     * Remplace l’état de cette instance par le résultat du parseur sur une charge `DATE` / `SDATE` GEDCOM
+     * (même logique que le constructeur), sans changer la référence d’objet — utile pour l’édition in-place.
+     */
+    applyGedcomDatePayload(dateLine: string): void;
+    private tryParseIsoYmd;
+    /** ISO `YYYY-MM` (GEDCOM 7 : précision au mois). */
+    private tryParseIsoYm;
+    /** Extrait une note finale `(...)` (style 5.5) du reste de la charge date. */
+    private static extractInlineParentheticalPhrase;
     private convertMonth;
+    private parseSinglePart;
+    private parseTwoParts;
+    private parseThreeParts;
+    private parseFourParts;
+    private tryConsumeMonthYearSlash;
+    private parseMonthToken;
+    private formatCoreDate;
+    private tryParseRangeDate;
+    private parseCoreDateValue;
+    private isRelativeType;
+    /** Retire les préfixes de calendrier GEDCOM (`@#DGREGORIAN@`, … — forme `@#NAME@`). */
+    private stripCalendarPrefixes;
     isValid(): boolean;
 }
 export declare const dateToDateLine: (year?: number, month?: Month, day?: Day) => string;

package/dist/commons/Identificator.enum.d.ts

@@ -1,131 +1,5 @@
-export declare enum Identificator {
-    ABBR = "ABBR",
-    ADDR = "ADDR",
-    ADR1 = "ADDR1",
-    ADR2 = "ADDR2",
-    ADOP = "ADOP",
-    AFN = "AFN",
-    AGE = "AGE",
-    AGNC = "AGNC",
-    ALIA = "ALIA",
-    ANCE = "ANCE",
-    ANCI = "ANCI",
-    ANUL = "ANUL",
-    ASSO = "ASSO",
-    AUTH = "AUTH",
-    BAPL = "BAPL",
-    BAPM = "BAPM",
-    BARM = "BARM",
-    BASM = "BASM",
-    BIRT = "BIRT",
-    BLES = "BLES",
-    BLOB = "BLOB",
-    BURI = "BURI",
-    CALN = "CALN",
-    CAST = "CAST",
-    CAUS = "CAUS",
-    CENS = "CENS",
-    CHAN = "CHAN",
-    CHAR = "CHAR",
-    CHIL = "CHIL",
-    CHR = "CHR",
-    CHRA = "CHRA",
-    CITY = "CITY",
-    CONC = "CONC",
-    CONF = "CONF",
-    CONL = "CONL",
-    CONT = "CONT",
-    COPR = "COPR",
-    CORP = "CORP",
-    CREM = "CREM",
-    CTRY = "CTRY",
-    DATA = "DATA",
-    DATE = "DATE",
-    DEAT = "DEAT",
-    DESC = "DESC",
-    DESI = "DESI",
-    DEST = "DEST",
-    DIV = "DIV",
-    DIVF = "DIVF",
-    DSCR = "DSCR",
-    EDUC = "EDUC",
-    EMIG = "EMIG",
-    ENDL = "ENDL",
-    ENGA = "ENGA",
-    EVEN = "EVEN",
-    FAM = "FAM",
-    FAMC = "FAMC",
-    FAMF = "FAMF",
-    FAMS = "FAMS",
-    FCOM = "FCOM",
-    FILE = "FILE",
-    FORM = "FORM",
-    GEDC = "GEDC",
-    GIVN = "GIVN",
-    GRAD = "GRAD",
-    HEAD = "HEAD",
-    HUSB = "HUSB",
-    IDNO = "IDNO",
-    IMMI = "IMMI",
-    INDI = "INDI",
-    LANG = "LANG",
-    LEGA = "LEGA",
-    MARB = "MARB",
-    MARC = "MARC",
-    MARL = "MARL",
-    MARR = "MARR",
-    MARS = "MARS",
-    MEDI = "MEDI",
-    NAME = "NAME",
-    NATI = "NATI",
-    NATU = "NATU",
-    NCHI = "NCHI",
-    NICK = "NICK",
-    NMR = "NMR",
-    NOTE = "NOTE",
-    NPFX = "NPFX",
-    NSFX = "NSFX",
-    OBJE = "OBJE",
-    OCCU = "OCCU",
-    ORDI = "ORDI",
-    ORDN = "ORDN",
-    PAGE = "PAGE",
-    PEDI = "PEDI",
-    PHON = "PHON",
-    PLAC = "PLAC",
-    POST = "POST",
-    PROB = "PROB",
-    PROP = "PROP",
-    PUBL = "PUBL",
-    QUAY = "QUAY",
-    REFN = "REFN",
-    RELA = "RELA",
-    RELI = "RELI",
-    REPO = "REPO",
-    RESI = "RESI",
-    RESN = "RESN",
-    RETI = "RETI",
-    RFN = "RFN",
-    RIN = "RIN",
-    ROLE = "ROLE",
-    SEX = "SEX",
-    SLGC = "SLGC",
-    SLGS = "SLGS",
-    SOUR = "SOUR",
-    SPFX = "SPFX",
-    SSN = "SSN",
-    STAE = "STAE",
-    STAT = "STAT",
-    SUBM = "SUBM",
-    SUBN = "SUBN",
-    SURN = "SURN",
-    TEMP = "TEMP",
-    TEXT = "TEXT",
-    TIME = "TIME",
-    TITL = "TITL",
-    TRLR = "TRLR",
-    TYPE = "TYPE",
-    VERS = "VERS",
-    WIFE = "WIFE",
-    WILL = "WILL"
-}
+import { Identifier } from "./Identifier.enum";
+/**
+ * @deprecated Use `Identifier` instead.
+ */
+export declare const Identificator: typeof Identifier;

package/dist/commons/Identifier.enum.d.ts

@@ -0,0 +1,134 @@
+export declare enum Identifier {
+    ABBR = "ABBR",
+    ADDR = "ADDR",
+    ADR1 = "ADR1",
+    ADR2 = "ADR2",
+    ADOP = "ADOP",
+    AFN = "AFN",
+    AGE = "AGE",
+    AGNC = "AGNC",
+    ALIA = "ALIA",
+    ANCE = "ANCE",
+    ANCI = "ANCI",
+    ANUL = "ANUL",
+    ASSO = "ASSO",
+    AUTH = "AUTH",
+    BAPL = "BAPL",
+    BAPM = "BAPM",
+    BARM = "BARM",
+    BASM = "BASM",
+    BIRT = "BIRT",
+    BLES = "BLES",
+    BLOB = "BLOB",
+    BURI = "BURI",
+    CALN = "CALN",
+    CAST = "CAST",
+    CAUS = "CAUS",
+    CENS = "CENS",
+    CHAN = "CHAN",
+    CHAR = "CHAR",
+    CHIL = "CHIL",
+    CHR = "CHR",
+    CHRA = "CHRA",
+    CITY = "CITY",
+    CONC = "CONC",
+    CONF = "CONF",
+    CONL = "CONL",
+    CONT = "CONT",
+    COPR = "COPR",
+    CORP = "CORP",
+    CREM = "CREM",
+    CTRY = "CTRY",
+    DATA = "DATA",
+    DATE = "DATE",
+    DEAT = "DEAT",
+    DESC = "DESC",
+    DESI = "DESI",
+    DEST = "DEST",
+    DIV = "DIV",
+    DIVF = "DIVF",
+    DSCR = "DSCR",
+    EDUC = "EDUC",
+    EMIG = "EMIG",
+    ENDL = "ENDL",
+    ENGA = "ENGA",
+    EVEN = "EVEN",
+    FAM = "FAM",
+    FAMC = "FAMC",
+    FAMF = "FAMF",
+    FAMS = "FAMS",
+    FCOM = "FCOM",
+    FACT = "FACT",
+    FILE = "FILE",
+    FORM = "FORM",
+    GEDC = "GEDC",
+    GIVN = "GIVN",
+    GRAD = "GRAD",
+    HEAD = "HEAD",
+    HUSB = "HUSB",
+    IDNO = "IDNO",
+    IMMI = "IMMI",
+    INDI = "INDI",
+    LANG = "LANG",
+    LEGA = "LEGA",
+    MARB = "MARB",
+    MARC = "MARC",
+    MARL = "MARL",
+    MARR = "MARR",
+    MARS = "MARS",
+    MEDI = "MEDI",
+    NAME = "NAME",
+    NATI = "NATI",
+    NATU = "NATU",
+    NCHI = "NCHI",
+    NICK = "NICK",
+    NMR = "NMR",
+    NOTE = "NOTE",
+    NPFX = "NPFX",
+    NSFX = "NSFX",
+    OBJE = "OBJE",
+    OCCU = "OCCU",
+    ORDI = "ORDI",
+    ORDN = "ORDN",
+    PAGE = "PAGE",
+    PEDI = "PEDI",
+    PHON = "PHON",
+    PHRASE = "PHRASE",
+    PLAC = "PLAC",
+    POST = "POST",
+    PROB = "PROB",
+    PROP = "PROP",
+    PUBL = "PUBL",
+    QUAY = "QUAY",
+    REFN = "REFN",
+    RELA = "RELA",
+    RELI = "RELI",
+    REPO = "REPO",
+    RESI = "RESI",
+    RESN = "RESN",
+    RETI = "RETI",
+    RFN = "RFN",
+    RIN = "RIN",
+    ROLE = "ROLE",
+    SEX = "SEX",
+    SLGC = "SLGC",
+    SLGS = "SLGS",
+    SOUR = "SOUR",
+    SPFX = "SPFX",
+    SSN = "SSN",
+    SDATE = "SDATE",
+    STAE = "STAE",
+    STAT = "STAT",
+    SUBM = "SUBM",
+    SUBN = "SUBN",
+    SURN = "SURN",
+    TEMP = "TEMP",
+    TEXT = "TEXT",
+    TIME = "TIME",
+    TITL = "TITL",
+    TRLR = "TRLR",
+    TYPE = "TYPE",
+    VERS = "VERS",
+    WIFE = "WIFE",
+    WILL = "WILL"
+}

package/dist/commons/IndiAttribute.d.ts

@@ -0,0 +1,11 @@
+import type { IndiGedcomSubLine } from "./IndiGedcomSubLine";
+/**
+ * Attribut individuel de niveau 1 (`FACT`, `DSCR`, `CAST`, …) avec sous-structures conservées.
+ */
+export declare class IndiAttribute {
+    tag: string;
+    value: string;
+    children: IndiGedcomSubLine[];
+    constructor(tag: string, value: string, children?: IndiGedcomSubLine[]);
+    toGedcom(lineEnding: string): string;
+}

package/dist/commons/IndiGedcomSubLine.d.ts

@@ -0,0 +1,6 @@
+/** Sous-structure sous un `1 NAME` (niveau ≥ 2) ou sous un attribut individuel (niveau ≥ 2). */
+export type IndiGedcomSubLine = {
+    level: string;
+    tag: string;
+    value: string;
+};

package/dist/commons/MultimediaFile.d.ts

@@ -1,8 +1,19 @@
 export declare class MultimediaFile {
     relativePath: string;
-    file: File;
-    constructor(file?: File);
+    /** Fichier local ; peut être absent si seulement {@link sourceUri} ou {@link objeXrefId}. */
+    file?: File;
+    /**
+     * URI ou chemin pour `FILE` en GEDCOM 7 sans binaire embarqué (export `.ged`, média hors zip).
+     */
+    sourceUri?: string | null;
+    /**
+     * Référence `OBJE` (`@O{n}@`) : exporte `1 OBJE` / `2 OBJE` + enregistrement `0 @O{n}@ OBJE` si {@link sourceUri} est défini.
+     */
+    objeXrefId?: number | null;
+    constructor(file?: File, sourceUri?: string | null, objeXrefId?: number | null);
     get filename(): string;
+    /** Peut être sérialisé en GEDCOM (fichier local, URI, ou pointeur OBJE). */
+    hasExportablePayload(): boolean;
 }
 export declare class MultimediaFiles {
     /** Répertoire logique (sans slash final), ex. `1` ou `1/BIRT`. */

package/dist/commons/Note.d.ts

@@ -1,5 +1,5 @@
-import { Identificator } from "./Identificator.enum";
-export type TypeNote = Identificator.CONC | Identificator.CONT | undefined;
+import { Identifier } from "./Identifier.enum";
+export type TypeNote = Identifier.CONC | Identifier.CONT | undefined;
 export declare class Note {
     INDIS: number[];
     type: TypeNote;

package/dist/commons/Person.d.ts

@@ -1,10 +1,23 @@
 import { Acts } from './Act';
+import { IndiAttribute } from "./IndiAttribute";
 import { MultimediaFile, MultimediaFiles } from "./MultimediaFile";
 import { Notes } from "./Note";
+import { PersonNameVariant } from "./PersonNameVariant";
 export declare enum Sex {
     M = "M",
-    F = "F"
+    F = "F",
+    /** GEDCOM 7 « sexe inconnu ». */
+    U = "U",
+    /** GEDCOM 7 « non binaire » / intersexe selon fichier source. */
+    X = "X"
 }
+export type PersonGedcomImportOptions = {
+    famPointerToId?: ReadonlyMap<string, number>;
+    notePointerToId?: ReadonlyMap<string, number>;
+    objePayloadById?: ReadonlyMap<number, {
+        sourceUri: string;
+    }>;
+};
 export declare class Person {
     sosa: number | undefined;
     INDI: number;
@@ -17,16 +30,21 @@ export declare class Person {
     multimediaFiles: MultimediaFiles;
     acts: Acts;
     notes: Notes;
+    /** Tous les blocs `1 NAME` (alias, traductions, etc.) ; vide si seulement le couple prénom/nom classique. */
+    nameVariants: PersonNameVariant[];
+    /** Attributs de niveau 1 (`FACT`, `DSCR`, …) avec sous-structures conservées. */
+    attributes: IndiAttribute[];
     get files(): MultimediaFile[];
     get keysFiles(): string[];
-    constructor(sosa?: number, SEX?: Sex, firstnames?: Array<string>, lastname?: string, FAMC?: number, FAMS?: number[], INDI?: number, multimediaFiles?: MultimediaFiles, newMultimediaFiles?: Map<string, MultimediaFile>, acts?: Acts);
-    createPersonJson(personLines: string[], informationFamilies?: Map<number, string[]>, mapFiles?: Map<string, File>, globalNotes?: Map<number, string[]>): void;
+    constructor(sosa?: number, SEX?: Sex, firstnames?: Array<string>, lastname?: string, FAMC?: number, FAMS?: number[], INDI?: number, multimediaFiles?: MultimediaFiles, newMultimediaFiles?: Map<string, MultimediaFile>, acts?: Acts, nameVariants?: PersonNameVariant[], attributes?: IndiAttribute[]);
+    createPersonJson(personLines: string[], informationFamilies?: Map<number, string[]>, mapFiles?: Map<string, File>, globalNotes?: Map<number, string[]>, textualIndiXrefToIndi?: ReadonlyMap<string, number>, importOptions?: PersonGedcomImportOptions): void;
     private parsePersonLine;
     private createIndiFromZeroLine;
     private createSexFromValue;
     private createFAMCFromValue;
     private createFAMSFromValue;
     private createMultimediaFilesFromValue;
+    private createMultimediaFromObjePointer;
     private addNoteFromGedcom;
     /**
      * Média au niveau individu (hors acte) : chemin logique `{INDI}/{nomFichier}`.

package/dist/commons/PersonNameVariant.d.ts

@@ -0,0 +1,21 @@
+import type { IndiGedcomSubLine } from "./IndiGedcomSubLine";
+/** Traduction `2 TRAN` sous un `1 NAME` (GEDCOM 7). */
+export declare class PersonNameTranslation {
+    payload: string;
+    lang?: string;
+    parts: IndiGedcomSubLine[];
+    constructor(payload: string, lang?: string, parts?: IndiGedcomSubLine[]);
+    toGedcom(lineEnding: string): string;
+}
+/**
+ * Un bloc `1 NAME` complet (type, pièces NPFX/GIVN/…, traductions).
+ * Permet un aller-retour GEDCOM sans perdre alias / traductions.
+ */
+export declare class PersonNameVariant {
+    payload: string;
+    type?: string;
+    parts: IndiGedcomSubLine[];
+    translations: PersonNameTranslation[];
+    constructor(payload: string, type?: string, parts?: IndiGedcomSubLine[], translations?: PersonNameTranslation[]);
+    toGedcom(lineEnding: string): string;
+}

package/dist/commons/Place.d.ts

@@ -1,7 +1,26 @@
 export declare class Place {
     city: string | null;
+    /** Jurisdiction level 2 in GEDCOM 7 `PLAC` list (after city), when `FORM` is City, County, State, Country. */
+    county: string | null;
+    state: string | null;
+    country: string | null;
+    /** Texte `3 PHRASE` sous `PLAC` (GEDCOM 7). */
+    placPhrase: string | null;
     coordinate: CoordinateGPS;
     constructor(city?: string, coordinate?: CoordinateGPS);
+    /**
+     * Remplit les champs à partir d’une charge `PLAC` GEDCOM 7 (liste séparée par des virgules).
+     * Ordre attendu avec le `HEAD`.`PLAC`.`FORM` par défaut de l’export : City, County, State, Country.
+     *
+     * Heuristique : 1 segment → ville seule ; 2 → ville + pays (sans county/state) ;
+     * 3 → ville, county, pays (state vide) ; 4 → les quatre niveaux ; 5+ → les trois premiers niveaux
+     * puis le reste concaténé dans `country` (ex. subdivisions multiples).
+     */
+    setFromGedcom7PlacPayload(payload: string): void;
+    /** Ajoute du texte issu d’un `3 PHRASE` sous `PLAC` (import GEDCOM 7). */
+    appendPlacPhraseFromImport(fragment: string): void;
+    /** Charge `PLAC` pour l’export GEDCOM 7 (liste `,`). */
+    toGedcom7PlacPayload(): string | null;
     addCity(city: string): void;
 }
 export declare class CoordinateGPS {

package/dist/commons/gedcomEventTags.d.ts

@@ -0,0 +1,10 @@
+import { Identifier } from "./Identifier.enum";
+/**
+ * GEDCOM 7 standard event tags: `INDIVIDUAL_EVENT_STRUCTURE` ∪ `FAMILY_EVENT_STRUCTURE`
+ * (LDS ordinances excluded).
+ */
+export declare const GEDCOM_7_ALL_EVENT_TAGS: readonly [Identifier.ADOP, Identifier.BAPM, Identifier.BARM, Identifier.BASM, Identifier.BIRT, Identifier.BLES, Identifier.BURI, Identifier.CENS, Identifier.CHR, Identifier.CHRA, Identifier.CONF, Identifier.CREM, Identifier.DEAT, Identifier.EMIG, Identifier.EVEN, Identifier.FCOM, Identifier.GRAD, Identifier.IMMI, Identifier.NATU, Identifier.ORDN, Identifier.PROB, Identifier.RETI, Identifier.WILL, Identifier.ANUL, Identifier.DIV, Identifier.DIVF, Identifier.ENGA, Identifier.MARB, Identifier.MARC, Identifier.MARL, Identifier.MARR, Identifier.MARS];
+export type Gedcom7EventTag = (typeof GEDCOM_7_ALL_EVENT_TAGS)[number];
+/** Document order when two acts have no usable sortable date (`Acts.sortByDate`). */
+export declare const GEDCOM_7_EVENT_SORT_ORDER: readonly Gedcom7EventTag[];
+export declare const GEDCOM_7_EVENT_TAG_SET: ReadonlySet<string>;

package/dist/edit/ActEdit.d.ts

@@ -0,0 +1,29 @@
+import { Act, type TypeAct } from "../commons/Act";
+import { DateAct } from "../commons/DateAct";
+import { Place } from "../commons/Place";
+/**
+ * API d’édition cohérente autour d’un {@link Act} existant (mutation in-place).
+ */
+export declare class ActEdit {
+    private readonly target;
+    constructor(target: Act);
+    get value(): Act;
+    setType(type: TypeAct): this;
+    setIndis(ids: readonly number[]): this;
+    setDateAct(date: DateAct | null): this;
+    setSdateAct(sdate: DateAct | null): this;
+    /** Remplace le lieu ; `null` efface le lieu attaché à l’acte. */
+    setPlace(place: Place | null): this;
+    setEvenDescription(text: string | null): this;
+    setEvenTypeLabel(label: string | null): this;
+    setEventPhrases(phrases: readonly string[]): this;
+    clearEventPhrases(): this;
+    appendEventPhrase(phrase: string): this;
+    setPreservedPrefix(lines: readonly string[]): this;
+    appendPreservedPrefixLine(line: string): this;
+    clearPreservedPrefix(): this;
+    setPreservedSuffix(lines: readonly string[]): this;
+    appendPreservedSuffixLine(line: string): this;
+    clearPreservedSuffix(): this;
+}
+export declare function editAct(act: Act): ActEdit;

package/dist/edit/ActsEdit.d.ts

@@ -0,0 +1,17 @@
+import { Acts } from "../commons/Act";
+import { ActEdit } from "./ActEdit";
+/**
+ * API d’édition cohérente autour d’un {@link Acts}.
+ */
+export declare class ActsEdit {
+    private readonly target;
+    constructor(target: Acts);
+    get value(): Acts;
+    add(act: Parameters<Acts["add"]>[0]): this;
+    replaceAt(index: number, act: Parameters<Acts["updateFromIndex"]>[0]): this;
+    removeAt(index: number): this;
+    clear(): this;
+    sortByDate(): this;
+    at(index: number): ActEdit;
+}
+export declare function editActs(acts: Acts): ActsEdit;