@treeviz/gedcom-parser 2.0.0 → 2.0.3

package/dist/classes/common.d.ts

@@ -0,0 +1,118 @@
+import type { ConvertOptions } from "../interfaces/common";
+import type ICommon from "../interfaces/common";
+import type { IdType, MultiTag, ListTag } from "../types/types";
+import type { GedComType } from "./gedcom";
+import { List } from "./list";
+export declare class Common<T = string, I extends IdType = IdType> implements ICommon<T, I> {
+    protected _gedcom?: GedComType;
+    protected _value?: T;
+    protected _id?: I;
+    protected _main?: Common;
+    protected _parent?: Common;
+    protected _uniqueId?: string | undefined;
+    protected _type?: MultiTag;
+    protected _refs?: List;
+    isListable: boolean;
+    refType?: ListTag;
+    cloneOf?: string;
+    clonedBy?: string;
+    constructor(gedcom?: GedComType, id?: I, main?: Common, parent?: Common);
+    set type(type: MultiTag | undefined);
+    get type(): MultiTag | undefined;
+    initUniqueId(): void;
+    set uniqueId(id: string | undefined);
+    get uniqueId(): string | undefined;
+    set id(id: I | undefined);
+    get id(): I | undefined;
+    set value(value: T | undefined);
+    get value(): T | undefined;
+    /**
+     * Set the gedcom reference for this object
+     * @param gedcom - The GedComType to set as the gedcom reference
+     */
+    setGedcom(gedcom: GedComType): void;
+    get originalValue(): T | undefined;
+    get ref(): Common<T, I> | undefined;
+    get main(): Common<string, IdType> | undefined;
+    get parent(): Common<string, IdType> | undefined;
+    addRef(refNode: Common): void;
+    getRefs(): List<IdType, Common<string, IdType>> | undefined;
+    exportValue(): T | undefined;
+    removeValue(): void;
+    set<T extends Common | List = Common | List>(name: MultiTag, value: T | string): T | undefined;
+    assign<T extends Common | List = Common | List>(name: MultiTag, value: T, unique?: boolean): T | undefined;
+    get<T extends Common | List = Common | List>(name: MultiTag): T | undefined;
+    remove(name: MultiTag): void;
+    getGedcom(): GedComType | undefined;
+    getIf<T extends Common | List = Common | List>(name: MultiTag, condition: string, name2: MultiTag): T | undefined;
+    toString(): string;
+    toValue(): T | undefined;
+    toProp(tag: MultiTag): Common<T, I> | undefined;
+    toList(): List<IdType, Common<string, IdType>>;
+    index(i: number): Common<string, IdType> | undefined;
+    toValueList(): List<IdType, Common<string, IdType>>;
+    private standardizeObject;
+    toJson(tag?: MultiTag, options?: ConvertOptions): string;
+    toObject(tag?: MultiTag, options?: ConvertOptions): Record<string, string | ({
+        value?: string;
+    } & Record<string, unknown>) | (string | ({
+        value?: string;
+    } & Record<string, unknown>) | undefined)[] | undefined>;
+    merge(other: Common<T, I>, override?: boolean, avoidKeys?: MultiTag[]): this;
+    clone(newId?: boolean, avoidKeys?: MultiTag[]): Common<T, I>;
+    fromGedcom(_value: string): void;
+    toGedcom(tag?: MultiTag, level?: number, options?: ConvertOptions): string;
+    toGedcomLines(tag?: MultiTag, level?: number, options?: ConvertOptions): string[];
+    isGenoPro(): boolean;
+    isAhnenblatt(): boolean;
+    isGeni(): boolean;
+    isAncestry(): boolean;
+    isMyHeritage(): boolean;
+    /**
+     * Get the source type as a string (for prefixing tree IDs and names)
+     * Returns the detected source type or undefined if unknown
+     */
+    getSourceType(): string | undefined;
+    isFamilySearch(): boolean;
+    isGNO2GED(): boolean;
+    getAncestryTreeId(): string | undefined;
+    getMyHeritageTreeId(): string | undefined;
+    getTreeId(): string;
+    getAncestryTreeName(): string | undefined;
+    getMyHeritageTreeName(): string | undefined;
+    getFamilySearchTreeId(): string;
+    getFamilySearchTreeName(): string;
+    getAhnenblattTreeId(): string | undefined;
+    getAhnenblattTreeName(): string | undefined;
+    getGeniTreeId(): string | undefined;
+    getGeniTreeName(): string | undefined;
+    getGenoProTreeId(): string | undefined;
+    getGenoProTreeName(): string | undefined;
+    getGNO2GEDTreeId(): string;
+    getGNO2GEDTreeName(): string;
+    /**
+     * Universal tree ID getter for unknown/unrecognized GEDCOM sources
+     * Tries to extract an ID from various common locations
+     */
+    getUniversalTreeId(): string;
+    /**
+     * Universal tree name getter for unknown/unrecognized GEDCOM sources
+     * Tries to extract a name from various common locations
+     */
+    getUniversalTreeName(): string;
+    getTreeName(): string;
+}
+export type ProxyOriginal<T extends Common> = T & {
+    unwrapped: T;
+};
+export declare const createProxy: <T extends Common>(target: T) => T;
+export declare const createCommon: (gedcom?: GedComType, id?: IdType, main?: Common, parent?: Common) => ProxyOriginal<Common>;
+export declare const isOnlyMainProp: (key: string | symbol) => key is MultiTag | "_value" | "value";
+export declare const isValidKey: <T>(common: Common<T>, key: string | symbol) => key is MultiTag | "_value" | "value" | "id" | "_id";
+export declare const getValidKeys: <T>(common: Common<T>) => Array<MultiTag | "_value" | "value" | "id" | "_id">;
+export declare const getValidTag: (tag: string) => string;
+export declare const getListTag: (tag: string) => ListTag;
+export declare const getValidKey: (tag: string, id: string) => string;
+export declare const isId: (string: string) => string is IdType;
+export declare const idGetter: <T extends IdType>(id?: T) => T | undefined;
+//# sourceMappingURL=common.d.ts.map

