@treeviz/gedcom-parser 2.0.12 → 2.1.0

package/dist/utils/local-media.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Optional resolvers for local / cached media (GEDZIP paths, IndexedDB, etc.).
+ * The visualiser injects storage lookups; the parser stays host-agnostic.
+ */
+export type LocalMediaResolver = (path: string) => Promise<string | undefined> | string | undefined;
+export type MediaContentLookup = {
+    url?: string;
+    id?: string;
+    imgId?: string;
+    key?: string;
+    contentType?: string;
+};
+export type MediaContentResult = {
+    content: string;
+    contentType?: string;
+};
+export type MediaContentResolver = (media: MediaContentLookup) => Promise<MediaContentResult | undefined> | MediaContentResult | undefined;
+export declare const setLocalMediaResolver: (resolver?: LocalMediaResolver) => void;
+export declare const setMediaContentResolver: (resolver?: MediaContentResolver) => void;
+export declare const isRemoteOrEmbeddedMediaUrl: (path?: string) => boolean;
+/**
+ * Resolve a FILE payload to a browser-displayable URL when possible.
+ * Leaves http(s)/data/blob URLs unchanged; asks the injected resolver for local paths.
+ */
+export declare const resolveLocalMediaUrl: (path?: string) => Promise<string | undefined>;
+/**
+ * Resolve media bytes for GEDZIP export: host cache → local path → data URL → fetch.
+ */
+export declare const resolveMediaContent: (media: MediaContentLookup) => Promise<MediaContentResult | undefined>;
+//# sourceMappingURL=local-media.d.ts.map

package/dist/utils/local-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-media.d.ts","sourceRoot":"","sources":["../../src/utils/local-media.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAChC,IAAI,EAAE,MAAM,KACR,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAClC,KAAK,EAAE,kBAAkB,KAEvB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,GACvC,kBAAkB,GAClB,SAAS,CAAC;AAKb,eAAO,MAAM,qBAAqB,GAAI,WAAW,kBAAkB,SAElE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,WAAW,oBAAoB,SAEtE,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,OAAO,MAAM,YASvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAU,OAAO,MAAM,gCAUvD,CAAC;AAiBF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC/B,OAAO,kBAAkB,KACvB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAwCxC,CAAC"}

package/dist/utils/media-utils.d.ts

@@ -1,13 +1,17 @@
 /**
- * Get file extension from filename
- * @param filename - The filename to extract extension from
- * @returns File extension without the dot, or empty string if no extension
+ * Get file extension from a filename, URL, or data URL.
  */
+import type { MultiTag } from "../types/types";
 export declare const getFileExtension: (filename: string) => string;
 /**
- * Check if a file format is an image format
- * @param format - The file format/extension to check
- * @returns true if the format is a supported image format
+ * Check if a file format is an image format.
+ * Accepts extensions (`jpg`), MIME subtypes, or full `data:image/...` URLs.
  */
 export declare const isImageFormat: (format: string) => boolean;
+/** Resolve FORM / media type from flat (5.5.1) or nested (GEDCOM 7) OBJE. */
+export declare const resolveObjeForm: (obje?: {
+    get?: (path: MultiTag) => {
+        toValue?: () => unknown;
+    } | undefined;
+}) => string | undefined;
 //# sourceMappingURL=media-utils.d.ts.map

