gedcom-ts 2.0.2 → 2026.5.0

package/dist/utils/gedcom/actExtraction.d.ts

@@ -3,4 +3,6 @@ export type ActsExtractionResult = {
     entries: GedcomActEntry[];
     indis: number[];
 };
-export declare function extractActEntriesAndIndis(lines: string[], initialIndis: number[]): ActsExtractionResult;
+/** Level-1 tag from a line like `1 BIRT` or `1 DIVF` (no false match on `DIV` vs `DIVF`). */
+export declare function gedcomLevel1Tag(line: string): string | null;
+export declare function extractActEntriesAndIndis(lines: string[], initialIndis: number[], textualIndiXrefToIndi?: ReadonlyMap<string, number>): ActsExtractionResult;

package/dist/utils/gedcom/datasetVersion.d.ts

@@ -0,0 +1,7 @@
+/** Version logique du jeu de données déduite du bloc `HEAD`. */
+export type GedcomDatasetVersion = "7.0" | "5.5" | "unknown";
+/**
+ * Déduit la version FamilySearch GEDCOM à partir des lignes du bloc `0 HEAD` …
+ * (sous-structure `GEDC`.`VERS`, typiquement niveau 2).
+ */
+export declare function resolveDatasetVersion(headerLines: string[] | null | undefined): GedcomDatasetVersion;

package/dist/utils/gedcom/extractIndiNamesAndAttributes.d.ts

@@ -0,0 +1,4 @@
+import { IndiAttribute } from "../../commons/IndiAttribute";
+import { PersonNameVariant } from "../../commons/PersonNameVariant";
+export declare function extractPersonNameVariants(personLines: string[]): PersonNameVariant[];
+export declare function extractIndiAttributes(personLines: string[]): IndiAttribute[];

package/dist/utils/gedcom/importGedcomNote.d.ts

@@ -0,0 +1,17 @@
+import { Note } from "../../commons/Note";
+import { Identifier } from "../../commons/Identifier.enum";
+export type GedcomNoteImportContext = {
+    globalNotes?: Map<number, string[]>;
+    notePointerToId?: ReadonlyMap<string, number>;
+};
+/** `1 NOTE` sous INDI (pas `2 NOTE` sous un acte). */
+export declare function isPersonLevelGedcomLine(level: string): boolean;
+/** `2 NOTE` sous un événement (`BIRT`, `MARR`, …). */
+export declare function isActLevelGedcomNoteLine(level: string): boolean;
+export declare function isGedcomNoteContinuationTag(tag: string): tag is Identifier.CONC | Identifier.CONT;
+/**
+ * Construit une {@link Note} à partir d’une valeur `NOTE` inline ou d’un pointeur `@N…@`.
+ */
+export declare function createNoteFromGedcomPayload(rawValue: string, ctx?: GedcomNoteImportContext | null): Note | null;
+/** Ajoute une sous-ligne `CONC` / `CONT` à une note en cours d’import. */
+export declare function appendGedcomNoteSubline(note: Note, tag: Identifier.CONC | Identifier.CONT, value: string): void;

package/dist/utils/gedcom/labelKeyedRecords.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Clés d’xref `F` / `N` canoniques : `005` → `5`, les libellés non numériques restent inchangés.
+ */
+export declare function canonicalFamOrNoteLabel(inner: string): string;
+export type LabelKeyedMapsResult = {
+    byNumericId: Map<number, string[]>;
+    pointerToId: Map<string, number>;
+};
+/**
+ * À partir d’une carte « libelle xref → lignes sous l’en-tête `0` », produit une carte par id
+ * numérique interne et la table de résolution `@FfamA@` / `@Nfoo@` → id.
+ */
+export declare function resolveLabelKeyedMapToNumericIds(labelMap: Map<string, string[]>): LabelKeyedMapsResult;

package/dist/utils/gedcom/mediaFormFromUri.d.ts

@@ -0,0 +1,2 @@
+/** Best-effort `FORM` (media type) for GEDCOM 7 `OBJE`.`FILE` from a URI or path. */
+export declare function guessMediaFormFromUri(uri: string): string;

package/dist/utils/gedcom/parseStandaloneObje.d.ts