package/dist/classes/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/classes/common.ts"],"names":[],"mappings":"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"}

package/dist/classes/date.d.ts

@@ -0,0 +1,27 @@
+import type { Locale } from "date-fns";
+import type { IdType, MultiTag } from "../types/types";
+import type { Range } from "../utils/range";
+import { Common } from "./common";
+import type { ProxyOriginal } from "./common";
+import type { GedComType } from "./gedcom";
+import type { List } from "./list";
+export declare class CommonDate extends Common<string> {
+    private _date?;
+    DAY?: Common;
+    MONTH?: Common;
+    YEAR?: Common;
+    NOTE?: Common;
+    constructor(gedcom?: GedComType, id?: IdType, main?: Common, parent?: Common);
+    set value(value: string | undefined);
+    get value(): string | undefined;
+    get rawValue(): Date | undefined;
+    assign<T extends Common | List = Common | List>(name: MultiTag, value: T, unique?: boolean): T | undefined;
+    private isValidDateFormat;
+    toNote(short?: boolean): string | undefined;
+    toValue(dateFormat?: string, locale?: Locale | null): string | undefined;
+    exportValue(): string | undefined;
+    inRange(range: Range, trueIfNoYear?: boolean): boolean;
+}
+export declare const createCommonDate: (gedcom?: GedComType, id?: IdType, main?: Common, parent?: Common) => ProxyOriginal<CommonDate>;
+export declare const isCommonDate: (value?: unknown) => value is CommonDate;
+//# sourceMappingURL=date.d.ts.map

package/dist/classes/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/classes/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIvC,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAA6B,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAoDnC,qBAAa,UAAW,SAAQ,MAAM,CAAC,MAAM,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,CAAO;IAErB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;gBAGb,MAAM,CAAC,EAAE,UAAU,EACnB,EAAE,CAAC,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM;IAOhB,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EA0ElC;IAED,IAAI,KAAK,IA5EQ,MAAM,GAAG,SAAS,CA+FlC;IAED,IAAI,QAAQ,qBAEX;IAED,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,EAC7C,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,CAAC,EACR,MAAM,UAAQ;IAUf,OAAO,CAAC,iBAAiB;IAgBzB,MAAM,CAAC,KAAK,UAAO,GAAG,MAAM,GAAG,SAAS;IAUxC,OAAO,CACN,UAAU,SAAgB,EAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,GAAG,SAAS;IAuBrB,WAAW;IAIX,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,UAAQ;CAG1C;AAED,eAAO,MAAM,gBAAgB,GAC5B,SAAS,UAAU,EACnB,KAAK,MAAM,EACX,OAAO,MAAM,EACb,SAAS,MAAM,KACb,aAAa,CAAC,UAAU,CAI1B,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,QAAQ,OAAO,KAAG,KAAK,IAAI,UAOvD,CAAC"}

