gedcom-ts 2.1.0 → 2026.5.0

package/dist/edit/MultimediaFileEdit.d.ts

@@ -0,0 +1,17 @@
+import { MultimediaFile } from "../commons/MultimediaFile";
+/**
+ * API d’édition cohérente autour d’un {@link MultimediaFile} existant.
+ */
+export declare class MultimediaFileEdit {
+    private readonly target;
+    constructor(target: MultimediaFile);
+    get value(): MultimediaFile;
+    setRelativePath(path: string): this;
+    setFile(file: File | undefined): this;
+    clearFile(): this;
+    setSourceUri(uri: string | null | undefined): this;
+    clearSourceUri(): this;
+    setObjeXrefId(id: number | null | undefined): this;
+    clearObjeXrefId(): this;
+}
+export declare function editMultimediaFile(file: MultimediaFile): MultimediaFileEdit;

package/dist/edit/NameVariantsEdit.d.ts

@@ -0,0 +1,43 @@
+import type { IndiGedcomSubLine } from "../commons/IndiGedcomSubLine";
+import { PersonNameTranslation, PersonNameVariant } from "../commons/PersonNameVariant";
+/**
+ * API d’édition cohérente autour d’un {@link PersonNameVariant} existant.
+ */
+export declare class PersonNameVariantEdit {
+    private readonly target;
+    constructor(target: PersonNameVariant);
+    get value(): PersonNameVariant;
+    setPayload(payload: string): this;
+    setType(type: string | null | undefined): this;
+    clearType(): this;
+    setParts(parts: readonly IndiGedcomSubLine[]): this;
+    appendPart(part: IndiGedcomSubLine): this;
+    clearParts(): this;
+    setTranslations(translations: readonly PersonNameTranslation[]): this;
+    appendTranslation(translation: PersonNameTranslation): this;
+    clearTranslations(): this;
+}
+export declare function editPersonNameVariant(variant: PersonNameVariant): PersonNameVariantEdit;
+/**
+ * Variants `1 NAME` sur une {@link Person}.
+ */
+export declare class NameVariantsEdit {
+    private readonly target;
+    constructor(target: {
+        nameVariants: PersonNameVariant[];
+    });
+    get value(): PersonNameVariant[];
+    add(variant: PersonNameVariant): this;
+    /** Ajoute un variant minimal (`1 NAME` / `2 TYPE` optionnel) et renvoie sa facade. */
+    addNew(payload: string, type?: string): PersonNameVariantEdit;
+    insertAt(index: number, variant: PersonNameVariant): this;
+    insertNewAt(index: number, payload: string, type?: string): PersonNameVariantEdit;
+    removeLast(): this;
+    replaceAt(index: number, variant: PersonNameVariant): this;
+    removeAt(index: number): this;
+    clear(): this;
+    at(index: number): PersonNameVariantEdit;
+}
+export declare function editNameVariants(person: {
+    nameVariants: PersonNameVariant[];
+}): NameVariantsEdit;

package/dist/edit/NoteEdit.d.ts

@@ -0,0 +1,18 @@
+import { Note, type TypeNote } from "../commons/Note";
+/**
+ * API d’édition cohérente autour d’une {@link Note} existante (mutation in-place).
+ */
+export declare class NoteEdit {
+    private readonly target;
+    constructor(target: Note);
+    get value(): Note;
+    setType(type: TypeNote): this;
+    /** Remplace le texte de la note (y compris tableau vide). */
+    setLines(lines: readonly string[]): this;
+    appendLine(line: string): this;
+    clearLines(): this;
+    setIndis(ids: readonly number[]): this;
+    appendIndi(indi: number): this;
+    clearIndis(): this;
+}
+export declare function editNote(note: Note): NoteEdit;

package/dist/edit/NotesEdit.d.ts

@@ -1,4 +1,5 @@
 import { Note, Notes } from "../commons/Note";
+import { NoteEdit } from "./NoteEdit";
 /**
  * API d’édition cohérente autour d'un {@link Notes}.
  */
@@ -6,9 +7,19 @@ export declare class NotesEdit {
     private readonly target;
     constructor(target: Notes);
     get value(): Notes;
+    /**
+     * Crée une {@link Note}, l’ajoute en fin de liste et renvoie sa facade d’édition.
+     */
+    addNew(initialLines?: readonly string[] | null): NoteEdit;
     add(note: Note): this;
+    insertAt(index: number, note: Note): this;
+    insertNewAt(index: number, initialLines?: readonly string[] | null): NoteEdit;
+    removeLast(): this;
+    indexOfNote(note: Note): number;
+    removeNote(note: Note): boolean;
     replaceAt(index: number, note: Note): this;
     removeAt(index: number): this;
     clear(): this;
+    at(index: number): NoteEdit;
 }
 export declare function editNotes(notes: Notes): NotesEdit;

package/dist/edit/PersonEdit.d.ts

@@ -2,7 +2,10 @@ import type { IndiAttribute } from "../commons/IndiAttribute";
 import { Person, Sex } from "../commons/Person";
 import type { PersonNameVariant } from "../commons/PersonNameVariant";
 import { ActsEdit } from "./ActsEdit";
