@treeviz/gedcom-parser 1.0.1

package/dist/classes/common.d.ts

@@ -0,0 +1,87 @@
+import { type IdType, type MultiTag } from "../types/types";
+import type { ListTag } from "../types/types";
+import { type ConvertOptions } from "../interfaces/common";
+import type ICommon from "../interfaces/common";
+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;
+    get originalValue(): T;
+    get ref(): Common<T, I> | undefined;
+    get main(): Common<string, IdType>;
+    get parent(): Common<string, IdType>;
+    addRef(refNode: Common): void;
+    getRefs(): List<IdType, Common<string, IdType>>;
+    exportValue(): T;
+    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;
+    remove(name: MultiTag): void;
+    getGedcom(): GedComType;
+    getIf<T extends Common | List = Common | List>(name: MultiTag, condition: string, name2: MultiTag): T;
+    toString(): string;
+    toValue(): T;
+    toProp(tag: MultiTag): Common<T, I> | undefined;
+    toList(): List<IdType, Common<string, IdType>>;
+    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>))[]>;
+    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;
+    isFamilySearch(): boolean;
+    getAncestryTreeId(): string | undefined;
+    getMyHeritageTreeId(): string | undefined;
+    getTreeId(): string;
+    getAncestryTreeName(): string | undefined;
+    getMyHeritageTreeName(): 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;
+//# 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/common.js

