@realsee/hdr-toolbox 1.0.0

package/README.md

@@ -0,0 +1,131 @@
+# @realsee/hdr-toolbox
+
+用 TypeScript 合成、分解和转换 Android Ultra HDR JPEG。工具遵循 Android Ultra HDR Image Format v1.1 的 JPEG/R 封装：
+
+- 主图是普通 SDR JPEG，旧版查看器可直接显示。
+- 主图携带 GContainer XMP，声明 `Primary` 和 `GainMap` 两个资源。
+- gain map JPEG 携带 Adobe HDR Gain Map XMP。
+- MPF APP2 索引主图与第二张 JPEG；两张 JPEG 紧密拼接。
+
+> 当前写入 Ultra HDR v1 XMP + MPF。v1.1 中提到的 ISO 21496-1 双重元数据属于增强的跨平台兼容建议，本工具暂不写入 ISO 21496-1 APP2。
+
+## 环境与构建
+
+需要 Node.js 20 或 22。`@realsee/equirect-toolbox` 使用原生 WebGL 依赖，因此不要使用 Node 24 运行全景命令。
+
+```bash
+npm install
+npm run build
+node dist/cli.js --help
+# 安装为包后也可直接运行：hdr-toolbox --help
+```
+
+## 配置
+
+输入配置可以是示例中的 JSON，也可以是标准 HDR gain map XMP。JSON 数值使用**线性 boost**：
+
+```json
+{
+  "maxContentBoost": "813.30419921875",
+  "minContentBoost": "1",
+  "gamma": "1.0",
+  "offsetSdr": "0",
+  "offsetHdr": "0",
+  "hdrCapacityMin": "1",
+  "hdrCapacityMax": "1000.0",
+  "useBaseColorSpace": "1"
+}
+```
+
+写入 XMP 时，`maxContentBoost`、`minContentBoost`、`hdrCapacityMin` 和 `hdrCapacityMax` 会自动转换为标准要求的 `log2` 值。分解时，`.json` 输出线性值，`.xmp` 输出标准 XMP。
+
+## CLI
+
+### 1. SDR + gain map + cfg → Ultra HDR
+
+```bash
+hdr-toolbox compose \
+  --sdr examples/cube/0_f.jpg \
+  --gainmap examples/cube/0_f_gainmap.jpg \
+  --config examples/cube/0_gainmap_cfg.json \
+  --output output/0_f.uhdr.jpg
+```
+
+合成只改写 JPEG metadata marker，不会重编码 SDR 或 gain map 像素。若 SDR 未携带规范要求的 ICC profile，会无重编码地补入 sRGB ICC marker。
+
+### 2. Ultra HDR → SDR + gain map + cfg
+
+```bash
+hdr-toolbox extract \
+  --input output/0_f.uhdr.jpg \
+  --sdr output/0_f.jpg \
+  --gainmap output/0_f_gainmap.jpg \
+  --config output/0_gainmap_cfg.json
+```
+
+将 `--config` 改成 `.xmp` 后缀即可输出原生 XMP 表达。
+
+### 3. cubemap → equirect Ultra HDR
+
+```bash
+hdr-toolbox cube-to-equirect \
+  --input-dir examples/cube \
+  --prefix 0 \
+  --output output/0_equirect.uhdr.jpg
+```
+
+六面映射如下：
+
+| 文件面名 | cubemap key | 方向    |
+| -------- | ----------- | ------- |
+| `r`      | `px`        | 右 / +X |
+| `l`      | `nx`        | 左 / -X |
+| `u`      | `py`        | 上 / +Y |
+| `d`      | `ny`        | 下 / -Y |
+| `f`      | `pz`        | 前 / +Z |
+| `b`      | `nz`        | 后 / -Z |
+
+SDR 文件名为 `<prefix>_[r,l,u,d,f,b].jpg`。gain map 同时兼容 `<prefix>_<face>_gainmap.jpg` 和示例里的 `<prefix>_<face>.gainmap.jpg`。配置自动读取输入目录下的 `<prefix>_gainmap_cfg.json`（找不到时回退 `<prefix>_gainmap_cfg.xmp`）。六面必须是同尺寸、正方形且边长为 2 的幂。输出尺寸是面宽的 4×2 倍。
+
+### 4. equirect Ultra HDR → cubemap
+
+```bash
+hdr-toolbox equirect-to-cube \
+  --input output/0_equirect.uhdr.jpg \
+  --output-dir output/cube \
+  --prefix 0
+```
+
+输出 6 张 `<prefix>_<face>.jpg`、6 张 `<prefix>_<face>_gainmap.jpg` 和 `<prefix>_gainmap_cfg.json`。
+
+## TypeScript API
+
+```ts
+import { composeUltraHdr, extractUltraHdr } from "@realsee/hdr-toolbox";
+
+await composeUltraHdr({
+  sdr: "sdr.jpg",
+  gainMap: "gainmap.jpg",
+  config: "gainmap_cfg.json",
+  output: "image.uhdr.jpg",
+});
+
+await extractUltraHdr({
+  input: "image.uhdr.jpg",
+  sdr: "sdr.jpg",
+  gainMap: "gainmap.jpg",
+  config: "gainmap_cfg.xmp",
+});
+```
+
+## 校验
+
+```bash
+npm run typecheck
+npm test
+npm run lint
+npm run format:check
+npm run build
+```
+
+规范参考：[Android Ultra HDR Image Format v1.1](https://developer.android.com/media/platform/hdr-image-format)。

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+export declare function createProgram(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,aAAa,IAAI,OAAO,CAoEvC"}

package/dist/cli.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { pathToFileURL } from "node:url";
+import { cubeToEquirectUltraHdr, equirectUltraHdrToCube } from "./panorama.js";
+import { composeUltraHdr, extractUltraHdr } from "./ultrahdr.js";
+export function createProgram() {
+    const program = new Command();
+    program
+        .name("hdr-toolbox")
+        .description("Compose, extract, and convert Android Ultra HDR JPEG images")
+        .version("1.0.0");
+    program
+        .command("compose")
+        .description("Compose an SDR JPEG, gain map JPEG, and JSON/XMP config into Ultra HDR")
+        .requiredOption("--sdr <path>", "SDR primary JPEG")
+        .requiredOption("--gainmap <path>", "gain map JPEG")
+        .requiredOption("-c, --config <path>", "gain map config (.json or .xmp)")
+        .requiredOption("-o, --output <path>", "output Ultra HDR JPEG")
+        .action(async (options) => {
+        await composeUltraHdr({
+            sdr: options.sdr,
+            gainMap: options.gainmap,
+            config: options.config,
+            output: options.output,
+        });
+    });
+    program
+        .command("extract")
+        .description("Extract an Ultra HDR JPEG into SDR, gain map, and JSON/XMP config")
+        .requiredOption("-i, --input <path>", "input Ultra HDR JPEG")
+        .requiredOption("--sdr <path>", "output SDR JPEG")
+        .requiredOption("--gainmap <path>", "output gain map JPEG")
+        .requiredOption("-c, --config <path>", "output config (.json or .xmp)")
+        .action(async (options) => {
+        await extractUltraHdr({
+            input: options.input,
+            sdr: options.sdr,
+            gainMap: options.gainmap,
+            config: options.config,
+        });
+    });
+    program
+        .command("cube-to-equirect")
+        .description("Convert six SDR/gain-map cube faces into one equirectangular Ultra HDR JPEG")
+        .requiredOption("-i, --input-dir <path>", "directory containing <prefix>_[r,l,u,d,f,b].jpg")
+        .option("-p, --prefix <name>", "cube face filename prefix", "0")
+        .requiredOption("-o, --output <path>", "output equirectangular Ultra HDR JPEG")
+        .action(async (options) => {
+        await cubeToEquirectUltraHdr({
+            inputDirectory: options.inputDir,
+            prefix: options.prefix,
+            output: options.output,
+        });
+    });
+    program
+        .command("equirect-to-cube")
+        .description("Extract an equirectangular Ultra HDR JPEG into six SDR/gain-map cube faces")
+        .requiredOption("-i, --input <path>", "input equirectangular Ultra HDR JPEG")
+        .requiredOption("-o, --output-dir <path>", "output directory")
+        .option("-p, --prefix <name>", "output cube face filename prefix", "0")
+        .action(async (options) => {
+        await equirectUltraHdrToCube({
+            input: options.input,
+            outputDirectory: options.outputDir,
+            prefix: options.prefix,
+        });
+    });
+    return program;
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    createProgram()
+        .parseAsync()
+        .catch((error) => {
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { ComposeUltraHdrOptions, ExtractUltraHdrOptions } from "./ultrahdr.js";
+export { composeUltraHdr, composeUltraHdrBuffers, extractUltraHdr, extractUltraHdrBuffers, } from "./ultrahdr.js";
+export type { CubeToEquirectOptions, EquirectToCubeOptions } from "./panorama.js";
+export { cubeToEquirectUltraHdr, equirectUltraHdrToCube } from "./panorama.js";
+export type { CubeFaceKey, CubeManifest, GainMapConfig } from "./types.js";
+export { createGainMapXmp, createPrimaryXmp, normalizeGainMapConfig, parseGainMapXmp, readGainMapConfig, writeGainMapConfig, } from "./xmp.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { composeUltraHdr, composeUltraHdrBuffers, extractUltraHdr, extractUltraHdrBuffers, } from "./ultrahdr.js";
+export { cubeToEquirectUltraHdr, equirectUltraHdrToCube } from "./panorama.js";
+export { createGainMapXmp, createPrimaryXmp, normalizeGainMapConfig, parseGainMapXmp, readGainMapConfig, writeGainMapConfig, } from "./xmp.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE/E,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC"}

package/dist/jpeg.d.ts

@@ -0,0 +1,14 @@
+export declare function createXmpSegment(xml: string): Buffer;
+export declare function getIccProfileSegments(jpeg: Buffer): Buffer[];
+export declare function addIccProfileSegments(jpeg: Buffer, iccSegments: readonly Buffer[]): Buffer;
+export declare function createMpfSegment(primaryImageSize: number, mpfMarkerStart: number, secondaryImageSize: number): Buffer;
+export declare function addGainMapXmp(jpeg: Buffer, xml: string): Buffer;
+export declare function buildPrimaryJpeg(jpeg: Buffer, xml: string, secondaryImageSize: number): Buffer;
+export declare function stripUltraHdrMetadata(jpeg: Buffer): Buffer;
+export declare function getGainMapXmp(jpeg: Buffer): string | undefined;
+export declare function findJpegEnd(buffer: Buffer, start?: number): number;
+export declare function splitConcatenatedJpegs(container: Buffer): {
+    primary: Buffer;
+    gainMap: Buffer;
+};
+//# sourceMappingURL=jpeg.d.ts.map

package/dist/jpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jpeg.d.ts","sourceRoot":"","sources":["../src/jpeg.ts"],"names":[],"mappings":"AA4EA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKpD;AAwBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI5D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiB1F;AAwCD,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAwCR;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAO9F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU9D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAqC7D;AAsFD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA4B9F"}

package/dist/jpeg.js

@@ -0,0 +1,364 @@
+import { xmpNamespace } from "./xmp.js";
+const SOI = 0xd8;
+const EOI = 0xd9;
+const SOS = 0xda;
+const APP1 = 0xe1;
+const APP2 = 0xe2;
+function assertJpeg(buffer) {
+    if (buffer.length < 4 || buffer[0] !== 0xff || buffer[1] !== SOI)
+        throw new Error("Input is not a JPEG image (SOI marker is missing).");
+}
+function parseJpegParts(buffer) {
+    assertJpeg(buffer);
+    const segments = [];
+    let offset = 2;
+    while (offset + 1 < buffer.length) {
+        if (buffer[offset] !== 0xff)
+            throw new Error(`Malformed JPEG marker at byte ${offset}.`);
+        const markerPrefixStart = offset;
+        while (buffer[offset] === 0xff)
+            offset++;
+        const marker = buffer[offset];
+        const markerOffset = offset - 1;
+        if (marker === SOS)
+            return { segments, scanData: buffer.subarray(markerPrefixStart) };
+        if (marker === EOI)
+            return { segments, scanData: buffer.subarray(markerPrefixStart) };
+        if (marker === undefined)
+            break;
+        if (marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7)) {
+            const end = offset + 1;
+            segments.push({
+                marker,
+                markerOffset,
+                bytes: buffer.subarray(markerPrefixStart, end),
+                payload: Buffer.alloc(0),
+            });
+            offset = end;
+            continue;
+        }
+        if (offset + 2 >= buffer.length)
+            throw new Error("Truncated JPEG segment length.");
+        const length = buffer.readUInt16BE(offset + 1);
+        if (length < 2)
+            throw new Error(`Invalid JPEG segment length ${length}.`);
+        const end = offset + 1 + length;
+        if (end > buffer.length)
+            throw new Error("Truncated JPEG segment payload.");
+        segments.push({
+            marker,
+            markerOffset,
+            bytes: buffer.subarray(markerPrefixStart, end),
+            payload: buffer.subarray(offset + 3, end),
+        });
+        offset = end;
+    }
+    throw new Error("JPEG SOS or EOI marker was not found.");
+}
+function createSegment(marker, payload) {
+    const length = payload.length + 2;
+    if (length > 0xffff)
+        throw new Error(`JPEG APP segment is too large: ${length} bytes.`);
+    const result = Buffer.allocUnsafe(payload.length + 4);
+    result[0] = 0xff;
+    result[1] = marker;
+    result.writeUInt16BE(length, 2);
+    payload.copy(result, 4);
+    return result;
+}
+export function createXmpSegment(xml) {
+    return createSegment(APP1, Buffer.concat([Buffer.from(xmpNamespace, "ascii"), Buffer.from(xml, "utf8")]));
+}
+function isUltraHdrSegment(segment) {
+    if (segment.marker === APP1 &&
+        segment.payload.subarray(0, xmpNamespace.length).toString("ascii") === xmpNamespace) {
+        const xml = segment.payload.subarray(xmpNamespace.length).toString("utf8");
+        return (xml.includes("http://ns.adobe.com/hdr-gain-map/1.0/") ||
+            xml.includes("http://ns.google.com/photos/1.0/container/"));
+    }
+    if (segment.marker !== APP2)
+        return false;
+    const signature = segment.payload.subarray(0, 32).toString("ascii");
+    return signature.startsWith("MPF\0") || signature.startsWith("urn:iso:std:iso:ts:21496:-1\0");
+}
+function isIccSegment(segment) {
+    return (segment.marker === APP2 && segment.payload.subarray(0, 12).toString("ascii") === "ICC_PROFILE\0");
+}
+export function getIccProfileSegments(jpeg) {
+    return parseJpegParts(jpeg)
+        .segments.filter(isIccSegment)
+        .map((segment) => Buffer.from(segment.bytes));
+}
+export function addIccProfileSegments(jpeg, iccSegments) {
+    const { segments, scanData } = parseJpegParts(jpeg);
+    if (segments.some(isIccSegment))
+        return jpeg;
+    if (iccSegments.length === 0)
+        throw new Error("No ICC profile segments were provided.");
+    let appEnd = 0;
+    while (appEnd < segments.length) {
+        const marker = segments[appEnd].marker;
+        if ((marker >= 0xe0 && marker <= 0xef) || marker === 0xfe)
+            appEnd++;
+        else
+            break;
+    }
+    return Buffer.concat([
+        Buffer.from([0xff, SOI]),
+        ...segments.slice(0, appEnd).map((segment) => segment.bytes),
+        ...iccSegments,
+        ...segments.slice(appEnd).map((segment) => segment.bytes),
+        scanData,
+    ]);
+}
+function headerWithXmp(buffer, xmp, includeMpf) {
+    const { segments, scanData } = parseJpegParts(buffer);
+    const kept = segments.filter((segment) => !isUltraHdrSegment(segment));
+    let appEnd = 0;
+    while (appEnd < kept.length) {
+        const marker = kept[appEnd].marker;
+        if ((marker >= 0xe0 && marker <= 0xef) || marker === 0xfe)
+            appEnd++;
+        else
+            break;
+    }
+    const prefix = kept.slice(0, appEnd).map((segment) => segment.bytes);
+    const imageTables = kept.slice(appEnd).map((segment) => segment.bytes);
+    const beforeMpf = Buffer.concat([Buffer.from([0xff, SOI]), ...prefix, xmp, ...imageTables]);
+    if (!includeMpf)
+        return { buffer: Buffer.concat([beforeMpf, scanData]) };
+    return {
+        buffer: Buffer.concat([beforeMpf, includeMpf, scanData]),
+        mpfStart: beforeMpf.length,
+    };
+}
+function writeTag(buffer, offset, tag, type, count, value) {
+    buffer.writeUInt16BE(tag, offset);
+    buffer.writeUInt16BE(type, offset + 2);
+    buffer.writeUInt32BE(count, offset + 4);
+    buffer.writeUInt32BE(value, offset + 8);
+    return offset + 12;
+}
+export function createMpfSegment(primaryImageSize, mpfMarkerStart, secondaryImageSize) {
+    for (const [name, value] of Object.entries({
+        primaryImageSize,
+        mpfMarkerStart,
+        secondaryImageSize,
+    })) {
+        if (!Number.isSafeInteger(value) || value < 0 || value > 0xffffffff)
+            throw new Error(`${name} exceeds the MPF 32-bit range.`);
+    }
+    const payload = Buffer.alloc(86);
+    payload.write("MPF\0", 0, "ascii");
+    const tiff = 4;
+    payload.write("MM", tiff, "ascii");
+    payload.writeUInt16BE(0x002a, tiff + 2);
+    payload.writeUInt32BE(8, tiff + 4);
+    payload.writeUInt16BE(3, tiff + 8);
+    let offset = tiff + 10;
+    offset = writeTag(payload, offset, 0xb000, 7, 4, 0x30313030);
+    offset = writeTag(payload, offset, 0xb001, 4, 1, 2);
+    offset = writeTag(payload, offset, 0xb002, 7, 32, 50);
+    payload.writeUInt32BE(0, offset);
+    offset += 4;
+    payload.writeUInt32BE(0x00030000, offset);
+    payload.writeUInt32BE(primaryImageSize, offset + 4);
+    payload.writeUInt32BE(0, offset + 8);
+    payload.writeUInt16BE(0, offset + 12);
+    payload.writeUInt16BE(0, offset + 14);
+    offset += 16;
+    const tiffAbsoluteOffset = mpfMarkerStart + 8;
+    const secondaryOffset = primaryImageSize - tiffAbsoluteOffset;
+    if (secondaryOffset < 0)
+        throw new Error("Invalid MPF secondary image offset.");
+    payload.writeUInt32BE(0, offset);
+    payload.writeUInt32BE(secondaryImageSize, offset + 4);
+    payload.writeUInt32BE(secondaryOffset, offset + 8);
+    payload.writeUInt16BE(0, offset + 12);
+    payload.writeUInt16BE(0, offset + 14);
+    return createSegment(APP2, payload);
+}
+export function addGainMapXmp(jpeg, xml) {
+    return headerWithXmp(jpeg, createXmpSegment(xml)).buffer;
+}
+export function buildPrimaryJpeg(jpeg, xml, secondaryImageSize) {
+    const xmp = createXmpSegment(xml);
+    const placeholder = Buffer.alloc(90); // MPF APP2 has a fixed 90-byte serialized size.
+    const draft = headerWithXmp(jpeg, xmp, placeholder);
+    if (draft.mpfStart === undefined)
+        throw new Error("Unable to locate generated MPF segment.");
+    const mpf = createMpfSegment(draft.buffer.length, draft.mpfStart, secondaryImageSize);
+    return headerWithXmp(jpeg, xmp, mpf).buffer;
+}
+export function stripUltraHdrMetadata(jpeg) {
+    const { segments, scanData } = parseJpegParts(jpeg);
+    return Buffer.concat([
+        Buffer.from([0xff, SOI]),
+        ...segments.filter((segment) => !isUltraHdrSegment(segment)).map((segment) => segment.bytes),
+        scanData,
+    ]);
+}
+export function getGainMapXmp(jpeg) {
+    const { segments } = parseJpegParts(jpeg);
+    for (const segment of segments) {
+        if (segment.marker !== APP1)
+            continue;
+        if (segment.payload.subarray(0, xmpNamespace.length).toString("ascii") !== xmpNamespace)
+            continue;
+        const xml = segment.payload.subarray(xmpNamespace.length).toString("utf8");
+        if (xml.includes("http://ns.adobe.com/hdr-gain-map/1.0/"))
+            return xml;
+    }
+    return undefined;
+}
+export function findJpegEnd(buffer, start = 0) {
+    const image = buffer.subarray(start);
+    assertJpeg(image);
+    let offset = 2;
+    let inScan = false;
+    while (offset < image.length) {
+        if (!inScan) {
+            if (image[offset] !== 0xff)
+                throw new Error(`Malformed JPEG marker at byte ${start + offset}.`);
+            while (image[offset] === 0xff)
+                offset++;
+            const marker = image[offset++];
+            if (marker === EOI)
+                return start + offset;
+            if (marker === SOS) {
+                if (offset + 1 >= image.length)
+                    throw new Error("Truncated SOS segment.");
+                const length = image.readUInt16BE(offset);
+                offset += length;
+                inScan = true;
+            }
+            else if (marker === 0x01 || (marker !== undefined && marker >= 0xd0 && marker <= 0xd7)) {
+                continue;
+            }
+            else {
+                if (offset + 1 >= image.length)
+                    throw new Error("Truncated JPEG segment.");
+                const length = image.readUInt16BE(offset);
+                if (length < 2)
+                    throw new Error("Invalid JPEG segment length.");
+                offset += length;
+            }
+            continue;
+        }
+        if (image[offset++] !== 0xff)
+            continue;
+        while (image[offset] === 0xff)
+            offset++;
+        const marker = image[offset++];
+        if (marker === 0x00 || (marker !== undefined && marker >= 0xd0 && marker <= 0xd7))
+            continue;
+        if (marker === EOI)
+            return start + offset;
+        inScan = false;
+        offset -= 2;
+    }
+    throw new Error("JPEG EOI marker was not found.");
+}
+function parseMpf(primary) {
+    const segment = parseJpegParts(primary).segments.find((candidate) => candidate.marker === APP2 && candidate.payload.subarray(0, 4).toString("ascii") === "MPF\0");
+    if (!segment)
+        throw new Error("Required Ultra HDR MPF APP2 index is missing.");
+    const payload = segment.payload;
+    const tiff = 4;
+    const byteOrder = payload.subarray(tiff, tiff + 2).toString("ascii");
+    if (byteOrder !== "MM" && byteOrder !== "II")
+        throw new Error("Invalid MPF TIFF byte order.");
+    const littleEndian = byteOrder === "II";
+    const read16 = (offset) => {
+        if (offset < 0 || offset + 2 > payload.length)
+            throw new Error("Truncated MPF APP2 data.");
+        return littleEndian ? payload.readUInt16LE(offset) : payload.readUInt16BE(offset);
+    };
+    const read32 = (offset) => {
+        if (offset < 0 || offset + 4 > payload.length)
+            throw new Error("Truncated MPF APP2 data.");
+        return littleEndian ? payload.readUInt32LE(offset) : payload.readUInt32BE(offset);
+    };
+    if (read16(tiff + 2) !== 0x2a)
+        throw new Error("Invalid MPF TIFF signature.");
+    const ifd = tiff + read32(tiff + 4);
+    const tagCount = read16(ifd);
+    let numberOfImages;
+    let entriesOffset;
+    let entriesByteLength;
+    for (let index = 0; index < tagCount; index++) {
+        const tagOffset = ifd + 2 + index * 12;
+        const tag = read16(tagOffset);
+        if (tag === 0xb001)
+            numberOfImages = read32(tagOffset + 8);
+        if (tag === 0xb002) {
+            entriesByteLength = read32(tagOffset + 4);
+            entriesOffset = read32(tagOffset + 8);
+        }
+    }
+    if (numberOfImages !== 2 || entriesOffset === undefined || entriesByteLength !== 32)
+        throw new Error("Ultra HDR MPF index must describe exactly two 16-byte MP entries.");
+    const entries = tiff + entriesOffset;
+    const primarySize = read32(entries + 4);
+    const primaryDataOffset = read32(entries + 8);
+    const secondarySize = read32(entries + 20);
+    const secondaryDataOffset = read32(entries + 24);
+    if (primaryDataOffset !== 0 || primarySize === 0 || secondarySize === 0)
+        throw new Error("Invalid Ultra HDR MPF image sizes or primary offset.");
+    return {
+        tiffOffset: segment.markerOffset + 8,
+        primarySize,
+        secondarySize,
+        secondaryDataOffset,
+    };
+}
+function getContainerGainMapLength(primary) {
+    const segment = parseJpegParts(primary).segments.find((candidate) => {
+        if (candidate.marker !== APP1)
+            return false;
+        if (candidate.payload.subarray(0, xmpNamespace.length).toString("ascii") !== xmpNamespace)
+            return false;
+        return candidate.payload
+            .subarray(xmpNamespace.length)
+            .toString("utf8")
+            .includes("http://ns.google.com/photos/1.0/container/");
+    });
+    if (!segment)
+        throw new Error("Required Ultra HDR GContainer XMP is missing from the primary image.");
+    const xml = segment.payload.subarray(xmpNamespace.length).toString("utf8");
+    const items = [...xml.matchAll(/<Container:Item\b([^>]*)\/?\s*>/gi)].map((match) => match[1]);
+    const attribute = (attributes, name) => new RegExp(`Item:${name}\\s*=\\s*["']([^"']+)["']`, "i").exec(attributes)?.[1];
+    if (items.length < 2 || attribute(items[0], "Semantic") !== "Primary")
+        throw new Error("GContainer directory must start with the Primary image item.");
+    const gainMapItem = items.slice(1).find((item) => attribute(item, "Semantic") === "GainMap");
+    if (!gainMapItem || attribute(gainMapItem, "Mime") !== "image/jpeg")
+        throw new Error("GContainer directory does not contain a JPEG GainMap item.");
+    const length = Number(attribute(gainMapItem, "Length"));
+    if (!Number.isSafeInteger(length) || length <= 0)
+        throw new Error("GContainer GainMap Item:Length is missing or invalid.");
+    return length;
+}
+export function splitConcatenatedJpegs(container) {
+    const primaryEnd = findJpegEnd(container);
+    const primary = container.subarray(0, primaryEnd);
+    const mpf = parseMpf(primary);
+    if (mpf.primarySize !== primaryEnd)
+        throw new Error(`MPF primary image size ${mpf.primarySize} does not match JPEG size ${primaryEnd}.`);
+    const secondaryStart = mpf.tiffOffset + mpf.secondaryDataOffset;
+    if (secondaryStart < primaryEnd || secondaryStart + 2 > container.length)
+        throw new Error("MPF secondary image offset is outside the Ultra HDR container.");
+    if (container[secondaryStart] !== 0xff || container[secondaryStart + 1] !== SOI)
+        throw new Error("MPF does not point to a gain map JPEG SOI marker.");
+    const secondaryEnd = findJpegEnd(container, secondaryStart);
+    const actualSecondarySize = secondaryEnd - secondaryStart;
+    if (mpf.secondarySize !== actualSecondarySize)
+        throw new Error(`MPF gain map size ${mpf.secondarySize} does not match JPEG size ${actualSecondarySize}.`);
+    const containerLength = getContainerGainMapLength(primary);
+    if (containerLength !== actualSecondarySize)
+        throw new Error(`GContainer gain map length ${containerLength} does not match JPEG size ${actualSecondarySize}.`);
+    return {
+        primary,
+        gainMap: container.subarray(secondaryStart, secondaryEnd),
+    };
+}
+//# sourceMappingURL=jpeg.js.map

package/dist/jpeg.js.map

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

package/dist/panorama.d.ts

@@ -0,0 +1,13 @@
+export interface CubeToEquirectOptions {
+    inputDirectory: string;
+    prefix: string;
+    output: string;
+}
+export interface EquirectToCubeOptions {
+    input: string;
+    outputDirectory: string;
+    prefix: string;
+}
+export declare function cubeToEquirectUltraHdr(options: CubeToEquirectOptions): Promise<void>;
+export declare function equirectUltraHdrToCube(options: EquirectToCubeOptions): Promise<void>;
+//# sourceMappingURL=panorama.d.ts.map

package/dist/panorama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panorama.d.ts","sourceRoot":"","sources":["../src/panorama.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AA4DD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1F;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB1F"}

package/dist/panorama.js

@@ -0,0 +1,91 @@
+import { convertCubeToEquirect } from "@realsee/equirect-toolbox/cube2equirect";
+import { convertEquirectToCube } from "@realsee/equirect-toolbox/equirect2cube";
+import { access, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { cubeFaceAliases, cubeFaceKeys } from "./types.js";
+import { composeUltraHdrBuffers, extractUltraHdrBuffers } from "./ultrahdr.js";
+import { readGainMapConfig, writeGainMapConfig } from "./xmp.js";
+async function firstExisting(candidates, description) {
+    for (const candidate of candidates) {
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // Try the next supported naming convention.
+        }
+    }
+    throw new Error(`Unable to find ${description}. Tried:\n${candidates.join("\n")}`);
+}
+async function resolveInputManifests(directory, prefix) {
+    const root = resolve(directory);
+    const sdr = {};
+    const gainMap = {};
+    await Promise.all(cubeFaceKeys.map(async (face) => {
+        const alias = cubeFaceAliases[face];
+        sdr[face] = await firstExisting([join(root, `${prefix}_${alias}.jpg`), join(root, `${prefix}_${alias}.jpeg`)], `SDR ${alias} face`);
+        gainMap[face] = await firstExisting([
+            join(root, `${prefix}_${alias}_gainmap.jpg`),
+            join(root, `${prefix}_${alias}.gainmap.jpg`),
+            join(root, `${prefix}_${alias}_gainmap.jpeg`),
+            join(root, `${prefix}_${alias}.gainmap.jpeg`),
+        ], `gain map ${alias} face`);
+    }));
+    return { sdr, gainMap };
+}
+function outputManifests(directory, prefix) {
+    const root = resolve(directory);
+    const sdr = {};
+    const gainMap = {};
+    for (const face of cubeFaceKeys) {
+        const alias = cubeFaceAliases[face];
+        sdr[face] = join(root, `${prefix}_${alias}.jpg`);
+        gainMap[face] = join(root, `${prefix}_${alias}_gainmap.jpg`);
+    }
+    return { sdr, gainMap };
+}
+export async function cubeToEquirectUltraHdr(options) {
+    const inputDirectory = resolve(options.inputDirectory);
+    const manifests = await resolveInputManifests(inputDirectory, options.prefix);
+    const configPath = await firstExisting([
+        join(inputDirectory, `${options.prefix}_gainmap_cfg.json`),
+        join(inputDirectory, `${options.prefix}_gainmap_cfg.xmp`),
+    ], `gain map config for prefix "${options.prefix}"`);
+    const config = await readGainMapConfig(configPath);
+    const temporaryDirectory = await mkdtemp(join(tmpdir(), "hdr-toolbox-cube-"));
+    try {
+        const sdrPath = join(temporaryDirectory, "sdr.jpg");
+        const gainMapPath = join(temporaryDirectory, "gainmap.jpg");
+        await convertCubeToEquirect({ input: manifests.sdr, output: sdrPath });
+        await convertCubeToEquirect({ input: manifests.gainMap, output: gainMapPath });
+        const output = await composeUltraHdrBuffers(await readFile(sdrPath), await readFile(gainMapPath), config);
+        await mkdir(dirname(resolve(options.output)), { recursive: true });
+        await writeFile(options.output, output);
+    }
+    finally {
+        await rm(temporaryDirectory, { recursive: true, force: true });
+    }
+}
+export async function equirectUltraHdrToCube(options) {
+    const outputDirectory = resolve(options.outputDirectory);
+    await mkdir(outputDirectory, { recursive: true });
+    const extracted = extractUltraHdrBuffers(await readFile(options.input));
+    const temporaryDirectory = await mkdtemp(join(tmpdir(), "hdr-toolbox-equirect-"));
+    try {
+        const sdrPath = join(temporaryDirectory, "sdr.jpg");
+        const gainMapPath = join(temporaryDirectory, "gainmap.jpg");
+        await Promise.all([
+            writeFile(sdrPath, extracted.sdr),
+            writeFile(gainMapPath, extracted.gainMap),
+        ]);
+        const manifests = outputManifests(outputDirectory, options.prefix);
+        await convertEquirectToCube({ input: sdrPath, output: manifests.sdr });
+        await convertEquirectToCube({ input: gainMapPath, output: manifests.gainMap });
+        await writeGainMapConfig(join(outputDirectory, `${options.prefix}_gainmap_cfg.json`), extracted.config);
+    }
+    finally {
+        await rm(temporaryDirectory, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=panorama.js.map

package/dist/panorama.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+export interface GainMapConfig {
+    maxContentBoost: number;
+    minContentBoost: number;
+    gamma: number;
+    offsetSdr: number;
+    offsetHdr: number;
+    hdrCapacityMin: number;
+    hdrCapacityMax: number;
+    useBaseColorSpace: boolean;
+}
+export type CubeFaceKey = "px" | "nx" | "py" | "ny" | "pz" | "nz";
+export type CubeManifest = Record<CubeFaceKey, string>;
+export declare const cubeFaceKeys: readonly CubeFaceKey[];
+export declare const cubeFaceAliases: Readonly<Record<CubeFaceKey, string>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,SAAS,WAAW,EAAyC,CAAC;AAEzF,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAOjE,CAAC"}

package/dist/types.js

@@ -0,0 +1,10 @@
+export const cubeFaceKeys = ["px", "nx", "py", "ny", "pz", "nz"];
+export const cubeFaceAliases = {
+    px: "r",
+    nx: "l",
+    py: "u",
+    ny: "d",
+    pz: "f",
+    nz: "b",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,YAAY,GAA2B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEzF,MAAM,CAAC,MAAM,eAAe,GAA0C;IACpE,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;CACR,CAAC"}

package/dist/ultrahdr.d.ts

@@ -0,0 +1,23 @@
+import type { GainMapConfig } from "./types.js";
+export interface ComposeUltraHdrOptions {
+    sdr: string;
+    gainMap: string;
+    config: string;
+    output: string;
+}
+export interface ExtractUltraHdrOptions {
+    input: string;
+    sdr: string;
+    gainMap: string;
+    config: string;
+}
+export declare function composeUltraHdrBuffers(sdr: Buffer, gainMap: Buffer, configInput: GainMapConfig): Promise<Buffer>;
+export declare function extractUltraHdrBuffers(container: Buffer): {
+    sdr: Buffer;
+    gainMap: Buffer;
+    config: GainMapConfig;
+    xmp: string;
+};
+export declare function composeUltraHdr(options: ComposeUltraHdrOptions): Promise<void>;
+export declare function extractUltraHdr(options: ExtractUltraHdrOptions): Promise<void>;
+//# sourceMappingURL=ultrahdr.d.ts.map

package/dist/ultrahdr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ultrahdr.d.ts","sourceRoot":"","sources":["../src/ultrahdr.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAgDD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb,CAWA;AAMD,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpF"}

package/dist/ultrahdr.js

@@ -0,0 +1,91 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import sharp from "sharp";
+import { addGainMapXmp, addIccProfileSegments, buildPrimaryJpeg, getGainMapXmp, getIccProfileSegments, splitConcatenatedJpegs, stripUltraHdrMetadata, } from "./jpeg.js";
+import { createGainMapXmp, createPrimaryXmp, normalizeGainMapConfig, parseGainMapXmp, readGainMapConfig, writeGainMapConfig, } from "./xmp.js";
+let defaultIccSegments;
+function getDefaultIccSegments() {
+    defaultIccSegments ??= sharp({
+        create: { width: 1, height: 1, channels: 3, background: { r: 0, g: 0, b: 0 } },
+    })
+        .jpeg()
+        .withIccProfile("srgb")
+        .toBuffer()
+        .then((jpeg) => {
+        const segments = getIccProfileSegments(jpeg);
+        if (segments.length === 0)
+            throw new Error("Sharp did not provide the requested sRGB ICC profile.");
+        return segments;
+    });
+    return defaultIccSegments;
+}
+async function ensurePrimaryIccProfile(sdr) {
+    if (getIccProfileSegments(sdr).length > 0)
+        return sdr;
+    return addIccProfileSegments(sdr, await getDefaultIccSegments());
+}
+async function validateJpegPair(sdr, gainMap) {
+    const [sdrMetadata, gainMetadata] = await Promise.all([
+        sharp(sdr).metadata(),
+        sharp(gainMap).metadata(),
+    ]);
+    if (sdrMetadata.format !== "jpeg" || gainMetadata.format !== "jpeg")
+        throw new Error("Both the SDR primary image and gain map must be JPEG files.");
+    if (!sdrMetadata.width || !sdrMetadata.height || !gainMetadata.width || !gainMetadata.height)
+        throw new Error("Unable to determine JPEG dimensions.");
+    const sdrOrientation = sdrMetadata.orientation ?? 1;
+    const gainOrientation = gainMetadata.orientation ?? 1;
+    if (sdrOrientation !== gainOrientation)
+        throw new Error(`SDR and gain map EXIF orientations differ (${sdrOrientation} vs ${gainOrientation}).`);
+    const sdrRatio = sdrMetadata.width / sdrMetadata.height;
+    const gainRatio = gainMetadata.width / gainMetadata.height;
+    if (Math.abs(sdrRatio - gainRatio) > 0.001)
+        throw new Error(`SDR and gain map aspect ratios differ (${sdrMetadata.width}x${sdrMetadata.height} vs ${gainMetadata.width}x${gainMetadata.height}).`);
+}
+export async function composeUltraHdrBuffers(sdr, gainMap, configInput) {
+    const config = normalizeGainMapConfig(configInput);
+    await validateJpegPair(sdr, gainMap);
+    const sdrWithIcc = await ensurePrimaryIccProfile(sdr);
+    const gainMapWithXmp = addGainMapXmp(gainMap, createGainMapXmp(config));
+    const primary = buildPrimaryJpeg(sdrWithIcc, createPrimaryXmp(gainMapWithXmp.length), gainMapWithXmp.length);
+    return Buffer.concat([primary, gainMapWithXmp]);
+}
+export function extractUltraHdrBuffers(container) {
+    const { primary, gainMap } = splitConcatenatedJpegs(container);
+    const xmp = getGainMapXmp(gainMap);
+    if (!xmp)
+        throw new Error("The secondary JPEG does not contain required HDR gain map XMP metadata.");
+    return {
+        sdr: stripUltraHdrMetadata(primary),
+        gainMap: stripUltraHdrMetadata(gainMap),
+        config: parseGainMapXmp(xmp),
+        xmp,
+    };
+}
+async function ensureParent(path) {
+    await mkdir(dirname(path), { recursive: true });
+}
+export async function composeUltraHdr(options) {
+    const [sdr, gainMap, config] = await Promise.all([
+        readFile(options.sdr),
+        readFile(options.gainMap),
+        readGainMapConfig(options.config),
+    ]);
+    const output = await composeUltraHdrBuffers(sdr, gainMap, config);
+    await ensureParent(options.output);
+    await writeFile(options.output, output);
+}
+export async function extractUltraHdr(options) {
+    const extracted = extractUltraHdrBuffers(await readFile(options.input));
+    await Promise.all([
+        ensureParent(options.sdr),
+        ensureParent(options.gainMap),
+        ensureParent(options.config),
+    ]);
+    await Promise.all([
+        writeFile(options.sdr, extracted.sdr),
+        writeFile(options.gainMap, extracted.gainMap),
+        writeGainMapConfig(options.config, extracted.config),
+    ]);
+}
+//# sourceMappingURL=ultrahdr.js.map

package/dist/ultrahdr.js.map

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

package/dist/xmp.d.ts

@@ -0,0 +1,9 @@
+import type { GainMapConfig } from "./types.js";
+export declare const xmpNamespace = "http://ns.adobe.com/xap/1.0/\0";
+export declare function normalizeGainMapConfig(value: unknown): GainMapConfig;
+export declare function parseGainMapXmp(xml: string): GainMapConfig;
+export declare function createGainMapXmp(configInput: GainMapConfig): string;
+export declare function createPrimaryXmp(gainMapLength: number): string;
+export declare function readGainMapConfig(path: string): Promise<GainMapConfig>;
+export declare function writeGainMapConfig(path: string, config: GainMapConfig): Promise<void>;
+//# sourceMappingURL=xmp.d.ts.map

package/dist/xmp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmp.d.ts","sourceRoot":"","sources":["../src/xmp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,YAAY,mCAAmC,CAAC;AA4B7D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CA8BpE;AAiCD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAqB1D;AAMD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,aAAa,GAAG,MAAM,CAKnE;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAM5E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3F"}

package/dist/xmp.js

@@ -0,0 +1,140 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, extname } from "node:path";
+export const xmpNamespace = "http://ns.adobe.com/xap/1.0/\0";
+const hdrGainMapNamespace = "http://ns.adobe.com/hdr-gain-map/1.0/";
+const defaults = {
+    maxContentBoost: 1,
+    minContentBoost: 1,
+    gamma: 1,
+    offsetSdr: 0.015625,
+    offsetHdr: 0.015625,
+    hdrCapacityMin: 1,
+    hdrCapacityMax: 1,
+    useBaseColorSpace: true,
+};
+function finiteNumber(value, name, fallback) {
+    if (value === undefined && fallback !== undefined)
+        return fallback;
+    const number = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(number))
+        throw new Error(`Invalid ${name}: expected a finite number.`);
+    return number;
+}
+function booleanValue(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return value !== 0;
+    return !["0", "false", "no"].includes(String(value).toLowerCase());
+}
+export function normalizeGainMapConfig(value) {
+    if (typeof value !== "object" || value === null)
+        throw new Error("Gain map config must be an object.");
+    const input = value;
+    const config = {
+        maxContentBoost: finiteNumber(input.maxContentBoost, "maxContentBoost"),
+        minContentBoost: finiteNumber(input.minContentBoost, "minContentBoost", defaults.minContentBoost),
+        gamma: finiteNumber(input.gamma, "gamma", defaults.gamma),
+        offsetSdr: finiteNumber(input.offsetSdr, "offsetSdr", defaults.offsetSdr),
+        offsetHdr: finiteNumber(input.offsetHdr, "offsetHdr", defaults.offsetHdr),
+        hdrCapacityMin: finiteNumber(input.hdrCapacityMin, "hdrCapacityMin", defaults.hdrCapacityMin),
+        hdrCapacityMax: finiteNumber(input.hdrCapacityMax, "hdrCapacityMax"),
+        useBaseColorSpace: booleanValue(input.useBaseColorSpace, defaults.useBaseColorSpace),
+    };
+    if (config.maxContentBoost < 1)
+        throw new Error("maxContentBoost must be >= 1.");
+    if (config.minContentBoost <= 0 || config.minContentBoost > 1)
+        throw new Error("minContentBoost must be > 0 and <= 1.");
+    if (config.minContentBoost > config.maxContentBoost)
+        throw new Error("minContentBoost must be <= maxContentBoost.");
+    if (config.gamma <= 0)
+        throw new Error("gamma must be > 0.");
+    if (config.offsetSdr < 0 || config.offsetHdr < 0)
+        throw new Error("offsets must be >= 0.");
+    if (config.hdrCapacityMin < 1)
+        throw new Error("hdrCapacityMin must be >= 1.");
+    if (config.hdrCapacityMax <= config.hdrCapacityMin)
+        throw new Error("hdrCapacityMax must be greater than hdrCapacityMin.");
+    return config;
+}
+function propertyValues(xml, name) {
+    const attribute = new RegExp(`(?:hdrgm:)?${name}\\s*=\\s*["']([^"']+)["']`, "i").exec(xml);
+    if (attribute)
+        return [attribute[1]];
+    const element = new RegExp(`<hdrgm:${name}(?:\\s[^>]*)?>([\\s\\S]*?)<\\/hdrgm:${name}>`, "i").exec(xml);
+    if (!element)
+        return undefined;
+    const listValues = [...element[1].matchAll(/<rdf:li(?:\s[^>]*)?>([\s\S]*?)<\/rdf:li>/gi)].map((match) => match[1].replace(/<[^>]+>/g, "").trim());
+    if (listValues.length > 0)
+        return listValues;
+    const value = element[1].replace(/<[^>]+>/g, "").trim();
+    if (!value)
+        throw new Error(`Invalid empty HDR gain map XMP property: ${name}.`);
+    return [value];
+}
+function scalarProperty(xml, name, fallback) {
+    const values = propertyValues(xml, name);
+    if (!values) {
+        if (fallback !== undefined)
+            return fallback;
+        throw new Error(`Missing required HDR gain map XMP property: ${name}.`);
+    }
+    if (![1, 3].includes(values.length))
+        throw new Error(`${name} must contain either one value or three channel values.`);
+    const numbers = values.map((value) => finiteNumber(value, name));
+    if (numbers.some((value) => value !== numbers[0]))
+        throw new Error(`Per-channel ${name} arrays are not supported by the scalar config model.`);
+    return numbers[0];
+}
+export function parseGainMapXmp(xml) {
+    const version = propertyValues(xml, "Version")?.[0];
+    if (version !== "1.0" || !xml.includes(hdrGainMapNamespace))
+        throw new Error("The XMP packet is not an Ultra HDR 1.0 gain map packet.");
+    if (propertyValues(xml, "BaseRenditionIsHDR")?.[0]?.toLowerCase() === "true")
+        throw new Error("BaseRenditionIsHDR=True is not supported by the Ultra HDR JPEG profile.");
+    const gainMapMin = scalarProperty(xml, "GainMapMin", 0);
+    const gainMapMax = scalarProperty(xml, "GainMapMax");
+    const capacityMin = scalarProperty(xml, "HDRCapacityMin", 0);
+    const capacityMax = scalarProperty(xml, "HDRCapacityMax");
+    return normalizeGainMapConfig({
+        minContentBoost: 2 ** gainMapMin,
+        maxContentBoost: 2 ** gainMapMax,
+        gamma: scalarProperty(xml, "Gamma", 1),
+        offsetSdr: scalarProperty(xml, "OffsetSDR", 0.015625),
+        offsetHdr: scalarProperty(xml, "OffsetHDR", 0.015625),
+        hdrCapacityMin: 2 ** capacityMin,
+        hdrCapacityMax: 2 ** capacityMax,
+        useBaseColorSpace: true,
+    });
+}
+function formatNumber(value) {
+    return Number(value.toPrecision(12)).toString();
+}
+export function createGainMapXmp(configInput) {
+    const config = normalizeGainMapConfig(configInput);
+    if (!config.useBaseColorSpace)
+        throw new Error("Ultra HDR v1 XMP requires gain map application in the base color space.");
+    return `<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="@realsee/hdr-toolbox"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description rdf:about="" xmlns:hdrgm="${hdrGainMapNamespace}" hdrgm:Version="1.0" hdrgm:BaseRenditionIsHDR="False" hdrgm:GainMapMin="${formatNumber(Math.log2(config.minContentBoost))}" hdrgm:GainMapMax="${formatNumber(Math.log2(config.maxContentBoost))}" hdrgm:Gamma="${formatNumber(config.gamma)}" hdrgm:OffsetSDR="${formatNumber(config.offsetSdr)}" hdrgm:OffsetHDR="${formatNumber(config.offsetHdr)}" hdrgm:HDRCapacityMin="${formatNumber(Math.log2(config.hdrCapacityMin))}" hdrgm:HDRCapacityMax="${formatNumber(Math.log2(config.hdrCapacityMax))}"/></rdf:RDF></x:xmpmeta>`;
+}
+export function createPrimaryXmp(gainMapLength) {
+    if (!Number.isSafeInteger(gainMapLength) || gainMapLength <= 0)
+        throw new Error("Gain map JPEG length must be a positive integer.");
+    return `<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="@realsee/hdr-toolbox"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description rdf:about="" xmlns:Container="http://ns.google.com/photos/1.0/container/" xmlns:Item="http://ns.google.com/photos/1.0/container/item/" xmlns:hdrgm="${hdrGainMapNamespace}" hdrgm:Version="1.0"><Container:Directory><rdf:Seq><rdf:li rdf:parseType="Resource"><Container:Item Item:Semantic="Primary" Item:Mime="image/jpeg"/></rdf:li><rdf:li rdf:parseType="Resource"><Container:Item Item:Semantic="GainMap" Item:Mime="image/jpeg" Item:Length="${gainMapLength}"/></rdf:li></rdf:Seq></Container:Directory></rdf:Description></rdf:RDF></x:xmpmeta>`;
+}
+export async function readGainMapConfig(path) {
+    const text = await readFile(path, "utf8");
+    const trimmed = text.trim();
+    if (trimmed.startsWith("{") || extname(path).toLowerCase() === ".json")
+        return normalizeGainMapConfig(JSON.parse(trimmed));
+    return parseGainMapXmp(trimmed);
+}
+export async function writeGainMapConfig(path, config) {
+    const contents = extname(path).toLowerCase() === ".xmp"
+        ? `${createGainMapXmp(config)}\n`
+        : `${JSON.stringify(normalizeGainMapConfig(config), null, 2)}\n`;
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, contents, "utf8");
+}
+//# sourceMappingURL=xmp.js.map

package/dist/xmp.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@realsee/hdr-toolbox",
+  "version": "1.0.0",
+  "description": "Compose, extract, and convert Android Ultra HDR JPEG images",
+  "license": "ISC",
+  "author": "",
+  "bin": {
+    "hdr-toolbox": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test test/*.test.ts",
+    "lint": "oxlint src test",
+    "format": "oxfmt src test README.md package.json",
+    "format:check": "oxfmt --check src test README.md package.json",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@realsee/equirect-toolbox": "^1.0.5",
+    "commander": "^15.0.0",
+    "sharp": "^0.35.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "oxfmt": "^0.64.0",
+    "oxlint": "^1.79.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": "^20 || ^22"
+  }
+}