exiftool-vendored 29.3.0 → 30.0.0

package/CHANGELOG.md

@@ -25,6 +25,18 @@ vendored versions of ExifTool match the version that they vendor.
 
 ## Version history
 
+### v30.0.0
+
+- 💔 Dropped support for Node v18, whose End-of-Life was 2025-04-30.
+
+- 🌱 Upgraded ExifTool to version [13.29](https://exiftool.org/history.html#13.29).
+
+- ✨ Added new `TagNames` string enumeration with the most popular 2,500(ish) tag field names that is automatically updated by `mktags`. As a reminder: the `Tags` interface _is not comprehensive_. If we're missing any of your favorite fields, open an issue with an attached example media file and I look into promoting it to a "guaranteed" status (like we've done with several hundred fields already).
+
+- 📦 Renamed the `.tz` field in `Tags` to `.zone`. Note that for the next few releases, `.tz` will be kept, but marked as deprecated. After doing a bit of research, it turns out the correct term for identifiers like `America/Los_Angeles` within the IANA Time Zone Database is "zone." The "tz" term commonly refers to the entire Time Zone Database, or "tz database" (also called tzdata or zoneinfo).
+
+- ✨ Updating to new versions of ExifTool is now fully automated via GitHub Actions.
+
 ### v29.3.0
 
 - 🌱 Upgraded ExifTool to version [13.26](https://exiftool.org/history.html#13.26).

package/CLAUDE.md

@@ -0,0 +1,131 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This is exiftool-vendored.js, a Node.js library that provides cross-platform access to ExifTool for reading and writing metadata in photos and videos. The library includes comprehensive TypeScript type definitions for metadata tags and is used by PhotoStructure and 500+ other projects.
+
+## Key Commands
+
+### Building & Development
+
+```bash
+# Install dependencies
+npm install
+
+# Compile TypeScript to JavaScript
+npm run compile
+
+# Watch mode for development
+npm run compile:watch
+
+# Clean build artifacts
+npm run clean
+```
+
+### Linting & Formatting
+
+```bash
+# Run ESLint with TypeScript configuration
+npm run lint
+
+# Format all TypeScript and other files with Prettier
+npm run fmt
+```
+
+### Testing
+
+```bash
+# Run all tests (requires compilation first)
+npm test
+
+# Note: Tests use Mocha and execute the compiled JavaScript files in dist/
+```
+
+### Documentation
+
+```bash
+# Generate TypeDoc documentation
+npm run docs
+
+# This runs the typedoc tool and serves the documentation locally
+```
+
+### Tag Generation
+
+```bash
+# Regenerate src/Tags.ts from sample images
+npm run mktags ../path/to/images
+
+# This requires a directory of sample images to analyze and extract metadata tags
+```
+
+## Architecture & Key Concepts
+
+### Core Components
+
+1. **ExifTool Class** (`src/ExifTool.ts`): Main entry point that wraps ExifTool process management using batch-cluster. Provides methods for reading metadata, writing tags, extracting binaries, and rewriting tags.
+
+2. **Tags Interface** (`src/Tags.ts`): Auto-generated TypeScript interface containing ~2000 metadata fields commonly found in photo/video files. Generated by analyzing thousands of sample files to avoid TypeScript union type limits. Fields include popularity ratings and example values.
+
+3. **Date/Time Handling**: Custom classes for handling EXIF dates with timezone complexities:
+
+   - `ExifDate`: Date without time
+   - `ExifTime`: Time without date
+   - `ExifDateTime`: Date and time with optional timezone
+
+4. **Task System**: Various task classes for different operations:
+
+   - `ReadTask`: Read metadata from files
+   - `WriteTask`: Write metadata to files
+   - `BinaryExtractionTask`: Extract thumbnails/previews
+   - `RewriteAllTagsTask`: Repair corrupt metadata
+
+5. **Platform Support**: Includes platform-specific ExifTool binaries via optional dependencies:
+   - `exiftool-vendored.exe` for Windows
+   - `exiftool-vendored.pl` for Unix-like systems
+
+### Timezone Handling
+
+The library implements sophisticated timezone heuristics to handle underspecified date metadata:
+
+1. Uses explicit timezone metadata if available
+2. Falls back to GPS location for timezone inference
+3. Uses UTC timestamp deltas to infer timezone offsets
+4. Handles edge cases like daylight saving time transitions
+
+### Tag Generation Process
+
+The `mktags.ts` script analyzes sample images to generate TypeScript interfaces:
+
+1. Scans image directories for various formats (JPEG, RAW, video)
+2. Extracts metadata using ExifTool
+3. Counts tag frequencies and value types
+4. Generates strongly-typed interfaces for the most common ~2000 tags
+5. Includes popularity ratings (★★★★ = >50% of samples)
+
+### Testing Approach
+
+Tests use Mocha with Chai assertions:
+
+- Unit tests for individual components (dates, parsers, etc.)
+- Integration tests for ExifTool operations
+- Test images in the `test/` directory cover various edge cases
+- Includes non-English filename tests
+
+## Important Notes
+
+- Always run `npm run compile` before testing
+- The singleton `exiftool` instance must be properly ended with `.end()` to clean up child processes
+- Tag interfaces are not comprehensive - less common tags may exist in returned objects
+- The library uses batch processing for performance, managing process pools automatically
+- TypeScript's union type limits require careful tag selection to avoid compilation errors
+
+## Important TypeScript Hygiene
+
+- You MUST use `if (x != null)` to test for `null` or `undefined` values.
+  DO NOT use `if (x)`: this is problematic (especially when handling boolean values).
+
+- You MUST use `??` for nullish coalescing.
+  DO NOT use `||`: this is problematic (especially when handling boolean values).

package/RELEASE.md

@@ -11,9 +11,9 @@
 
 4. On POSIX, in `../exiftool-vendored.pl`:
 
-   1. `git stash -u && git fetch && git checkout main && npm install && npm run update && npm run test`
-   1. Verify diffs are reasonable, and commit
-   1. `npx release-it --only-version`
+   1. Run the "check-updates" GitHub Action. If there is a pending update, a PR is generated.
+   1. Verify and merge the PR
+   1. Run the "release" GitHub Action.
 
 5. On Windows, in `...\exiftool-vendored.exe\`:
    (The terminal built into vscode plays with `ncu` and `release-it` a bit nicer than CMD or Windows for Git's terminal)

package/dist/Array.d.ts

@@ -1,8 +1,8 @@
-import { Maybe, MaybeNull } from "./Maybe";
+import { Maybe, Nullable } from "./Maybe";
 export declare function isIterable(obj: unknown): obj is Iterable<unknown>;
 export declare function ifArray<T = unknown>(arr: T[] | unknown): Maybe<T[]>;
 export declare function toArray<T>(arr: undefined | null | T[] | T | Iterable<T>): T[];
-export declare function compact<T>(array: MaybeNull<T>[]): T[];
+export declare function compact<T>(array: Nullable<T>[]): T[];
 /**
  * Remove all elements from the given array that return false from the given
  * predicate `filter`.

package/dist/Array.js.map

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

package/dist/ExifToolVendoredTags.d.ts

@@ -1,4 +1,5 @@
 import { ErrorsAndWarnings } from "./ErrorsAndWarnings";
+import { StrEnum, StrEnumKeys } from "./StrEnum";
 /**
  * This tags are added to {@link Tags} from this library.
  */
@@ -8,16 +9,25 @@ export interface ExifToolVendoredTags extends ErrorsAndWarnings {
      * `America/Los_Angeles`.
      *
      * This will be missing if we can't intuit a timezone from the metadata.
+     * @deprecated use `zone` instead
      */
     tz?: string;
+    /**
+     * The IANA timezone, like `America/Los_Angeles`, or a IANA-rendered static offset, like `UTC-7`.
+     *
+     * This will be missing if we can't intuit a timezone from the metadata.
+     */
+    zone?: string;
     /**
      * Description of where and how `tz` was extracted
+     * @deprecated use `zoneSource` instead
      */
     tzSource?: string;
+    /**
+     * Description of where and how `zone` was extracted
+     */
+    zoneSource?: string;
 }
-export declare const ExifToolVendoredTagNames: (keyof ExifToolVendoredTags)[];
-/**
- * Is the given tag name intrinsic to the content of a given file? In other
- * words, is it not an artifact of a metadata field?
- */
+export declare const ExifToolVendoredTagNames: StrEnum<"zone" | "tz" | "tzSource" | "zoneSource" | "errors" | "warnings">;
+export type ExifToolVendoredTagName = StrEnumKeys<typeof ExifToolVendoredTagNames>;
 export declare function isExifToolVendoredTag(name: string): name is keyof ExifToolVendoredTags;

package/dist/ExifToolVendoredTags.js

@@ -2,17 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExifToolVendoredTagNames = void 0;
 exports.isExifToolVendoredTag = isExifToolVendoredTag;
-const Object_1 = require("./Object");
-exports.ExifToolVendoredTagNames = (0, Object_1.keysOf)({
-    tz: true,
-    tzSource: true,
-    errors: true,
-    warnings: true,
-});
-/**
- * Is the given tag name intrinsic to the content of a given file? In other
- * words, is it not an artifact of a metadata field?
- */
+const StrEnum_1 = require("./StrEnum");
+exports.ExifToolVendoredTagNames = (0, StrEnum_1.strEnum)("tz", "zone", "tzSource", "zoneSource", "errors", "warnings");
 function isExifToolVendoredTag(name) {
     return exports.ExifToolVendoredTagNames.includes(name);
 }

package/dist/ExifToolVendoredTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExifToolVendoredTags.js","sourceRoot":"","sources":["../src/ExifToolVendoredTags.ts"],"names":[],"mappings":";;;AAgCA,sDAIC;AAnCD,qCAAkC;AAoBrB,QAAA,wBAAwB,GAAG,IAAA,eAAM,EAAuB;IACnE,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;CACf,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,IAAY;IAEZ,OAAO,gCAAwB,CAAC,QAAQ,CAAC,IAAkC,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"ExifToolVendoredTags.js","sourceRoot":"","sources":["../src/ExifToolVendoredTags.ts"],"names":[],"mappings":";;;AAgDA,sDAIC;AAnDD,uCAA0D;AAkC7C,QAAA,wBAAwB,GAAG,IAAA,iBAAO,EAC7C,IAAI,EACJ,MAAM,EACN,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,CACmC,CAAC;AAMhD,SAAgB,qBAAqB,CACnC,IAAY;IAEZ,OAAO,gCAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/GeolocationTags.d.ts

@@ -1,9 +1,4 @@
-export declare const GeolocationTagNames: (keyof GeolocationTags)[];
-/**
- * Is the given tag name intrinsic to the content of a given file? In other
- * words, is it not an artifact of a metadata field?
- */
-export declare function isGeolocationTag(name: string): name is keyof GeolocationTags;
+import { StrEnum, StrEnumKeys } from "./StrEnum";
 /**
  * These tags are only available if {@link ExifToolOptions.geolocation} is true
  * and the file has valid GPS location data.
@@ -45,3 +40,6 @@ export interface GeolocationTags {
     GeolocationTimeZone?: string;
     GeolocationWarning?: string;
 }
+export declare const GeolocationTagNames: StrEnum<"GeolocationBearing" | "GeolocationCity" | "GeolocationCountry" | "GeolocationCountryCode" | "GeolocationDistance" | "GeolocationFeatureCode" | "GeolocationFeatureType" | "GeolocationPopulation" | "GeolocationPosition" | "GeolocationRegion" | "GeolocationSubregion" | "GeolocationTimeZone" | "GeolocationWarning">;
+export type GeolocationTagName = StrEnumKeys<typeof GeolocationTagNames>;
+export declare function isGeolocationTag(name: string): name is keyof GeolocationTags;

package/dist/GeolocationTags.js

@@ -2,26 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GeolocationTagNames = void 0;
 exports.isGeolocationTag = isGeolocationTag;
-const Object_1 = require("./Object");
-exports.GeolocationTagNames = (0, Object_1.keysOf)({
-    GeolocationBearing: true,
-    GeolocationCity: true,
-    GeolocationCountry: true,
-    GeolocationCountryCode: true,
-    GeolocationDistance: true,
-    GeolocationFeatureCode: true,
-    GeolocationFeatureType: true,
-    GeolocationPopulation: true,
-    GeolocationPosition: true,
-    GeolocationRegion: true,
-    GeolocationSubregion: true,
-    GeolocationTimeZone: true,
-    GeolocationWarning: true,
-});
-/**
- * Is the given tag name intrinsic to the content of a given file? In other
- * words, is it not an artifact of a metadata field?
- */
+const StrEnum_1 = require("./StrEnum");
+exports.GeolocationTagNames = (0, StrEnum_1.strEnum)("GeolocationBearing", "GeolocationCity", "GeolocationCountry", "GeolocationCountryCode", "GeolocationDistance", "GeolocationFeatureCode", "GeolocationFeatureType", "GeolocationPopulation", "GeolocationPosition", "GeolocationRegion", "GeolocationSubregion", "GeolocationTimeZone", "GeolocationWarning");
 function isGeolocationTag(name) {
     return exports.GeolocationTagNames.includes(name);
 }

package/dist/GeolocationTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeolocationTags.js","sourceRoot":"","sources":["../src/GeolocationTags.ts"],"names":[],"mappings":";;;AAsBA,4CAEC;AAxBD,qCAAkC;AAErB,QAAA,mBAAmB,GAAG,IAAA,eAAM,EAAkB;IACzD,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,IAAI;IAC5B,mBAAmB,EAAE,IAAI;IACzB,sBAAsB,EAAE,IAAI;IAC5B,sBAAsB,EAAE,IAAI;IAC5B,qBAAqB,EAAE,IAAI;IAC3B,mBAAmB,EAAE,IAAI;IACzB,iBAAiB,EAAE,IAAI;IACvB,oBAAoB,EAAE,IAAI;IAC1B,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,IAAI;CACzB,CAAqC,CAAC;AAEvC;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,2BAAmB,CAAC,QAAQ,CAAC,IAA6B,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"GeolocationTags.js","sourceRoot":"","sources":["../src/GeolocationTags.ts"],"names":[],"mappings":";;;AA8DA,4CAEC;AAhED,uCAA0D;AA4C7C,QAAA,mBAAmB,GAAG,IAAA,iBAAO,EACxC,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,CACoB,CAAC;AAI3C,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,2BAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/ICCProfileTags.d.ts

@@ -1,3 +1,4 @@
+import { StrEnum, StrEnumKeys } from "./StrEnum";
 /**
  * Subset of <https://exiftool.org/TagNames/ICC_Profile.html>.
  *
@@ -23,3 +24,6 @@ export interface ICCProfileTags {
     /** ☆☆☆☆ ✔ Example: "sRGB v1.31 (Canon)" */
     ProfileDescription?: string;
 }
+export declare const ICCProfileTagNames: StrEnum<"ColorSpaceData" | "ConnectionSpaceIlluminant" | "DeviceAttributes" | "DeviceManufacturer" | "DeviceMfgDesc" | "DeviceModel" | "DeviceModelDesc" | "Luminance" | "ProfileDescription">;
+export type ICCProfileTagName = StrEnumKeys<typeof ICCProfileTagNames>;
+export declare function isICCProfileTag(name: string): name is keyof ICCProfileTags;

package/dist/ICCProfileTags.js

@@ -1,3 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ICCProfileTagNames = void 0;
+exports.isICCProfileTag = isICCProfileTag;
+const StrEnum_1 = require("./StrEnum");
+exports.ICCProfileTagNames = (0, StrEnum_1.strEnum)("ColorSpaceData", "ConnectionSpaceIlluminant", "DeviceAttributes", "DeviceManufacturer", "DeviceMfgDesc", "DeviceModel", "DeviceModelDesc", "Luminance", "ProfileDescription");
+function isICCProfileTag(name) {
+    return exports.ICCProfileTagNames.includes(name);
+}
 //# sourceMappingURL=ICCProfileTags.js.map

package/dist/ICCProfileTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"ICCProfileTags.js","sourceRoot":"","sources":["../src/ICCProfileTags.ts"],"names":[],"mappings":""}
+{"version":3,"file":"ICCProfileTags.js","sourceRoot":"","sources":["../src/ICCProfileTags.ts"],"names":[],"mappings":";;;AA0CA,0CAEC;AA5CD,uCAA0D;AA4B7C,QAAA,kBAAkB,GAAG,IAAA,iBAAO,EACvC,gBAAgB,EAChB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,oBAAoB,CACmB,CAAC;AAI1C,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,0BAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/IPTCApplicationRecordTags.d.ts

@@ -1,6 +1,7 @@
 import { ExifDate } from "./ExifDate";
 import { ExifDateTime } from "./ExifDateTime";
 import { ExifTime } from "./ExifTime";
+import { StrEnum, StrEnumKeys } from "./StrEnum";
 /**
  * IPTC (International Press Telecommunications Council) defines a set of
  * metadata tags that can be embedded into image files, but _they came up with
@@ -79,3 +80,9 @@ export interface IPTCApplicationRecordTags {
     DocumentHistory?: string;
     ExifCameraInfo?: string;
 }
+export declare const IPTCApplicationRecordTagNames: StrEnum<"ApplicationRecordVersion" | "ObjectTypeReference" | "ObjectAttributeReference" | "ObjectName" | "EditStatus" | "EditorialUpDate" | "Urgency" | "SubjectReference" | "Category" | "SupplementalCategories" | "FixtureIdentifier" | "ContentLocationCode" | "ContentLocationName" | "ReleaseDate" | "ReleaseTime" | "ExpirationDate" | "ExpirationTime" | "SpecialInstructions" | "ActionAdvised" | "ReferenceService" | "ReferenceDate" | "ReferenceNumber" | "OriginatingProgram" | "ProgramVersion" | "ObjectCycle" | "By-line" | "By-lineTitle" | "City" | "Sub-location" | "Province-State" | "Country-PrimaryLocationCode" | "Country-PrimaryLocationName" | "OriginalTransmissionReference" | "Headline" | "Credit" | "Source" | "CopyrightNotice" | "Contact" | "Caption-Abstract" | "LocalCaption" | "Writer-Editor" | "ImageType" | "ImageOrientation" | "LanguageIdentifier" | "AudioType" | "AudioSamplingRate" | "AudioSamplingResolution" | "AudioDuration" | "AudioOutcue" | "JobID" | "MasterDocumentID" | "ShortDocumentID" | "UniqueDocumentID" | "OwnerID" | "ObjectPreviewFileFormat" | "ObjectPreviewFileVersion" | "Prefs" | "ClassifyState" | "SimilarityIndex" | "DocumentNotes" | "DocumentHistory" | "ExifCameraInfo">;
+export type IPTCApplicationRecordTagName = StrEnumKeys<typeof IPTCApplicationRecordTagNames>;
+/**
+ * Is the given tag name an IPTC application record tag?
+ */
+export declare function isIPTCApplicationRecordTag(name: string): name is keyof IPTCApplicationRecordTags;

package/dist/IPTCApplicationRecordTags.js

@@ -1,3 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.IPTCApplicationRecordTagNames = void 0;
+exports.isIPTCApplicationRecordTag = isIPTCApplicationRecordTag;
+const StrEnum_1 = require("./StrEnum");
+exports.IPTCApplicationRecordTagNames = (0, StrEnum_1.strEnum)("ApplicationRecordVersion", "ObjectTypeReference", "ObjectAttributeReference", "ObjectName", "EditStatus", "EditorialUpDate", "Urgency", "SubjectReference", "Category", "SupplementalCategories", "FixtureIdentifier", "ContentLocationCode", "ContentLocationName", "ReleaseDate", "ReleaseTime", "ExpirationDate", "ExpirationTime", "SpecialInstructions", "ActionAdvised", "ReferenceService", "ReferenceDate", "ReferenceNumber", "OriginatingProgram", "ProgramVersion", "ObjectCycle", "By-line", "By-lineTitle", "City", "Sub-location", "Province-State", "Country-PrimaryLocationCode", "Country-PrimaryLocationName", "OriginalTransmissionReference", "Headline", "Credit", "Source", "CopyrightNotice", "Contact", "Caption-Abstract", "LocalCaption", "Writer-Editor", "ImageType", "ImageOrientation", "LanguageIdentifier", "AudioType", "AudioSamplingRate", "AudioSamplingResolution", "AudioDuration", "AudioOutcue", "JobID", "MasterDocumentID", "ShortDocumentID", "UniqueDocumentID", "OwnerID", "ObjectPreviewFileFormat", "ObjectPreviewFileVersion", "Prefs", "ClassifyState", "SimilarityIndex", "DocumentNotes", "DocumentHistory", "ExifCameraInfo");
+/**
+ * Is the given tag name an IPTC application record tag?
+ */
+function isIPTCApplicationRecordTag(name) {
+    return exports.IPTCApplicationRecordTagNames.includes(name);
+}
 //# sourceMappingURL=IPTCApplicationRecordTags.js.map

package/dist/IPTCApplicationRecordTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPTCApplicationRecordTags.js","sourceRoot":"","sources":["../src/IPTCApplicationRecordTags.ts"],"names":[],"mappings":""}
+{"version":3,"file":"IPTCApplicationRecordTags.js","sourceRoot":"","sources":["../src/IPTCApplicationRecordTags.ts"],"names":[],"mappings":";;;AA4JA,gEAIC;AA7JD,uCAA0D;AAiF7C,QAAA,6BAA6B,GAAG,IAAA,iBAAO,EAClD,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,cAAc,EACd,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,6BAA6B,EAC7B,6BAA6B,EAC7B,+BAA+B,EAC/B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,yBAAyB,EACzB,0BAA0B,EAC1B,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,CACkC,CAAC;AAMrD;;GAEG;AACH,SAAgB,0BAA0B,CACxC,IAAY;IAEZ,OAAO,qCAA6B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/dist/ImageDataHashTag.d.ts

@@ -1,3 +1,4 @@
+import { StrEnum, StrEnumKeys } from "./StrEnum";
 export interface ImageDataHashTag {
     /**
      * This is calculated by ExifTool to be the MD5, SHA256, or SHA512 hash of
@@ -11,3 +12,6 @@ export interface ImageDataHashTag {
      */
     ImageDataHash?: string;
 }
+export declare const ImageDataHashTagNames: StrEnum<"ImageDataHash">;
+export type ImageDataHashTagName = StrEnumKeys<typeof ImageDataHashTagNames>;
+export declare function isImageDataHashTag(name: string): name is keyof ImageDataHashTag;

package/dist/ImageDataHashTag.js

@@ -1,3 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageDataHashTagNames = void 0;
+exports.isImageDataHashTag = isImageDataHashTag;
+const StrEnum_1 = require("./StrEnum");
+exports.ImageDataHashTagNames = (0, StrEnum_1.strEnum)("ImageDataHash");
+function isImageDataHashTag(name) {
+    return exports.ImageDataHashTagNames.includes(name);
+}
 //# sourceMappingURL=ImageDataHashTag.js.map

package/dist/ImageDataHashTag.js.map

@@ -1 +1 @@
-{"version":3,"file":"ImageDataHashTag.js","sourceRoot":"","sources":["../src/ImageDataHashTag.ts"],"names":[],"mappings":""}
+{"version":3,"file":"ImageDataHashTag.js","sourceRoot":"","sources":["../src/ImageDataHashTag.ts"],"names":[],"mappings":";;;AAsBA,gDAIC;AA1BD,uCAA0D;AAgB7C,QAAA,qBAAqB,GAAG,IAAA,iBAAO,EAAC,eAAe,CAE3D,CAAC;AAIF,SAAgB,kBAAkB,CAChC,IAAY;IAEZ,OAAO,6BAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/MWGTags.d.ts

@@ -1,3 +1,4 @@
+import { StrEnum, StrEnumKeys } from "./StrEnum";
 export interface KeywordInfoStruct {
     Hierarchy?: KeywordStruct[];
 }
@@ -25,3 +26,15 @@ export interface CollectionInfo {
 export interface MWGCollectionsTags {
     Collections?: CollectionInfo[];
 }
+export declare const MWGKeywordTagNames: StrEnum<"KeywordInfo" | "HierarchicalKeywords">;
+export type MWGKeywordTagName = StrEnumKeys<typeof MWGKeywordTagNames>;
+/**
+ * Is the given tag name an MWG keyword tag?
+ */
+export declare function isMWGKeywordTag(name: string): name is keyof MWGKeywordTags;
+export declare const MWGCollectionsTagNames: StrEnum<"Collections">;
+export type MWGCollectionsTagName = StrEnumKeys<typeof MWGCollectionsTagNames>;
+/**
+ * Is the given tag name an MWG collections tag?
+ */
+export declare function isMWGCollectionsTag(name: string): name is keyof MWGCollectionsTags;

package/dist/MWGTags.js

@@ -1,3 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MWGCollectionsTagNames = exports.MWGKeywordTagNames = void 0;
+exports.isMWGKeywordTag = isMWGKeywordTag;
+exports.isMWGCollectionsTag = isMWGCollectionsTag;
+const StrEnum_1 = require("./StrEnum");
+exports.MWGKeywordTagNames = (0, StrEnum_1.strEnum)("KeywordInfo", "HierarchicalKeywords");
+/**
+ * Is the given tag name an MWG keyword tag?
+ */
+function isMWGKeywordTag(name) {
+    return exports.MWGKeywordTagNames.includes(name);
+}
+exports.MWGCollectionsTagNames = (0, StrEnum_1.strEnum)("Collections");
+/**
+ * Is the given tag name an MWG collections tag?
+ */
+function isMWGCollectionsTag(name) {
+    return exports.MWGCollectionsTagNames.includes(name);
+}
 //# sourceMappingURL=MWGTags.js.map

package/dist/MWGTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"MWGTags.js","sourceRoot":"","sources":["../src/MWGTags.ts"],"names":[],"mappings":""}
+{"version":3,"file":"MWGTags.js","sourceRoot":"","sources":["../src/MWGTags.ts"],"names":[],"mappings":";;;AA4CA,0CAEC;AAWD,kDAIC;AA7DD,uCAA0D;AAkC7C,QAAA,kBAAkB,GAAG,IAAA,iBAAO,EACvC,aAAa,EACb,sBAAsB,CACiB,CAAC;AAI1C;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,0BAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAEY,QAAA,sBAAsB,GAAG,IAAA,iBAAO,EAAC,aAAa,CAE1D,CAAC;AAIF;;GAEG;AACH,SAAgB,mBAAmB,CACjC,IAAY;IAEZ,OAAO,8BAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/Maybe.d.ts

@@ -1,7 +1,8 @@
 export type Maybe<T> = T | undefined;
-export type MaybeNull<T> = Maybe<T> | null;
-export declare function map<T, U>(maybeT: MaybeNull<T>, f: (t: T) => U): Maybe<U>;
-export declare function map2<A, B, U>(a: MaybeNull<A>, b: MaybeNull<B>, f: (a: A, b: B) => U): Maybe<U>;
+export type Nullable<T> = T | undefined | null;
+export type MaybeNull<T> = Nullable<T>;
+export declare function map<T, U>(maybeT: Nullable<T>, f: (t: T) => U): Maybe<U>;
+export declare function map2<A, B, U>(a: Nullable<A>, b: Nullable<B>, f: (a: A, b: B) => U): Maybe<U>;
 export declare function first<T, U>(iter: Iterable<Maybe<T>>, f: (t: T) => Maybe<U>): Maybe<U>;
 export declare function firstDefinedThunk<T>(iter: Iterable<() => Maybe<T>>): Maybe<T>;
 /**

package/dist/Maybe.js.map

@@ -1 +1 @@
-{"version":3,"file":"Maybe.js","sourceRoot":"","sources":["../src/Maybe.ts"],"names":[],"mappings":";;AAGA,kBAEC;AAED,oBAMC;AAED,sBAWC;AAED,8CAMC;AAKD,wBAEC;AAtCD,SAAgB,GAAG,CAAO,MAAoB,EAAE,CAAc;IAC5D,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,IAAI,CAClB,CAAe,EACf,CAAe,EACf,CAAoB;IAEpB,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,KAAK,CACnB,IAAwB,EACxB,CAAqB;IAErB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,IAAI;gBAAE,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO;AACT,CAAC;AAED,SAAgB,iBAAiB,CAAI,IAA8B;IACjE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO,MAAM,CAAC;IACpC,CAAC;IACD,OAAO;AACT,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAI,CAAW;IACnC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"Maybe.js","sourceRoot":"","sources":["../src/Maybe.ts"],"names":[],"mappings":";;AAIA,kBAEC;AAED,oBAMC;AAED,sBAWC;AAED,8CAMC;AAKD,wBAEC;AAtCD,SAAgB,GAAG,CAAO,MAAmB,EAAE,CAAc;IAC3D,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,IAAI,CAClB,CAAc,EACd,CAAc,EACd,CAAoB;IAEpB,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,KAAK,CACnB,IAAwB,EACxB,CAAqB;IAErB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,IAAI;gBAAE,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO;AACT,CAAC;AAED,SAAgB,iBAAiB,CAAI,IAA8B;IACjE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO,MAAM,CAAC;IACpC,CAAC;IACD,OAAO;AACT,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAI,CAAW;IACnC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/Object.d.ts

@@ -1,8 +1,14 @@
-import { Maybe } from "./Maybe";
+import { Nullable } from "./Maybe";
 export declare function isObject(obj: unknown): obj is object;
 export declare function keys<T extends object, K extends string & keyof T>(o: T): K[];
 export declare function isFunction(obj: unknown): obj is (...args: unknown[]) => unknown;
-export declare function fromEntries(arr: Maybe<[Maybe<string>, unknown]>[], obj?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Turns an array of `[key, value]` pairs into an object.
+ *
+ *  • Pairs whose key is `null | undefined` **or** value is `undefined` are skipped.
+ *  • If `base` is provided it is mutated and returned (handy for “extend” use‑cases).
+ */
+export declare function fromEntries<K extends PropertyKey, V = unknown>(pairs: Nullable<Nullable<[Nullable<K>, V]>[]>, base?: Record<K, V>): Record<K, V>;
 export type Unpick<T, U> = {
     [P in keyof T]: P extends U ? never : T[P];
 };

package/dist/Object.js

@@ -17,22 +17,22 @@ function keys(o) {
 function isFunction(obj) {
     return typeof obj === "function";
 }
-function fromEntries(arr, obj) {
-    if (arr == null || arr.length === 0)
-        return obj ?? {};
+/**
+ * Turns an array of `[key, value]` pairs into an object.
+ *
+ *  • Pairs whose key is `null | undefined` **or** value is `undefined` are skipped.
+ *  • If `base` is provided it is mutated and returned (handy for “extend” use‑cases).
+ */
+function fromEntries(pairs, base = {}) {
     // don't use Object.create(null), json stringify will break!
-    for (const ea of arr.filter((ea) => ea != null)) {
-        if (ea != null && Array.isArray(ea)) {
-            const [k, v] = ea;
-            // allow NULL fields:
-            if (k != null && v !== undefined) {
-                if (!isObject(obj))
-                    obj = {};
-                obj[k] = v;
-            }
+    if (pairs == null || pairs.length === 0)
+        return base ?? {};
+    for (const pair of pairs) {
+        if (pair != null && pair[0] != null && pair[1] !== undefined) {
+            base[pair[0]] = pair[1];
         }
     }
-    return obj ?? {};
+    return base;
 }
 function omit(t, ...keysToOmit) {
     const result = {};

package/dist/Object.js.map

@@ -1 +1 @@
-{"version":3,"file":"Object.js","sourceRoot":"","sources":["../src/Object.ts"],"names":[],"mappings":";;AAEA,4BAEC;AAED,oBAMC;AAED,gCAIC;AAED,kCAiBC;AAID,oBAWC;AAWD,wBAEC;AA/DD,SAAgB,QAAQ,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC;AACjD,CAAC;AAED,SAAgB,IAAI,CAA+C,CAAI;IACrE,OAAO,CAAC,IAAI,IAAI;QACd,CAAC,CAAC,EAAE;QACJ,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAC5B,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAC9B,CAAC;AAChB,CAAC;AAED,SAAgB,UAAU,CACxB,GAAY;IAEZ,OAAO,OAAO,GAAG,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,SAAgB,WAAW,CACzB,GAAsC,EACtC,GAA6B;IAE7B,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,IAAI,EAAE,CAAC;IACtD,4DAA4D;IAC5D,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,EAAE,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YAClB,qBAAqB;YACrB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,GAAG,GAAG,EAAE,CAAC;gBAC7B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,IAAI,EAAE,CAAC;AACnB,CAAC;AAID,SAAgB,IAAI,CAClB,CAAI,EACJ,GAAG,UAAe;IAElB,MAAM,MAAM,GAAG,EAAO,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAC5B,CAAC,EAAE,EAAE,EAAE,CAAC,CAAE,UAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAChC,EAAE,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,MAAsB,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAI,CAAkC;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAgB,CAAC;AACvC,CAAC;AAED,uDAAuD;AAEvD,yGAAyG"}
+{"version":3,"file":"Object.js","sourceRoot":"","sources":["../src/Object.ts"],"names":[],"mappings":";;AAEA,4BAEC;AAED,oBAMC;AAED,gCAIC;AAQD,kCAaC;AAID,oBAWC;AAWD,wBAEC;AAjED,SAAgB,QAAQ,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC;AACjD,CAAC;AAED,SAAgB,IAAI,CAA+C,CAAI;IACrE,OAAO,CAAC,IAAI,IAAI;QACd,CAAC,CAAC,EAAE;QACJ,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAC5B,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAC9B,CAAC;AAChB,CAAC;AAED,SAAgB,UAAU,CACxB,GAAY;IAEZ,OAAO,OAAO,GAAG,KAAK,UAAU,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CACzB,KAA6C,EAC7C,OAAqB,EAAkB;IAEvC,4DAA4D;IAC5D,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC;IAE3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,CAAC,CAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAM,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAID,SAAgB,IAAI,CAClB,CAAI,EACJ,GAAG,UAAe;IAElB,MAAM,MAAM,GAAG,EAAO,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAC5B,CAAC,EAAE,EAAE,EAAE,CAAC,CAAE,UAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAChC,EAAE,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,MAAsB,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAI,CAAkC;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAgB,CAAC;AACvC,CAAC;AAED,uDAAuD;AAEvD,yGAAyG"}

package/dist/ReadTask.js

@@ -207,6 +207,7 @@ class ReadTask extends ExifToolTask_1.ExifToolTask {
         this.#extractGpsMetadata();
         const tzSrc = this.#extractTzOffset();
         if (tzSrc) {
+            tags.zone = tzSrc.zone;
             tags.tz = tzSrc.tz;
             tags.tzSource = tzSrc.src;
         }
@@ -253,10 +254,11 @@ class ReadTask extends ExifToolTask_1.ExifToolTask {
         if (gps == null || gps.invalid === true || lat == null || lon == null)
             return;
         // First try GeolocationTimeZone:
-        const tz = (0, Timezones_1.normalizeZone)(this.#rawDegrouped.GeolocationTimeZone);
-        if (tz != null) {
+        const geolocZone = (0, Timezones_1.normalizeZone)(this.#rawDegrouped.GeolocationTimeZone);
+        if (geolocZone != null) {
             return {
-                tz: tz.name,
+                zone: geolocZone.name,
+                tz: geolocZone.name,
                 src: "GeolocationTimeZone",
             };
         }
@@ -265,6 +267,7 @@ class ReadTask extends ExifToolTask_1.ExifToolTask {
             const zone = (0, Timezones_1.normalizeZone)(geoTz);
             if (zone != null) {
                 return {
+                    zone: zone.name,
                     tz: zone.name,
                     src: "GPSLatitude/GPSLongitude",
                 };
@@ -292,6 +295,7 @@ class ReadTask extends ExifToolTask_1.ExifToolTask {
             // timezone offset in their datetime stamps.
             (this.#defaultToUTC()
                 ? {
+                    zone: "UTC",
                     tz: "UTC",
                     src: "defaultVideosToUTC",
                 }