package/dist/classes/fam.d.ts

@@ -0,0 +1,19 @@
+import type IFam from "../interfaces/fam";
+import type IFamilyStructure from "../structures/family";
+import type { FamKey } from "../types/types";
+import { Common } from "./common";
+import type { ProxyOriginal } from "./common";
+import { Families } from "./fams";
+import type { GedComType } from "./gedcom";
+import { Individuals } from "./indis";
+export declare class Fam extends Common<string, FamKey> implements IFam {
+    private getFamilyMembers;
+    getChildren(): Individuals;
+    getHusband(): Individuals;
+    getWife(): Individuals;
+    getParents(): Individuals;
+    toList(): Families;
+}
+export type FamType = Fam & IFamilyStructure;
+export declare const createFam: (gedcom: GedComType, id: FamKey, main?: Common, parent?: Common) => ProxyOriginal<FamType>;
+//# sourceMappingURL=fam.d.ts.map

package/dist/classes/fam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fam.d.ts","sourceRoot":"","sources":["../../src/classes/fam.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,gBAAgB,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAW,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAe,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,qBAAa,GAAI,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAE,YAAW,IAAI;IAC9D,OAAO,CAAC,gBAAgB;IAexB,WAAW;IAIX,UAAU;IAIV,OAAO;IAIP,UAAU,IAAI,WAAW;IAIzB,MAAM;CAMN;AAED,MAAM,MAAM,OAAO,GAAG,GAAG,GAAG,gBAAgB,CAAC;AAC7C,eAAO,MAAM,SAAS,GACrB,QAAQ,UAAU,EAClB,IAAI,MAAM,EACV,OAAO,MAAM,EACb,SAAS,MAAM,KACb,aAAa,CAAC,OAAO,CAIvB,CAAC"}

package/dist/classes/fams.d.ts

@@ -0,0 +1,16 @@
+import type { IFamilies } from "../interfaces/fams";
+import type { FamKey, Filter, Order, FilterIterator, OrderIterator } from "../types/types";
+import type { FamType } from "./fam";
+import { Individuals } from "./indis";
+import { List } from "./list";
+export declare class Families extends List<FamKey, FamType> implements IFamilies {
+    copy(): Families;
+    except(item: FamType): Families;
+    filter(filters: Filter | FilterIterator<FamType, FamKey>): Families;
+    find(filters: Filter | FilterIterator<FamType, FamKey>): FamType | undefined;
+    orderBy(orders: Order | OrderIterator<FamType, FamKey>): Families;
+    getParents(): Individuals;
+    getChildren(): Individuals;
+    toList(): Families;
+}
+//# sourceMappingURL=fams.d.ts.map

package/dist/classes/fams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fams.d.ts","sourceRoot":"","sources":["../../src/classes/fams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAC,MAAM,gBAAgB,CAAC;AAGzF,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,qBAAa,QAAS,SAAQ,IAAI,CAAC,MAAM,EAAE,OAAO,CAAE,YAAW,SAAS;IACvE,IAAI,IAAI,QAAQ;IAIhB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ;IAI/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,QAAQ;IAInE,IAAI,CACH,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GAC/C,OAAO,GAAG,SAAS;IAItB,OAAO,CAAC,MAAM,EAAE,KAAK,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,QAAQ;IAIjE,UAAU,IAAI,WAAW;IAYzB,WAAW,IAAI,WAAW;IAY1B,MAAM;CAGN"}

package/dist/classes/gedcom.d.ts

