gedcom-ts 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -0,0 +1,130 @@
+# Changelog
+
+All notable changes of gedcom-ts
+
+## [2.0.2] - 2026-05-11
+
+### Fixed
+
+- Sorting of undated acts now follows the expected genealogical order:
+  - `BIRT`, `CHR`, `MARR`, `DIV`, `DEAT`, `BURI`
+- Undated/invalid dates are now handled consistently during sorting to avoid `BURI` appearing first.
+- Month comparison now treats unknown months as later than known months for stable ordering.
+- Added non-regression tests for invalid dates and undated act type ordering.
+
+## [2.0.1] - 2026-05-06
+
+### Changed
+
+- Removed `file-saver` dependency.
+
+## [2.0.0] - 2026-05-05
+
+### Highlights
+
+- Major modernization of GEDCOM import/export and typed genealogy models.
+- Better media lifecycle for acts and persons, including ZIP path reliability.
+- New build and quality toolchain (esbuild, ESLint, Vitest).
+- Fully rewritten technical documentation and improved package metadata.
+
+### Added
+
+- New domain models and helpers:
+  - `Person` model replacing previous `People` flow
+  - `MultimediaFile` / `MultimediaFiles`
+  - `Note` / `Notes`
+  - `ActsByYear` / `EventsByYears`
+  - GED helpers (`parseGedcomLine`, note formatting, media path utilities, Sosa and INDI helpers)
+- New import entrypoint for GED and ZIP: `importGedFile`.
+- ZIP export support with media path strategy for acts:
+  - single INDI: `INDI/TYPE/file`
+  - multi-INDI: `media/events/indi1-indi2/TYPE/file`
+- Dedicated loader/parser components:
+  - `LoadFile`
+  - `SplitedInformations`
+- `LICENSE` file added and package license reference aligned (`SEE LICENSE IN LICENSE`).
+- New test suites for core domains and export behavior:
+  - `tests/commons/Act.spec.ts`
+  - `tests/commons/Person.spec.ts`
+  - `tests/export/GEDCOM.spec.ts`
+  - `tests/utils/nextAvailableRelativeMediaPath.spec.ts`
+
+### Changed
+
+- Full build migration to esbuild (`build.js`) and webpack removal.
+- Test stack migrated from Jest to Vitest (`vitest.config.ts`) with `jsdom`.
+- Build output now minified (esbuild minification + tree-shaking, ES2020 target).
+- Obfuscation pipeline introduced with a moderated profile compatible with modern front-end apps.
+- ZIP generation now uses `DEFLATE` compression level `9`.
+- README rewritten with dedicated sections:
+  - Import
+  - Utilisation
+  - Export
+  - public API examples for all exports from `src/index.ts`
+- Package metadata improved (`description`, `keywords`) for npm discoverability.
+- CI/config/tooling updates (`.gitlab-ci.yml`, `.npmignore`, `.gitignore`, `tsconfig.json`, eslint config).
+
+### Fixed
+
+- ZIP export no longer misses act media directories in edge cases.
+- Fallback media path handling fixed to prevent `undefined/...` directories.
+- GED `FILE` lines are now consistent with real ZIP archive paths.
+- Import robustness improved:
+  - fallback to `file.text()` when `File.stream()` is unavailable
+  - more reliable GED record block parsing (`0 ...` headers preserved and detected)
+- Multiple reliability fixes around acts, notes, places and media handling.
+
+## [1.0.9] - 2023-06-16
+
+### Added
+
+- support multiple FAMS
+
+## [1.0.8] - 2023-06-15
+
+### Added
+
+- all right reserved - proprietary code explicit in licence package
+
+## [1.0.7] - 2023-06-15
+
+### Added
+
+- FAMS and FAMC are exported
+
+## [1.0.6] - 2023-06-15
+
+### Added
+
+- export birth and death date and place
+
+## [1.0.5] - 2023-06-10
+
+### Added
+
+- act birth and death
+
+## [1.0.4] - 2020-03-10
+
+### Added
+
+- read FAMS (code for two parents) and FAMC (code for childs). It's same code between them.
+- read Sex with two possibilities: M or F
+- group partnersMap, it's a map for all parents
+- jest / test in Person / runner
+- createDirectAncestries
+
+
+## 1.0.3 - 2019-10-01
+
+### Added
+
+- add import gedcom file and return a JSON data model of an array of Person. It just extract names and firstnames
+
+## 1.0.2-alpha - 2019-09-01
+
+### Added
+ 
+- export for birth and death in gedcom
+- All identificators can be used for a developper. It's an enum of properties used for all gedcom
+- City is removed and replaced by Place. Place gets more informations

package/README.md