+import { IndiAttributesEdit } from "./IndiAttributesEdit";
+import { NameVariantsEdit } from "./NameVariantsEdit";
 import { NotesEdit } from "./NotesEdit";
+import { PersonMediaEdit } from "./PersonMediaEdit";
 /**
  * API d’édition cohérente autour d'un {@link Person} existant (identité, unions, actes, notes).
  */
@@ -15,13 +18,30 @@ export declare class PersonEdit {
     setFirstnames(firstnames: readonly string[]): this;
     setSosa(sosa: number | undefined): this;
     setFamc(famc: number | undefined): this;
+    /** Efface le lien de filiation (`FAMC`). */
+    clearFamc(): this;
     /** Remplace la liste des unions (`FAMS`). */
     setFams(fams: readonly number[]): this;
     clearFams(): this;
     appendFams(famId: number): this;
+    /** Retire l’identifiant de famille à l’index donné dans `FAMS`. */
+    removeFamsAt(index: number): this;
+    /** Retire la première occurrence de `familyId` dans `FAMS` (no-op si absent). */
+    removeFamsByFamilyId(familyId: number): this;
     setNameVariants(variants: readonly PersonNameVariant[]): this;
+    /** Édition élément par élément des blocs `1 NAME`. */
+    nameVariants(): NameVariantsEdit;
     setAttributes(attrs: readonly IndiAttribute[]): this;
+    /** Édition élément par élément des attributs de niveau 1 (`FACT`, …). */
+    attributes(): IndiAttributesEdit;
     acts(): ActsEdit;
     notes(): NotesEdit;
+    /** Médias de niveau individu (fichiers locaux via {@link Person.addMultimedia}). */
+    multimedia(): PersonMediaEdit;
+    clearActs(): this;
+    clearNotes(): this;
+    clearMultimedia(): this;
+    clearNameVariants(): this;
+    clearAttributes(): this;
 }
 export declare function editPerson(person: Person): PersonEdit;

package/dist/edit/PersonMediaEdit.d.ts

@@ -0,0 +1,27 @@
+import { MultimediaFile } from "../commons/MultimediaFile";
+import type { Person } from "../commons/Person";
+import { MultimediaFileEdit } from "./MultimediaFileEdit";
+/**
+ * Médias au niveau individu : s'appuie sur {@link Person.addMultimedia} / {@link Person.deleteMultimedia}.
+ */
+export declare class PersonMediaEdit {
+    private readonly target;
+    constructor(target: Person);
+    get value(): Person;
+    /**
+     * Crée un {@link MultimediaFile} à partir d'un fichier local, l'ajoute et renvoie sa facade.
+     */
+    addNewFromFile(file: File): MultimediaFileEdit;
+    /**
+     * Ajoute un média à partir d’une URI (sans fichier local), voir {@link Person.addMultimediaFromUri}.
+     */
+    addNewFromUri(uri: string, objeXrefId?: number | null): MultimediaFileEdit;
+    /**
+     * Ajoute un média avec fichier local (chemins relatifs gérés comme dans {@link Person.addMultimedia}).
+     */
+    add(multimediaFile: MultimediaFile): this;
+    removeAt(index: number): this;
+    clear(): this;
+    at(index: number): MultimediaFileEdit;
+}
+export declare function editPersonMedia(person: Person): PersonMediaEdit;

package/dist/edit/factories.d.ts

@@ -0,0 +1,35 @@
+import { Act, type ActConstructionOptions, type TypeAct } from "../commons/Act";
+import { DateAct } from "../commons/DateAct";
+import type { IndiGedcomSubLine } from "../commons/IndiGedcomSubLine";
+import { IndiAttribute } from "../commons/IndiAttribute";
+import { Note, Notes } from "../commons/Note";
+import { Person, Sex } from "../commons/Person";
+import { PersonNameVariant } from "../commons/PersonNameVariant";
+import { Place } from "../commons/Place";
+export type CreateActInit = {
+    dateAct?: DateAct | null;
+    place?: Place | null;
+    indis?: readonly number[] | null;
+    construction?: ActConstructionOptions | null;
+    notes?: Notes;
+};
+/** Construit un {@link Act} (pour `ActsEdit.add`, `addNew`, etc.). */
+export declare function createAct(type: TypeAct, init?: CreateActInit | null): Act;
+/**
+ * Construit une {@link Note} avec des lignes initialisées (tableau vide par défaut).
+ */
+export declare function createNote(initialLines?: readonly string[] | null): Note;
+export type CreatePersonStubInit = {
+    sosa?: number;
+    sex?: Sex;
+    firstnames?: readonly string[];
+    lastname?: string;
+    famc?: number;
+    fams?: readonly number[];
+};
+/**
+ * Crée un {@link Person} minimal avec un `INDI` connu (arbre vide ou ajout manuel).
+ */
+export declare function createPersonStub(indi: number, init?: CreatePersonStubInit | null): Person;
+export declare function createPersonNameVariant(payload: string, type?: string): PersonNameVariant;
+export declare function createIndiAttribute(tag: string, value?: string, children?: readonly IndiGedcomSubLine[]): IndiAttribute;