@@ -0,0 +1,148 @@
+import type { ConvertOptions } from "../interfaces/common";
+import type IGedcom from "../interfaces/gedcom";
+import type IEventDetailStructure from "../structures/event-detail-structure";
+import type IGedComStructure from "../structures/gedcom";
+import type { IdType, IndiKey, FamKey, ObjeKey, SourKey, RepoKey, SubmKey, MultiTag } from "../types/types";
+import { Common } from "./common";
+import type { FamType } from "./fam";
+import type { Families } from "./fams";
+import type { IndiType } from "./indi";
+import type { Individuals } from "./indis";
+import { List } from "./list";
+import type { ObjeType } from "./obje";
+import type { Objects } from "./objes";
+import type { RepoType } from "./repo";
+import type { Repositories } from "./repos";
+import type { SourType } from "./sour";
+import type { Sources } from "./sours";
+import type { SubmType } from "./subm";
+import type { Submitters } from "./subms";
+export declare class GedCom extends Common implements IGedcom {
+    tagMembers: Record<string, {
+        tag: Common;
+        indis: Individuals;
+    }>;
+    reflist: Record<string, Common>;
+    refcount: number;
+    constructor();
+    private getMain;
+    getList<T extends List = List>(type: MultiTag): T | undefined;
+    indis(): Individuals | undefined;
+    cloneIndis(target?: IndiKey | IndiType, source?: IndiKey | IndiType, avoidKeys?: MultiTag[], removeFromOriginalList?: boolean): this | undefined;
+    mergeIndis(target?: IndiKey | IndiType, source?: IndiKey | IndiType, removeFromOriginalList?: boolean): this | undefined;
+    fams(): Families | undefined;
+    objes(): Objects | undefined;
+    sours(): Sources | undefined;
+    repos(): Repositories | undefined;
+    subms(): Submitters | undefined;
+    tags(): List<IdType, Common<string, IdType>> | undefined;
+    customTags(): List<IdType, Common<string, IdType>> | undefined;
+    indi(index: number | IndiKey): IndiType | undefined;
+    fam(index: number | FamKey): FamType | undefined;
+    obje(index: number | ObjeKey): ObjeType | undefined;
+    sour(index: number | SourKey): SourType | undefined;
+    repo(index: number | RepoKey): RepoType | undefined;
+    subm(index: number | SubmKey): SubmType | undefined;
+    tag(index: number | SubmKey): Common<string, IdType> | undefined;
+    fromList(id?: string): Common<string, IdType> | undefined;
+    tagByName(name?: string): Common<string, IdType> | undefined;
+    customTag(index: number | SubmKey): Common<string, IdType> | undefined;
+    private getIndiRelatedLists;
+    private getDownloadHeader;
+    toFiltered(indis: IndiKey[]): this | GedComType;
+    toJson(tag?: MultiTag | undefined, options?: (ConvertOptions & {
+        indis?: IndiKey[];
+    }) | undefined): string;
+    toGedcom(tag?: MultiTag | undefined, level?: number, options?: (ConvertOptions & {
+        indis?: IndiKey[];
+    }) | undefined): string;
+    hasTag(tag?: string | Common): boolean;
+    hasUnknownAncestor(): boolean;
+    hasIgnoredMember(): boolean;
+    hasUnattachedMember(): boolean;
+    hasUnknownGivenname(): boolean;
+    hasUnknownSurname(): boolean;
+    hasNonRelevant(): boolean;
+    /**
+     * Get all places from the GEDCOM with occurrence counts
+     * @returns Record mapping place names to their occurrence count
+     */
+    getAllPlaces(): Record<string, number>;
+    /**
+     * Get all places from the GEDCOM with associated individual IDs
+     * @param usedIndis Optional array of individual IDs to filter by
+     * @returns Record mapping place names to arrays of individual IDs
+     */
+    getAllPlacesWithIndis(usedIndis?: IndiKey[]): Record<string, (`@I${number}@` | `@P${number}@` | `@XI${number}@` | `@XXI${number}@`)[]>;
+    /**
+     * Generate statistics about the GEDCOM file
+     * @param individuals Optional list of individuals to calculate statistics for. If not provided, all individuals from the GEDCOM will be used.
+     * @returns Object containing various statistics about the GEDCOM data
+     */
+    stats(individuals?: Individuals): {
+        totalIndividuals: number;
+        totalFamilies: number;
+        byGender: {
+            males: number;
+            females: number;
+            unknown: number;
+        };
+        dateRange: {
+            earliest: number | null;
+            latest: number | null;
+        };
+        averageLifespan: number | null;
+        topSurnames: {
+            surname: string;
+            count: number;
+        }[];
+        topBirthPlaces: {
+            place: string;
+            count: number;
+        }[];
+        firstPersonEvent: {
+            type: string;
+            event: IEventDetailStructure | undefined;
+            person: IndiType | undefined;
+        } | null;
+        lastPersonEvent: {
+            type: string;
+            event: (Common<string, IdType> & IEventDetailStructure) | undefined;
+            person: IndiType | undefined;
+        } | null;
+    };
+}
+export type GedComType = GedCom & IGedComStructure;
+export declare const createGedCom: () => GedComType;
+export declare const isGedcomString: (gedcomString?: string) => boolean;
+/**
+ * Validates if a string is a valid GEDCOM file content
+ * @param content - The file content to validate
+ * @returns An object with `valid` boolean and optional `error` message
+ */
+export declare const validateGedcomContent: (content?: string) => {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Merge two GEDCOM objects into a single result using a configurable matching strategy
+ * @param targetGedcom - The base GEDCOM (kept as the primary source)
+ * @param sourceGedcom - The GEDCOM to be merged into the target
+ * @param strategy - Matching strategy: "id" (default) to match by individual ID, or any MultiTag (e.g., "NAME", "BIRT.DATE") to match by that field's value
+ * @returns The merged GedComType with all individuals and families combined
+ *
+ * @example
+ * // Merge by ID (individuals with same ID are considered the same person)
+ * const merged = await mergeGedcoms(target, source, "id");
+ *
+ * @example
+ * // Merge by NAME (individuals with same name are considered the same person)
+ * const merged = await mergeGedcoms(target, source, "NAME");
+ *
+ * @remarks
+ * - Source individuals are always assigned new unique IDs to avoid conflicts
+ * - When individuals match by strategy, they are merged (data and relationships combined)
+ * - All family relationships (FAMS/FAMC) are preserved with updated ID references
+ */
+export declare const mergeGedcoms: (targetGedcom: GedComType, sourceGedcom: GedComType, strategy?: MultiTag | "id") => GedComType;
+//# sourceMappingURL=gedcom.d.ts.map

package/dist/classes/gedcom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gedcom.d.ts","sourceRoot":"","sources":["../../src/classes/gedcom.ts"],"names":[],"mappings":"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"}

package/dist/classes/index.d.ts

@@ -1,2 +1,28 @@
-export { a as Common, b as CommonDate, c as CommonName, d as CommonNote, h as CustomTags, E as Existed, F as Fam, j as FamType, k as Families, l as FamilySearchMatch, m as FamilySearchSource, G as GedCom, p as GedComType, q as GenealogyMember, s as GenerationIndiType, t as GenerationSpouseType, a8 as Indi, a9 as IndiGenealogy, aa as IndiGenealogyGenerations, ab as IndiGenealogyResult, ad as IndiMarker, ae as IndiTree, af as IndiType, ag as Individuals, ak as List, am as MemberMain, an as MemberSide, ar as NonNullIndiGenealogyResult, at as Obje, av as ObjeType, aw as Objects, aB as Path, aC as PathItem, aH as ProfilePicture, aI as ProxyOriginal, aJ as Queue, aK as QueueItem, aN as ReducedPath, aP as Repo, aR as RepoType, aS as Repositories, aV as Sour, aX as SourType, aY as Sources, a_ as Subm, b0 as SubmType, b1 as Submitters, b4 as TreeMember, b6 as createCommon, b7 as createCommonDate, b8 as createCommonName, b9 as createCommonNote, ba as createFam, bb as createGedCom, bc as createIndi, bd as createObje, be as createProxy, bf as createRepo, bg as createSour, bh as createSubm, bn as getListTag, bp as getValidKey, bq as getValidKeys, br as getValidTag, bs as idGetter, bu as isCommonDate, bv as isGedcomString, bw as isId, by as isOnlyMainProp, bA as isValidKey, bB as mergeGedcoms, bF as validateGedcomContent } from '../index-CzYZg44D.js';
-import 'date-fns';
+export type { ProxyOriginal } from "./common";
+export type { SourType } from "./sour";
+export type { RepoType } from "./repo";
+export type { SubmType } from "./subm";
+export type { IndiType, TreeMember, GenealogyMember, IndiTree, IndiGenealogy, IndiMarker, MemberSide, MemberMain, GenerationSpouseType, GenerationIndiType, IndiGenealogyGenerations, IndiGenealogyResult, NonNullIndiGenealogyResult, PathItem, Path, ReducedPath, QueueItem, Queue, } from "./indi";
+export type { FamType } from "./fam";
+export type { GedComType } from "./gedcom";
+export type { ObjeType } from "./obje";
+export { Existed, CustomTags } from "./indi";
+export * from "./common";
+export * from "./date";
+export * from "./fam";
+export * from "./fams";
+export * from "./gedcom";
+export * from "./indi";
+export * from "./indis";
+export * from "./list";
+export * from "./name";
+export * from "./note";
+export * from "./obje";
+export * from "./objes";
+export * from "./repo";
+export * from "./repos";
+export * from "./sour";
+export * from "./sours";
+export * from "./subm";
+export * from "./subms";
+//# sourceMappingURL=index.d.ts.map

package/dist/classes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EACX,QAAQ,EACR,UAAU,EACV,eAAe,EACf,QAAQ,EACR,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,SAAS,EACT,KAAK,GACL,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG7C,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/classes/index.js

@@ -4645,7 +4645,7 @@ var Indi = class extends Common {
               title,
               url,
               contentType: type,
-              downloadName: `${this.id.replaceAll("@", "")}_${this.toNaturalName().replaceAll(" ", "-") || ""}_${(title || key.replaceAll("@", "").toString()).replaceAll(" ", "-")}`
+              downloadName: `${this.id.replaceAll("@", "")}_${this.toNaturalName()?.replaceAll(" ", "-") || ""}_${(title || key.replaceAll("@", "").toString()).replaceAll(" ", "-")}`
             };
           }
         })