@@ -99,9 +99,9 @@ person.lastname = "DUPONT";
 ### Act, Acts, TypeAct
 
 ```ts
-import { Act, Acts, TypeAct, Identificator } from "gedcom-ts";
+import { Act, Acts, TypeAct, Identifier } from "gedcom-ts";
 
-const actType: TypeAct = Identificator.BIRT;
+const actType: TypeAct = Identifier.BIRT;
 const act = new Act(actType);
 const acts = new Acts();
 acts.add(act);
@@ -141,9 +141,9 @@ const place = new Place("Paris, FR", new CoordinateGPS(48.8566, 2.3522));
 ### Notes, Note, TypeNote
 
 ```ts
-import { Notes, Note, TypeNote, Identificator } from "gedcom-ts";
+import { Notes, Note, TypeNote, Identifier } from "gedcom-ts";
 
-const typeNote: TypeNote = Identificator.CONT;
+const typeNote: TypeNote = Identifier.CONT;
 const note = new Note();
 note.updateType(typeNote);
 note.updateLines(["first line", "second line"]);
@@ -151,12 +151,12 @@ const notes = new Notes();
 notes.addNote(note);
 ```
 
-### Identificator
+### Identifier (preferred) / Identificator (deprecated)
 
 ```ts
-import { Identificator } from "gedcom-ts";
+import { Identifier } from "gedcom-ts";
 
-const birthTag = Identificator.BIRT;
+const birthTag = Identifier.BIRT;
 ```
 
 ### ExportGedcomFile, ExportGedzipFile

package/dist/commons/Act.d.ts

@@ -1,9 +1,9 @@
 import { DateAct } from "./DateAct";
 import { Place } from "./Place";
-import { Identificator } from "./Identificator.enum";
+import { Identifier } from "./Identifier.enum";
 import { MultimediaFile, MultimediaFiles } from "./MultimediaFile";
 import { Notes } from "./Note";
-export type TypeAct = Identificator.BIRT | Identificator.DEAT | Identificator.MARR;
+export type TypeAct = Identifier.BIRT | Identifier.DEAT | Identifier.MARR | Identifier.BURI | Identifier.CHR | Identifier.DIV;
 export declare class Act {
     type: TypeAct;
     dateAct?: DateAct | null;
@@ -34,8 +34,13 @@ export declare class Acts {
     removeFromIndex(indexAct: number): void;
     removeAll(): void;
     sortByDate(): void;
+    private hasSortableDate;
+    private compareByTypeOrder;
+    private compareMarriageAndDivorce;
+    private haveSameParticipants;
 }
 export declare class ActsByExtraction extends Acts {
     extractActsInfo(lines: string[], INDIS: number[], mapFiles: Map<string, File>): void;
     private convertToActs;
+    private resolveTypeAct;
 }

package/dist/commons/DateAct.d.ts

@@ -1,6 +1,9 @@
 export declare enum TypeDateAct {
     BEF = "BEF",
     ABT = "ABT",
+    AFT = "AFT",
+    BET = "BET",
+    FROM = "FROM",
     NULL = "NULL"
 }
 export declare enum MonthEnum {
@@ -26,9 +29,43 @@ export declare class DateAct {
     day?: Day;
     month?: Month;
     year?: number;
+    endDay?: Day;
+    endMonth?: Month;
+    endYear?: number;
     constructor(dateLine: string);
     get date(): string | null;
+    updateExactDate(year?: number, month?: Month, day?: Day): void;
+    updateQualifiedDate(typeDateAct: TypeDateAct.ABT | TypeDateAct.BEF | TypeDateAct.AFT, 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;
     private convertMonth;
+    private parseSinglePart;
+    private parseTwoParts;
+    private parseThreeParts;
+    private parseFourParts;
+    private assignMonthYearFromSlash;
+    private parseMonthToken;
+    private formatCoreDate;
+    private tryParseRangeDate;
+    private parseCoreDateValue;
+    private isRelativeType;
     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,131 @@
+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",
+    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"
+}

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/export/GEDCOM.d.ts

@@ -10,10 +10,8 @@ declare class GEDCOM {
     gedcomBlob(): Blob;
 }
 export declare class ExportGedzipFile extends GEDCOM {
-    private zip;
     constructor(...args: [persons: Array<Person>] | [title: string, persons: Array<Person>]);
     download(): Promise<void>;
-    private collectMediaFiles;
     private resolvePersonIndi;
     private resolveActIndis;
     private resolveZipPath;
@@ -40,7 +38,6 @@ export declare class PersonLine {
     private readonly NOTES;
     constructor(person: Person, haveFiles: boolean);
     line(): string;
-    private getFileLines;
     private getIndi;
     private getName;
     private getSex;

package/dist/import/ReadGed.d.ts

@@ -16,4 +16,9 @@ export declare class ReadGed extends SplitGedcom {
     generateUniqueIndi(): number;
     private haveParentsOfPerson;
     private createPersons;
+    private buildPerson;
+    private hydratePlacesFromActs;
+    private upsertPlace;
+    private linkPersonAsPartner;
+    private linkPersonAsChild;
 }