@@ -0,0 +1,481 @@
+import get from "lodash/get";
+import set from "lodash/set";
+import uniqBy from "lodash/uniqBy";
+import unset from "lodash/unset";
+import { ID_GETTER_REG, ID_REG } from "../constants/constants";
+import { List } from "./list";
+// import GedcomTree from "../../../utils/parser";
+export class Common {
+    constructor(gedcom, id, main, parent) {
+        this.isListable = true;
+        this._gedcom = gedcom;
+        this._main = main;
+        this._parent = parent;
+        this.initUniqueId();
+        if (id) {
+            this._id = id;
+        }
+        else {
+            delete this._id;
+        }
+    }
+    set type(type) {
+        if (type) {
+            this.uniqueId = this.uniqueId?.replace(/^[^:]+/, `~${type}`);
+        }
+        this._type = type;
+    }
+    get type() {
+        return this._type;
+    }
+    initUniqueId() {
+        if (this._gedcom) {
+            this.uniqueId = `~Common:${this._gedcom.refcount++}`;
+        }
+    }
+    set uniqueId(id) {
+        const currentId = this._uniqueId;
+        if (this._gedcom?.reflist && id) {
+            this._uniqueId = id;
+            if (currentId && this._gedcom.reflist[currentId]) {
+                delete this._gedcom.reflist[currentId];
+            }
+            this._gedcom.reflist[id] = this;
+        }
+    }
+    get uniqueId() {
+        return this._uniqueId;
+    }
+    set id(id) {
+        this._id = idGetter(id);
+    }
+    get id() {
+        return idGetter(this._id);
+    }
+    set value(value) {
+        this._value = value;
+    }
+    get value() {
+        return this._value;
+    }
+    // avoid to override
+    get originalValue() {
+        return this._value;
+    }
+    get ref() {
+        if (typeof this.value === "string" &&
+            isId(this.value) &&
+            this.refType) {
+            return this._gedcom?.[getListTag(this.refType)]?.item(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.value);
+        }
+        return this;
+    }
+    get main() {
+        return this._main;
+    }
+    get parent() {
+        return this._parent;
+    }
+    addRef(refNode) {
+        if (typeof refNode.value === "string" &&
+            isId(refNode.value) &&
+            refNode.refType) {
+            if (!this._refs) {
+                this._refs = new List();
+            }
+            this._refs.item(refNode.value, refNode);
+        }
+    }
+    getRefs() {
+        return this._refs;
+    }
+    exportValue() {
+        return this.value;
+    }
+    removeValue() {
+        delete this._value;
+    }
+    set(name, value) {
+        if (typeof value === "string") {
+            const usedValue = createCommon(this._gedcom, undefined, this.main);
+            usedValue.value = value;
+            set(this, name, usedValue);
+        }
+        else {
+            set(this, name, value);
+        }
+        return get(this, name);
+    }
+    assign(name, value, unique = false) {
+        let curValue = this.get(name);
+        if (curValue?.isListable) {
+            if (curValue instanceof Common) {
+                curValue = new List().concat({ ...[curValue] });
+                this.set(name, curValue);
+            }
+            const values = [
+                ...curValue.values(),
+                ...(value instanceof List ? value.values() : [value]),
+            ];
+            curValue.concat({
+                ...(!unique
+                    ? values
+                    : uniqBy(values, (value) => value instanceof Common ? value?.value : undefined)),
+            });
+        }
+        else {
+            this.set(name, value);
+        }
+        return get(this, name);
+    }
+    get(name) {
+        if (!name.includes(".")) {
+            return get(this, name);
+        }
+        const nameParts = name.split(".");
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        let last = this;
+        for (const part of nameParts) {
+            const indexPart = Number(part);
+            const itemIndex = part.match(/items\[(?<itemIndex>\d+)\]/)?.groups
+                ?.itemIndex;
+            const itemId = part.match(/items\[(?<itemId>@[A-Z]+\d+@)\]/)?.groups
+                ?.itemId;
+            const usedPart = itemId || itemIndex;
+            if (last instanceof List) {
+                if (!isNaN(indexPart)) {
+                    last = last.index(indexPart);
+                }
+                else {
+                    if (usedPart) {
+                        last = last.item(usedPart);
+                    }
+                    else {
+                        last = last?.index(0)?.get(part);
+                    }
+                }
+            }
+            else {
+                const usedIndex = Number(itemIndex ?? indexPart);
+                if (!isNaN(usedIndex)) {
+                    last = last?.toList().index(usedIndex);
+                }
+                else {
+                    last = last?.get((itemId ?? part));
+                }
+            }
+            if (!last) {
+                break;
+            }
+        }
+        return last;
+    }
+    remove(name) {
+        unset(this, name);
+    }
+    getGedcom() {
+        return this._gedcom;
+    }
+    getIf(name, condition, name2) {
+        const nameParts = name.split(".");
+        const name2Parts = name2.split(".");
+        if (nameParts.length !== name2Parts.length) {
+            throw new Error("Tag pathes must be of the same depth");
+        }
+        if (nameParts.length > 1 && nameParts[0] !== name2Parts[0]) {
+            throw new Error("Final tags must be siblings");
+        }
+        const valueCommon = this.get(name);
+        if (valueCommon instanceof Common) {
+            return valueCommon?.toValue() !== condition
+                ? undefined
+                : this.get(name2);
+        }
+        const valueCommon2 = this.get(name2)?.toList();
+        const ifList = new List();
+        valueCommon?.forEach((item, key) => {
+            const pair = valueCommon2?.item(key);
+            ifList.item(key, item?.toValue() !== condition ? undefined : pair);
+        });
+        return ifList;
+    }
+    toString() {
+        return this.value?.toString() || "";
+    }
+    toValue() {
+        return this.value;
+    }
+    toProp(tag) {
+        const prop = this.get(tag);
+        return prop;
+    }
+    toList() {
+        return new List().concat(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.id ? { [this.id]: this } : { ...[this] });
+    }
+    toValueList() {
+        return new List().concat(this.value
+            ? { [this.value]: this }
+            : // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                { ...[this] });
+    }
+    standardizeObject(tag, options) {
+        if (tag === "OBJE" &&
+            !options?.original &&
+            options?.obje?.standardize &&
+            options?.obje?.namespace &&
+            "standardizeMedia" in this) {
+            const standardize = this.standardizeMedia;
+            return standardize.call(this, options.obje.namespace, options.obje.override);
+        }
+    }
+    toJson(tag, options) {
+        const json = this.toObject(tag, options);
+        return JSON.stringify(json);
+    }
+    toObject(tag, options) {
+        this.standardizeObject(tag, options);
+        const validKeys = getValidKeys(this);
+        let json = {};
+        validKeys.forEach((key) => {
+            if (key === "id" && this.id !== undefined) {
+                json.id = this.id;
+            }
+            else if (key === "_id" && this._id !== undefined) {
+                json.id = this._id;
+            }
+            else if (key === "value" && this.value !== undefined) {
+                json.value = this.value;
+            }
+            else if (key === "_value" && this._value !== undefined) {
+                json.value = this._value;
+            }
+            else {
+                const validKey = key;
+                const prop = this.get(validKey);
+                if (typeof prop?.toObject === "function") {
+                    if (prop instanceof Common) {
+                        json[validKey] = prop.toObject(validKey, options);
+                    }
+                    else {
+                        json = {
+                            ...json,
+                            ...prop.toObject(validKey, options),
+                        };
+                    }
+                }
+            }
+        });
+        return json;
+    }
+    merge(other, override = false, avoidKeys = []) {
+        if (!other) {
+            return this;
+        }
+        const validKeys = getValidKeys(other);
+        validKeys.forEach((validKey) => {
+            if (avoidKeys.includes(validKey)) {
+                return;
+            }
+            const current = this.get(validKey);
+            const mergeValue = other.get(validKey);
+            if (mergeValue) {
+                if (current instanceof Common || current instanceof List) {
+                    this.assign(validKey, mergeValue, true);
+                }
+                else if (!current ||
+                    (override && validKey !== "id" && validKey !== "_id")) {
+                    this.set(validKey, mergeValue);
+                }
+            }
+        });
+        return this;
+    }
+    clone(newId = false, avoidKeys = []) {
+        const ctor = this.constructor;
+        const instance = new ctor(this._gedcom, this._id, this._main, this._parent);
+        if (newId && this._id) {
+            instance.id = `IFT${this._id.replace(/[^0-9]/g, "")}`;
+        }
+        const cloned = createProxy(instance);
+        cloned.merge(this, true, avoidKeys);
+        return cloned;
+    }
+    // fromGedcom<T = typeof this>(value: string) {
+    fromGedcom(_value) {
+        // Object.assign(this, GedcomTree.parse(value) as T);
+    }
+    toGedcom(tag, level = 0, options) {
+        const gedcom = this.toGedcomLines(tag, level, options);
+        return gedcom.join("\n");
+    }
+    toGedcomLines(tag, level = 0, options) {
+        this.standardizeObject(tag, options);
+        const validKeys = getValidKeys(this);
+        const gedcom = [];
+        validKeys.forEach((key) => {
+            const validKey = key;
+            const prop = this.get(validKey);
+            if (typeof prop?.toGedcomLines === "function") {
+                if (prop instanceof Common) {
+                    const value = prop.exportValue();
+                    gedcom.push(`${level} ${validKey}${value ? ` ${value}` : ""}`);
+                    gedcom.push(...prop.toGedcomLines(validKey, level + 1, options));
+                }
+                else {
+                    gedcom.push(...prop.toGedcomLines(validKey, level, options));
+                }
+            }
+        });
+        return gedcom;
+    }
+    isGenoPro() {
+        const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+        const sour = get(head, "SOUR.value");
+        return !!sour?.toLowerCase()?.startsWith("genopro");
+    }
+    isAhnenblatt() {
+        const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+        const sour = get(head, "SOUR.value");
+        return !!sour?.toLowerCase()?.startsWith("ahnenblatt");
+    }
+    isGeni() {
+        const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+        const sour = get(head, "SOUR.value");
+        return !!sour?.toLowerCase()?.startsWith("geni");
+    }
+    isAncestry() {
+        const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+        const sour = get(head, "SOUR.value");
+        return !!sour?.toLowerCase()?.startsWith("ancestry");
+    }
+    isMyHeritage() {
+        const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+        const sour = get(head, "SOUR.value");
+        return !!sour?.toLowerCase()?.startsWith("myheritage");
+    }
+    isFamilySearch() {
+        const head = get(this, "HEAD") || get(this.getGedcom(), "HEAD");
+        const sourName = get(head, "SOUR.NAME.value");
+        return sourName === "FamilySearch API";
+    }
+    getAncestryTreeId() {
+        const path = "HEAD.SOUR._TREE.RIN.value";
+        return (get(this, path) || get(this.getGedcom(), path));
+    }
+    getMyHeritageTreeId() {
+        const path = "HEAD._EXPORTED_FROM_SITE_ID.value";
+        return (get(this, path) || get(this.getGedcom(), path));
+    }
+    getTreeId() {
+        if (this?.isAncestry()) {
+            return this.getAncestryTreeId();
+        }
+        if (this?.isMyHeritage()) {
+            return this.getMyHeritageTreeId();
+        }
+    }
+    getAncestryTreeName() {
+        const path = "HEAD.SOUR._TREE.value";
+        return (get(this, path) || get(this.getGedcom(), path));
+    }
+    getMyHeritageTreeName() {
+        const path = "HEAD.FILE.value";
+        const treeDetails = (get(this, path) || get(this.getGedcom(), path));
+        return treeDetails?.match(/Exported by MyHeritage.com from (?<tree>.+) in.+$/)?.groups?.tree;
+    }
+    getTreeName() {
+        if (this?.isAncestry()) {
+            return this.getAncestryTreeName();
+        }
+        if (this?.isMyHeritage()) {
+            return this.getMyHeritageTreeName();
+        }
+    }
+}
+export const createProxy = (target) => {
+    return new Proxy(target, {
+        get(t, prop, receiver) {
+            if (prop === "unwrapped") {
+                return target;
+            }
+            if (prop in t) {
+                return Reflect.get(t, prop, receiver);
+            }
+            if (!isOnlyMainProp(prop)) {
+                const ref = t.ref;
+                if (ref && prop in ref) {
+                    return Reflect.get(ref, prop, receiver);
+                }
+            }
+        },
+    });
+};
+export const createCommon = (gedcom, id, main, parent) => {
+    return createProxy(new Common(gedcom, id, main, parent));
+};
+export const isOnlyMainProp = (key) => {
+    return (key === "_gedcom" ||
+        key === "_main" ||
+        key === "_parent" ||
+        key === "_uniqueId" ||
+        key === "_type" ||
+        key === "_refs" ||
+        key === "id" ||
+        key === "_id");
+};
+export const isValidKey = (common, key) => {
+    const prop = get(common, key);
+    return (key !== "_gedcom" &&
+        key !== "_main" &&
+        key !== "_parent" &&
+        key !== "_uniqueId" &&
+        key !== "_refs" &&
+        key !== "_type" &&
+        (key === "id" ||
+            key === "_id" ||
+            key === "value" ||
+            key === "_value" ||
+            prop instanceof Common ||
+            prop instanceof List));
+};
+export const getValidKeys = (common) => {
+    return Object.keys(common).filter((key) => {
+        return isValidKey(common, key);
+    });
+};
+export const getValidTag = (tag) => {
+    return tag.replace(/^@@/, "");
+};
+export const getListTag = (tag) => {
+    return `@@${tag}`;
+};
+export const getValidKey = (tag, id) => {
+    return `${id} ${getValidTag(tag)}`;
+};
+export const isId = (string) => {
+    return ID_REG.test(string);
+};
+export const idGetter = (id) => {
+    if (id === undefined) {
+        return undefined;
+    }
+    let newId = `${id}`;
+    const parts = newId?.match(ID_GETTER_REG)?.groups;
+    if (!parts?.at && !parts?.letter) {
+        newId = `@U${newId}`;
+    }
+    else if (!parts.at) {
+        newId = `@${newId}`;
+    }
+    else if (!parts.letter) {
+        newId = newId.replace(/^@/, "@U");
+    }
+    if (!newId.endsWith("@")) {
+        newId = `${newId}@`;
+    }
+    return newId;
+};

package/dist/classes/date.d.ts

@@ -0,0 +1,26 @@
+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;
+    assign<T extends Common | List = Common | List>(name: MultiTag, value: T, unique?: boolean): T;
+    private isValidDateFormat;
+    toNote(short?: boolean): string | undefined;
+    toValue(dateFormat?: string): string | undefined;
+    exportValue(): string;
+    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":"AAEA,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,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAkDnC,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,SAEX;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,CAAC,UAAU,SAAgB,GAAG,MAAM,GAAG,SAAS;IAsBvD,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"}