@@ -4674,7 +4674,7 @@ var Indi = class extends Common {
     const deathObj = this.get("DEAT.OBJE")?.toList().copy();
     objeList?.merge(birthObj).merge(deathObj);
     (this.get("FAMS")?.toValueList().values() ?? []).concat(this.get("FAMC")?.toValueList().values() ?? []).forEach((fam) => {
-      objeList.merge(fam?.get("MARR.OBJE"));
+      objeList?.merge(fam?.get("MARR.OBJE"));
     });
     objeList?.forEach((o, index) => {
       if (!o) {
@@ -4700,7 +4700,7 @@ var Indi = class extends Common {
           title,
           url,
           contentType: type,
-          downloadName: `${this.id.replaceAll("@", "")}_${this.toNaturalName().replaceAll(" ", "-") || ""}_${(title || key.replaceAll("@", "").toString()).replaceAll(" ", "-")}`
+          downloadName: `${this.id.replaceAll("@", "")}_${this.toNaturalName()?.replaceAll(" ", "-") || ""}_${(title || key.replaceAll("@", "").toString()).replaceAll(" ", "-")}`
         };
       }
     });
@@ -4798,14 +4798,11 @@ var Indi = class extends Common {
     const sourList = this.get("SOUR")?.toList().copy();
     sourList?.forEach((sour) => {
       const sourObje = sour?.get("OBJE")?.toList();
-      objeList.merge(sourObje);
+      objeList?.merge(sourObje);
     });
-    if (!objeList || objeList.length === 0) {
-      return void 0;
-    }
     const rfn = this.get("RFN")?.toValue();
     const geniId = rfn?.replace(/^geni:/, "") || "unknown";
-    objeList.forEach((obje, index) => {
+    objeList?.forEach((obje, index) => {
       if (!obje) {
         return;
       }
@@ -4844,7 +4841,7 @@ var Indi = class extends Common {
       return list;
     }
     const rfn = this.get("RFN")?.toValue();
-    const treeId = rfn || "universal";
+    const treeId = this.getUniversalTreeId() || rfn || "universal";
     objeList.forEach((obje, index) => {
       if (!obje) {
         return;
@@ -6254,7 +6251,7 @@ var createIndi = (gedcom, id, main, parent) => {
 
 // package.json
 var package_default = {
-  version: "2.0.0"};
+  version: "2.0.3"};
 
 // src/utils/get-product-details.ts
 var getVersion = () => package_default.version;