package/dist/edit/index.d.ts

@@ -12,8 +12,22 @@
  * ```
  */
 export { ActEdit, editAct } from "./ActEdit";
+export { ActMediaEdit, editActMedia } from "./ActMediaEdit";
 export { ActsEdit, editActs } from "./ActsEdit";
+export { cloneAct, clonePerson } from "../dataset/cloneModels";
 export { DateActEdit, editDateAct } from "./DateActEdit";
+export { createAct, createIndiAttribute, createNote, createPersonNameVariant, createPersonStub, type CreateActInit, type CreatePersonStubInit, } from "./factories";
+export { editGedcomExportOptions, GedcomExportOptionsEdit } from "./GedcomExportOptionsEdit";
+export { addPersonToReadGed, commandBlockingIssues, createMarriageFamily, linkChildToFamily, nextFamilyId, removeFamilyReferencesFromDataset, removePersonFromReadGedByIndi, tryAddPersonToReadGed, tryCreateMarriageFamily, tryLinkChildToFamily, tryRemovePersonFromReadGedByIndi, tryUnlinkChildFromFamily, unlinkChildFromFamily, validateAddPersonCommand, validateCreateMarriageCommand, validateLinkChildCommand, validateUnlinkChildCommand, } from "../dataset";
+export type { CommandFail, CommandOk, CommandResult, CreateUnionFamilyOptions } from "../dataset";
+export { IndiAttributeEdit, IndiAttributesEdit, editIndiAttribute, editIndiAttributes } from "./IndiAttributesEdit";
+export { MultimediaFileEdit, editMultimediaFile } from "./MultimediaFileEdit";
+export { NameVariantsEdit, PersonNameVariantEdit, editNameVariants, editPersonNameVariant } from "./NameVariantsEdit";
+export { NoteEdit, editNote } from "./NoteEdit";
 export { NotesEdit, editNotes } from "./NotesEdit";
 export { PersonEdit, editPerson } from "./PersonEdit";
+export { PersonMediaEdit, editPersonMedia } from "./PersonMediaEdit";
 export { PlaceEdit, editPlace } from "./PlaceEdit";
+export { PreservedTopLevelEdit, ReadGedEdit, editReadGed } from "../dataset/ReadGedEdit";
+export { assertPersonConsistent, assertReadGedConsistent, validatePerson, validateReadGed, } from "../dataset/validation";
+export type { AssertConsistencyOptions, ConsistencySeverity, ModelConsistencyIssue, ModelConsistencyIssueCode, ValidatePersonContext, ValidateReadGedOptions, } from "../dataset/validation";

package/dist/import/PreservedRecordsBuffer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Liste interne des blocs `0 …` conservés pour diagnostic / round-trip (hors `0 TRLR`).
+ */
+export declare class PreservedRecordsBuffer {
+    private readonly items;
+    get length(): number;
+    /** Vue en lecture seule (référence au tableau interne, comme l’ancien `_preservedTopLevelRecords`). */
+    asReadonly(): readonly string[];
+    at(index: number): string | undefined;
+    /**
+     * Ajoute le bloc tel quel (sauf filtre `0 TRLR`), pour l’ingestion GEDCOM — aligné sur l’ancien `preserveTopLevelRecord`.
+     */
+    appendRaw(block: string): void;
+    append(block: string): void;
+    insertAt(index: number, block: string): void;
+    replaceAt(index: number, block: string): void;
+    removeAt(index: number): void;
+    clear(): void;
+    /** Retire l’élément à l’index sans normalisation (usage interne parse / absorb). */
+    spliceRemoveAt(index: number): void;
+}

package/dist/import/ReadGed.d.ts

@@ -53,6 +53,12 @@ export declare class ReadGed extends SplitGedcom {
     getChildrenForParent(parent: Person): Person[];
     /** Enfants d’une famille donnée (identifiant interne `F`, ex. `0` pour `@F0000@`). */
     getChildrenOfFamily(familyId: number): Person[];
+    /**
+     * Reconstruit {@link placesMap} à partir des lieux des actes (après édition du graphe).
+     * Préférez la façade `editReadGed` pour les mutations ; cette méthode est utile si vous modifiez
+     * les personnes hors façade.
+     */
+    rehydratePlacesFromActs(): void;
     private haveParentsOfPerson;
     private createPersons;
     /**

package/dist/import/SplitedInformations.d.ts

@@ -11,8 +11,14 @@ export declare class SplitGedcom {
      * 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;
+    private readonly preservedRecords;
     get preservedTopLevelRecords(): readonly string[];
+    /** Ajoute un bloc `0 …` complet (multi-lignes) en fin de liste préservée. */
+    appendPreservedTopLevelRecord(block: string): void;
+    insertPreservedTopLevelRecordAt(index: number, block: string): void;
+    replacePreservedTopLevelRecordAt(index: number, block: string): void;
+    removePreservedTopLevelRecordAt(index: number): void;
+    clearPreservedTopLevelRecords(): void;
     constructor(gedcomContent?: string);
     protected ingestGedcomText(gedcomContent: string): void;
     protected ingestGedcomFileStream(file: File): Promise<void>;