@@ -0,0 +1,9 @@
+export type StandaloneObjePayload = {
+    id: number;
+    sourceUri: string;
+};
+/**
+ * Extrait l’id `@O{n}@` et le premier `FILE` utile d’un enregistrement `0 @O…@ OBJE`.
+ * Préfère une URI `http(s)`, sinon première valeur `FILE` non vide.
+ */
+export declare function parseStandaloneObjeBlock(block: string): StandaloneObjePayload | null;

package/dist/utils/gedcom/personName.d.ts

@@ -1,6 +1,13 @@
+import type { PersonNameVariant } from "../../commons/PersonNameVariant";
 export type ParsedPersonName = {
     firstnames: string[];
     lastname: string;
 };
 export declare function parsePersonName(rawName: string): ParsedPersonName;
+/**
+ * Choisit la valeur `1 NAME` la plus pertinente : priorité au bloc avec `2 TYPE BIRTH`
+ * (GEDCOM 7 / noms multiples), sinon premier nom avec patronyme `/…/`, sinon le premier `NAME`.
+ */
 export declare function extractRawNameFromGedcomLines(lines: string[]): string | null;
+/** Même logique que {@link extractRawNameFromGedcomLines} appliquée aux blocs `NAME` déjà découpés. */
+export declare function selectPrimaryNameVariant(variants: PersonNameVariant[]): PersonNameVariant | null;

package/dist/utils/gedcom/pointers.d.ts

@@ -1,3 +1,19 @@
 export declare function extractNumericPointer(value: string, prefix: string): number | null;
+/**
+ * Libellé brut entre `@F` / `@N` et `@` (tout caractère sauf `@`), sans canoniser.
+ */
+export declare function extractPointerInnerLabel(value: string, prefixLetter: "F" | "N"): string | null;
+/** Clé pour {@link resolveLabelKeyedMapToNumericIds} : canonise les ids numériques (`01` → `1`). */
+export declare function extractFamNotePointerKey(value: string, prefixLetter: "F" | "N"): string | null;
 export declare function extractEntityIdFromZeroLine(line: string, prefix: string, entityTag: string): number | null;
+/**
+ * Xref « textuelle » sous `0 @…@ INDI` (ex. GRAMPS `@Homer_Simpson@`).
+ * Retourne `null` si l’xref est déjà le schéma numérique `@I{n}@` (géré par {@link extractEntityIdFromZeroLine}).
+ */
+export declare function extractTextualIndiXrefFromZeroLine(line: string): string | null;
 export declare function extractPointerIdFromLine(line: string, prefix: string): number | null;
+/**
+ * Résout la valeur d’un pointeur `INDI` (`@I12@`, `@Homer_Simpson@`) vers un id numérique interne,
+ * comme pour {@link extractTextualIndiXrefFromZeroLine} + {@link extractNumericPointer}.
+ */
+export declare function resolveIndiPointerValueToId(pointerValue: string, textualIndiXrefToIndi?: ReadonlyMap<string, number>): number | null;

package/dist/utils/gedcom/uriBasename.d.ts

@@ -0,0 +1,2 @@
+/** Dernier segment exploitable d’une URI pour nommer un média distant (sans query). */
+export declare function basenameFromUri(uri: string): string;

package/dist/utils/multimedia/registerTrackedMedia.d.ts

@@ -0,0 +1,10 @@
+import { MultimediaFile, MultimediaFiles } from "../../commons/MultimediaFile";
+export type TrackedMediaContext = {
+    multimediaFiles: MultimediaFiles;
+    newMultimediaFiles: Map<string, MultimediaFile>;
+    pathBase: string;
+};
+/**
+ * Enregistre un {@link MultimediaFile} avec chemin relatif unique (suffixe `_1`, …) et synchronise `files` + map interne.
+ */
+export declare function registerTrackedMedia(ctx: TrackedMediaContext, file: MultimediaFile, logicalFileName: string): string | null;

package/dist/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Version affichée dans l’export GEDCOM (`HEAD`.`SOUR`.`VERS`, etc.).
+ * **À aligner sur** la propriété `version` du `package.json` à chaque release
+ * (un test vérifie l’égalité).
+ */
+export declare const GEDCOM_LIBRARY_VERSION = "2026.5.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gedcom-ts",
-  "version": "2.0.2",
+  "version": "2026.5.0",
   "description": "TypeScript GEDCOM toolkit for browser apps: import .ged/.zip, edit typed genealogy data, and export GEDCOM or GEDZIP.",
   "author": "Bertrand Jaunet <bertrand.jaunet@gmail.com>",
   "license": "SEE LICENSE IN LICENSE",