package/dist/utils/media-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-utils.d.ts","sourceRoot":"","sources":["../../src/utils/media-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAGnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,OAc9C,CAAC"}
+{"version":3,"file":"media-utils.d.ts","sourceRoot":"","sources":["../../src/utils/media-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAenD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,OAyB9C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,eAAe,GAAI,OAAO;IACtC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK;QAAE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CAClE,KAAG,MAAM,GAAG,SAKZ,CAAC"}

package/dist/utils/multimedia.d.ts

@@ -0,0 +1,38 @@
+import type { MediaList } from "../interfaces/indi";
+import type { IndiKey, ObjeKey } from "../types/types";
+import type { GedcomExportVersion } from "./gedcom-version";
+export type CreateMultimediaInput = {
+    /** FILE payload: URL or relative GEDZIP path. */
+    file: string;
+    /** Format / extension (jpg, png, …). Inferred from `file` when omitted. */
+    form?: string;
+    title?: string;
+    /**
+     * GEDCOM 7 `FILE.FORM.TYPE` (e.g. `photo`, `audio`, `video`, `document`).
+     * Written only for GEDCOM 7 nesting.
+     */
+    mediType?: string;
+    primary?: boolean;
+    /**
+     * Structure style for the OBJE record. Defaults to the dataset HEAD version
+     * (or 5.5.1).
+     */
+    gedcomVersion?: GedcomExportVersion | string;
+};
+export type AttachMultimediaOptions = {
+    primary?: boolean;
+};
+export type CollectMultimediaOptions = {
+    indiIds?: IndiKey[];
+    namespace?: string | number;
+};
+/**
+ * Infer a short FORM token from a path/URL (best-effort).
+ */
+export declare const inferMediaForm: (file: string, fallback?: string) => string;
+/**
+ * Merge MediaList maps (later entries overwrite same keys).
+ */
+export declare const mergeMediaLists: (...lists: Array<MediaList | undefined>) => MediaList;
+export declare const isObjePointer: (value: unknown) => value is ObjeKey;
+//# sourceMappingURL=multimedia.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multimedia.d.ts","sourceRoot":"","sources":["../../src/utils/multimedia.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,MAAM,MAAM,qBAAqB,GAAG;IACnC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,iBAAgB,WAO5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,GAAG,OAAO,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,cAOrE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OACJ,CAAC"}

package/dist/utils/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/utils/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,mBAAmB,CAAC;AAgB7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAuB,QAAQ,EAAW,MAAM,gBAAgB,CAAC;AA4D7E,QAAA,MAAM,UAAU;qBAEL,MAAM,YACL;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;8BAK3C,MAAM,YACL;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;oBAkThD,MAAM,QACJ,QAAQ,UACN,MAAM,QACR,MAAM;CAuBb,CAAC;AAOF,eAAe,UAAU,CAAC;AAE1B,eAAO,MAAM,iBAAiB,GAAI,UAAU;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,4BAchE,CAAC"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/utils/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,mBAAmB,CAAC;AAgB7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAuB,QAAQ,EAAW,MAAM,gBAAgB,CAAC;AA4D7E,QAAA,MAAM,UAAU;qBAEL,MAAM,YACL;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;8BAK3C,MAAM,YACL;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;oBA6ThD,MAAM,QACJ,QAAQ,UACN,MAAM,QACR,MAAM;CAuBb,CAAC;AAOF,eAAe,UAAU,CAAC;AAE1B,eAAO,MAAM,iBAAiB,GAAI,UAAU;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,4BAchE,CAAC"}

package/dist/utils/uid.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GEDCOM 7 UID (UUID) helpers.
+ * Spec: each record may carry `n UID <uuid>`.
+ */
+export declare const createGedcomUid: () => string;
+//# sourceMappingURL=uid.d.ts.map

package/dist/utils/uid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.d.ts","sourceRoot":"","sources":["../../src/utils/uid.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,eAAe,QAAO,MAalC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@treeviz/gedcom-parser",
-	"version": "2.0.12",
+	"version": "2.1.0",
 	"description": "Lightweight, pluggable GEDCOM parser for JavaScript/TypeScript with optional caching and place matching. Zero browser dependencies.",
 	"type": "module",
 	"main": "dist/index.js",
@@ -149,6 +149,7 @@
 		"chalk": "^5.6.2",
 		"commander": "^14.0.2",
 		"date-fns": "^2.30.0",
+		"jszip": "^3.10.1",
 		"lodash-es": "^4.17.22"
 	},
 	"devDependencies": {