yom-format 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 juntaki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# yom-format
+
+TypeScript implementation of the [YOM](https://github.com/juntaki/yom-format)
+packfile format: a read-only, single-file package for scanned books (AVIF
+pages, a FlatBuffers index, and optional OCR / full-text search data). This
+package provides a reader, writer, and validator, plus an optional
+browser-side PDF → `.yom` conversion pipeline.
+
+The format specification lives at
+[`docs/format-spec.md`](https://github.com/juntaki/yom-format/blob/main/docs/format-spec.md)
+in the main repository; this package is one of two implementations kept
+byte-compatible with it (the other is the Swift package in `swift/`, used by
+[Yomu](https://yomu.juntaki.com)).
+
+## Install
+
+```sh
+npm install yom-format
+```
+
+## Read a `.yom` file
+
+```ts
+import { YOMPackfileReader } from "yom-format";
+
+const bytes = new Uint8Array(await readFile("book.yom")); // however you load the file
+const reader = await YOMPackfileReader.open(bytes);
+
+console.log(reader.title, reader.pageCount);
+const avifPage = await reader.pageImage(0); // AVIF bytes for page 0
+const avifThumb = await reader.thumbnailImage(0);
+```
+
+## Validate a `.yom` file
+
+```ts
+import { validateYOM, YOMValidationError } from "yom-format";
+
+try {
+  await validateYOM(bytes);
+  console.log("valid");
+} catch (error) {
+  if (error instanceof YOMValidationError) {
+    console.error("invalid package:", error.message);
+  } else {
+    throw error;
+  }
+}
+```
+
+The main entry also exports `writeYOM` (build a package from pages + blobs),
+`buildSearchIndex` / `decodePostings` (the bigram search index), and the
+lower-level `constants` / `header` helpers used by all three.
+
+## PDF → `.yom` conversion (browser only)
+
+Converting a PDF into a `.yom` package is a separate subpath so the core
+reader/writer stays free of pdf.js and image-codec dependencies:
+
+```ts
+import { convertPdfToYom } from "yom-format/pipeline";
+
+const yomBytes = await convertPdfToYom(pdfBytes, {
+  title: "Book Title",
+  onProgress: (stage, fraction) => console.log(stage, fraction),
+});
+```
+
+This pipeline renders with pdf.js onto a `Canvas`/`OffscreenCanvas`, encodes
+pages and thumbnails as AVIF, and writes a validated package — it requires a
+DOM environment and a bundler that can handle pdf.js's worker and the
+WebAssembly codecs (`@bokuweb/zstd-wasm`, `@jsquash/avif`); it will not run
+under plain Node. It is not bundled with a Web Worker wrapper — wrap
+`convertPdfToYom` in your own worker if you need conversion off the main
+thread (see `src/worker/convert.worker.ts` in the repository for the pattern
+this project uses internally).
+
+## Links
+
+- Format specification: [`docs/format-spec.md`](https://github.com/juntaki/yom-format/blob/main/docs/format-spec.md)
+- Source repository: [github.com/juntaki/yom-format](https://github.com/juntaki/yom-format)
+- Built for [Yomu](https://yomu.juntaki.com), an iOS reader for scanned PDFs
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+export interface CliIO {
+    out(line: string): void;
+    err(line: string): void;
+}
+interface ParsedArgs {
+    positionals: string[];
+    json: boolean;
+    page?: number;
+    kind?: string;
+    out?: string;
+}
+/** `info` -- magic, version, sizes, page count, index summary. */
+export declare function cmdInfo(args: ParsedArgs, io: CliIO): Promise<number>;
+/** `verify` -- full validation for a local file; per-blob ranged verify for a URL. */
+export declare function cmdVerify(args: ParsedArgs, io: CliIO): Promise<number>;
+/** `ls` -- per-page index, label, dimensions, and page-image blob size. */
+export declare function cmdLs(args: ParsedArgs, io: CliIO): Promise<number>;
+/** `extract` -- write one blob (page image/thumbnail, or file-wide ocr/text) to disk. */
+export declare function cmdExtract(args: ParsedArgs, io: CliIO): Promise<number>;
+/** `meta` -- book metadata + page labels + outline (when present) as JSON. */
+export declare function cmdMeta(args: ParsedArgs, io: CliIO): Promise<number>;
+/**
+ * Dispatches a parsed argv to a command handler. Returns the process exit
+ * code (0 ok, non-zero on failure / bad args). Never throws for usage
+ * errors -- they are reported and mapped to exit code 2.
+ */
+export declare function runCli(argv: string[], io: CliIO): Promise<number>;
+export {};
+//# 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":";AAwBA,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAoDD,kEAAkE;AAClE,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC1E;AAED,sFAAsF;AACtF,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB5E;AAED,2EAA2E;AAC3E,wBAAsB,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCxE;AAED,yFAAyF;AACzF,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC7E;AAED,8EAA8E;AAC9E,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B1E;AAgDD;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA4CvE"}

package/dist/cli.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+/**
+ * `yom` -- a small, dependency-light CLI for inspecting, verifying, and
+ * extracting from existing `.yom` packfiles.
+ *
+ * Commands: info | verify | ls | extract | meta. `verify` also accepts an
+ * HTTP(S) URL (exercising the Gap-1 ranged reader end-to-end); the others
+ * operate on a local file. PDF -> .yom conversion is intentionally NOT here:
+ * that pipeline is browser-only. Use the web convert tool or the iOS app.
+ *
+ * Command handlers are exported for testability; the process entry point at
+ * the bottom only runs when the file is executed directly.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+import { YOMPackfileReader } from "./yom/reader.js";
+import { validateYOM } from "./yom/validator.js";
+import { parseHeaderFields } from "./yom/header.js";
+import { YOM_HEADER_SIZE } from "./yom/constants.js";
+import { pdfExportPresent } from "./yom/flatbufferVerify.js";
+import { ReadingDirection } from "./yom/generated/yomu/yom/reading-direction.js";
+const VALUE_FLAGS = new Set(["--page", "--kind", "-o", "--out"]);
+function parseArgs(args) {
+    const parsed = { positionals: [], json: false };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--json") {
+            parsed.json = true;
+        }
+        else if (VALUE_FLAGS.has(arg)) {
+            const value = args[++i];
+            if (value === undefined)
+                throw new CliUsageError(`missing value for ${arg}`);
+            if (arg === "--page")
+                parsed.page = Number(value);
+            else if (arg === "--kind")
+                parsed.kind = value;
+            else
+                parsed.out = value; // -o | --out
+        }
+        else if (arg.startsWith("-")) {
+            throw new CliUsageError(`unknown flag ${arg}`);
+        }
+        else {
+            parsed.positionals.push(arg);
+        }
+    }
+    return parsed;
+}
+class CliUsageError extends Error {
+}
+const USAGE = `yom -- inspect and extract from .yom packfiles
+
+Usage:
+  yom info    <file.yom> [--json]
+  yom verify  <file.yom | url> [--json]
+  yom ls      <file.yom> [--json]
+  yom extract <file.yom> --page N --kind image|thumb|ocr|text -o <out>
+  yom meta    <file.yom>
+
+Note: PDF -> .yom conversion is browser-only; use the web convert tool or the
+iOS app. There is no 'convert' command.`;
+function isUrl(target) {
+    return /^https?:\/\//i.test(target);
+}
+async function loadLocalBytes(path) {
+    const buf = await readFile(path);
+    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+}
+function readingDirectionName(value) {
+    return ReadingDirection[value] ?? String(value);
+}
+/** `info` -- magic, version, sizes, page count, index summary. */
+export async function cmdInfo(args, io) {
+    const target = args.positionals[0];
+    if (!target)
+        throw new CliUsageError("info requires a <file.yom>");
+    const bytes = await loadLocalBytes(target);
+    const reader = await YOMPackfileReader.open(bytes);
+    const header = parseHeaderFields(bytes.subarray(0, YOM_HEADER_SIZE));
+    const index = reader.mainIndex;
+    const info = {
+        magic: new TextDecoder().decode(header.magic),
+        formatVersion: header.formatVersion,
+        fileSize: bytes.length,
+        indexOffset: Number(header.indexOffset),
+        indexLength: Number(header.indexUncompressedLength),
+        pageCount: reader.pageCount,
+        blobCount: index.blobsLength(),
+        title: reader.title,
+        hasOcr: index.ocrLayoutBlobIndex() >= 0,
+        hasNormalizedText: index.normalizedTextBlobIndex() >= 0,
+        hasSearch: index.searchDictionaryBlobIndex() >= 0,
+        searchTermCount: index.searchTermsLength(),
+    };
+    if (args.json) {
+        io.out(JSON.stringify(info, null, 2));
+    }
+    else {
+        io.out(`magic:            ${info.magic}`);
+        io.out(`formatVersion:    ${info.formatVersion}`);
+        io.out(`fileSize:         ${info.fileSize}`);
+        io.out(`indexOffset:      ${info.indexOffset}`);
+        io.out(`indexLength:      ${info.indexLength}`);
+        io.out(`title:            ${info.title}`);
+        io.out(`pageCount:        ${info.pageCount}`);
+        io.out(`blobCount:        ${info.blobCount}`);
+        io.out(`hasOcr:           ${info.hasOcr}`);
+        io.out(`hasNormalizedText:${info.hasNormalizedText}`);
+        io.out(`hasSearch:        ${info.hasSearch}`);
+        io.out(`searchTermCount:  ${info.searchTermCount}`);
+    }
+    return 0;
+}
+/** `verify` -- full validation for a local file; per-blob ranged verify for a URL. */
+export async function cmdVerify(args, io) {
+    const target = args.positionals[0];
+    if (!target)
+        throw new CliUsageError("verify requires a <file.yom | url>");
+    try {
+        if (isUrl(target)) {
+            // Exercise the ranged reader end-to-end: open reads header+index (with
+            // bounded index verify), then each blob read verifies its own SHA-256.
+            const reader = await YOMPackfileReader.openURL(target, { fallbackToFullFetch: true });
+            for (let i = 0; i < reader.mainIndex.blobsLength(); i++) {
+                await reader.readBlob(i);
+            }
+            report(io, args.json, { ok: true, target, mode: "range-per-blob" });
+        }
+        else {
+            const bytes = await loadLocalBytes(target);
+            await validateYOM(bytes);
+            report(io, args.json, { ok: true, target, mode: "full" });
+        }
+        return 0;
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        report(io, args.json, { ok: false, target, reason });
+        return 1;
+    }
+}
+/** `ls` -- per-page index, label, dimensions, and page-image blob size. */
+export async function cmdLs(args, io) {
+    const target = args.positionals[0];
+    if (!target)
+        throw new CliUsageError("ls requires a <file.yom>");
+    const bytes = await loadLocalBytes(target);
+    const reader = await YOMPackfileReader.open(bytes);
+    const index = reader.mainIndex;
+    const rows = [];
+    for (let i = 0; i < reader.pageCount; i++) {
+        const page = reader.page(i);
+        const imageBlob = index.blobs(page.pageImageBlobIndex());
+        rows.push({
+            page: i,
+            label: page.pageLabel() ?? "",
+            pixelWidth: page.pixelWidth(),
+            pixelHeight: page.pixelHeight(),
+            imageBlobIndex: page.pageImageBlobIndex(),
+            imageBlobBytes: imageBlob ? Number(imageBlob.compressedLength()) : 0,
+        });
+    }
+    const hasOcr = index.ocrLayoutBlobIndex() >= 0;
+    const hasNormalizedText = index.normalizedTextBlobIndex() >= 0;
+    if (args.json) {
+        io.out(JSON.stringify({ pageCount: reader.pageCount, hasOcr, hasNormalizedText, pages: rows }, null, 2));
+    }
+    else {
+        io.out(`pages: ${reader.pageCount}  hasOcr: ${hasOcr}  hasNormalizedText: ${hasNormalizedText}`);
+        io.out("idx  label            WxH           imageBytes");
+        for (const r of rows) {
+            io.out(`${String(r.page).padEnd(4)} ${r.label.padEnd(16)} ${`${r.pixelWidth}x${r.pixelHeight}`.padEnd(13)} ${r.imageBlobBytes}`);
+        }
+    }
+    return 0;
+}
+/** `extract` -- write one blob (page image/thumbnail, or file-wide ocr/text) to disk. */
+export async function cmdExtract(args, io) {
+    const target = args.positionals[0];
+    if (!target)
+        throw new CliUsageError("extract requires a <file.yom>");
+    if (!args.kind)
+        throw new CliUsageError("extract requires --kind image|thumb|ocr|text");
+    if (!args.out)
+        throw new CliUsageError("extract requires -o <out>");
+    const bytes = await loadLocalBytes(target);
+    const reader = await YOMPackfileReader.open(bytes);
+    const index = reader.mainIndex;
+    let data;
+    switch (args.kind) {
+        case "image":
+            requirePage(args);
+            data = await reader.pageImage(args.page);
+            break;
+        case "thumb":
+            requirePage(args);
+            data = await reader.thumbnailImage(args.page);
+            break;
+        case "ocr":
+            data = await readFileWideBlob(reader, index.ocrLayoutBlobIndex(), "ocr");
+            break;
+        case "text":
+            data = await readFileWideBlob(reader, index.normalizedTextBlobIndex(), "normalized text");
+            break;
+        default:
+            throw new CliUsageError(`unknown --kind ${args.kind} (expected image|thumb|ocr|text)`);
+    }
+    await writeFile(args.out, data);
+    io.out(`wrote ${data.length} bytes to ${args.out}`);
+    return 0;
+}
+/** `meta` -- book metadata + page labels + outline (when present) as JSON. */
+export async function cmdMeta(args, io) {
+    const target = args.positionals[0];
+    if (!target)
+        throw new CliUsageError("meta requires a <file.yom>");
+    const bytes = await loadLocalBytes(target);
+    const reader = await YOMPackfileReader.open(bytes);
+    const index = reader.mainIndex;
+    const book = index.book();
+    const pageLabels = [];
+    for (let i = 0; i < reader.pageCount; i++) {
+        pageLabels.push(reader.page(i).pageLabel() ?? "");
+    }
+    const header = parseHeaderFields(bytes.subarray(0, YOM_HEADER_SIZE));
+    const indexOffset = Number(header.indexOffset);
+    const indexBytes = bytes.subarray(indexOffset, indexOffset + Number(header.indexUncompressedLength));
+    const meta = {
+        title: reader.title,
+        pageCount: book ? book.pageCount() : reader.pageCount,
+        readingDirection: book ? readingDirectionName(book.readingDirection()) : null,
+        createdAtUnix: book ? book.createdAtUnix().toString() : null,
+        pageLabels,
+        outline: pdfExportPresent(indexBytes) ? readOutline(index) : [],
+    };
+    io.out(JSON.stringify(meta, null, 2));
+    return 0;
+}
+function readOutline(index) {
+    const pdf = index.pdfExport();
+    if (!pdf)
+        return [];
+    const nodes = [];
+    for (let i = 0; i < pdf.outlineLength(); i++) {
+        const entry = pdf.outline(i);
+        if (entry)
+            nodes.push(readOutlineEntry(entry));
+    }
+    return nodes;
+}
+function readOutlineEntry(entry) {
+    const children = [];
+    for (let i = 0; i < entry.childrenLength(); i++) {
+        const child = entry.children(i);
+        if (child)
+            children.push(readOutlineEntry(child));
+    }
+    return { title: entry.title() ?? "", pageId: entry.pageId(), children };
+}
+function requirePage(args) {
+    if (args.page === undefined || !Number.isInteger(args.page) || args.page < 0) {
+        throw new CliUsageError("extract --kind image|thumb requires --page N (a non-negative integer)");
+    }
+}
+async function readFileWideBlob(reader, blobIndex, label) {
+    if (blobIndex < 0)
+        throw new CliUsageError(`this file has no ${label} blob`);
+    return reader.readBlob(blobIndex);
+}
+function report(io, json, payload) {
+    if (json) {
+        io.out(JSON.stringify(payload));
+        return;
+    }
+    if (payload.ok)
+        io.out(`OK  ${payload.target}${payload.mode ? ` (${payload.mode})` : ""}`);
+    else
+        io.err(`FAIL  ${payload.target}: ${payload.reason}`);
+}
+/**
+ * Dispatches a parsed argv to a command handler. Returns the process exit
+ * code (0 ok, non-zero on failure / bad args). Never throws for usage
+ * errors -- they are reported and mapped to exit code 2.
+ */
+export async function runCli(argv, io) {
+    const command = argv[0];
+    if (!command || command === "--help" || command === "-h" || command === "help") {
+        io.out(USAGE);
+        return command ? 0 : 2;
+    }
+    let args;
+    try {
+        args = parseArgs(argv.slice(1));
+    }
+    catch (err) {
+        io.err(err instanceof Error ? err.message : String(err));
+        io.err(USAGE);
+        return 2;
+    }
+    try {
+        switch (command) {
+            case "info":
+                return await cmdInfo(args, io);
+            case "verify":
+                return await cmdVerify(args, io);
+            case "ls":
+                return await cmdLs(args, io);
+            case "extract":
+                return await cmdExtract(args, io);
+            case "meta":
+                return await cmdMeta(args, io);
+            case "convert":
+                io.err("PDF -> .yom conversion is browser-only; use the web convert tool or the iOS app.");
+                return 2;
+            default:
+                io.err(`unknown command: ${command}`);
+                io.err(USAGE);
+                return 2;
+        }
+    }
+    catch (err) {
+        if (err instanceof CliUsageError) {
+            io.err(err.message);
+            return 2;
+        }
+        io.err(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+}
+const consoleIO = {
+    out: (line) => process.stdout.write(`${line}\n`),
+    err: (line) => process.stderr.write(`${line}\n`),
+};
+const invokedDirectly = process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (invokedDirectly) {
+    runCli(process.argv.slice(2), consoleIO)
+        .then((code) => process.exit(code))
+        .catch((err) => {
+        consoleIO.err(err instanceof Error ? err.message : String(err));
+        process.exit(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,36 @@
+/**
+ * Public API for reading, writing, and validating YOM v1 packfiles.
+ *
+ * This entry point is platform-agnostic (no DOM/pdf.js dependency). For the
+ * browser-only PDF-to-YOM conversion pipeline, import from
+ * `yom-format/pipeline` instead.
+ */
+export { YOMPackfileReader, YOMReaderError } from "./yom/reader.js";
+export { type ByteSource, MemoryByteSource, HttpRangeByteSource, ByteSourceError, type HttpRangeOptions, } from "./yom/byteSource.js";
+export { YOMError, BlobTooLargeError, CorruptBlobError, MalformedIndexError, RangeNotSupportedError, } from "./yom/errors.js";
+export { verifyMainIndex } from "./yom/flatbufferVerify.js";
+export { MAX_BLOB_UNCOMPRESSED_IMAGE, MAX_BLOB_UNCOMPRESSED_TEXT, MAX_BLOB_UNCOMPRESSED_POSTINGS, MAX_TOTAL_UNCOMPRESSED, MAX_INFLATION_RATIO, maxBlobUncompressed, } from "./yom/constants.js";
+export { writeYOM, YOMWriterError, type WriterInput, type BookInput, type PageInput, type BlobInput, type SearchTermInput, type OutlineInput, type PDFExportInput, } from "./yom/writer.js";
+export { validateYOM, YOMValidationError } from "./yom/validator.js";
+export { YOM_FILE_EXTENSION, YOM_MIME_TYPE, YOM_MAGIC, YOM_HEADER_SIZE, YOM_FORMAT_VERSION, YOM_HASH_LENGTH, YOM_IMAGE_BLOB_ALIGNMENT, YOM_DEFAULT_BLOB_ALIGNMENT, requiredCompression, requiredAlignment, } from "./yom/constants.js";
+export { HEADER_FIELDS_SIZE, type YOMHeader, YOMHeaderParseError, encodeHeaderFields, encodeHeader, encodeFooter, parseHeaderFields, zeroingHashes, headersEqual, } from "./yom/header.js";
+export { buildSearchIndex, decodePostings, type SearchTerm, type SearchIndexResult, type Hit, } from "./yom/searchIndex.js";
+export { normalizeText, buildNormalizedTextBlob, type NormalizedTextBlob, } from "./yom/textNormalizer.js";
+export { sha256, bytesEqual } from "./yom/hash.js";
+export { concatBytes } from "./yom/bytes.js";
+export { BlobKind } from "./yom/generated/yomu/yom/blob-kind.js";
+export { Compression } from "./yom/generated/yomu/yom/compression.js";
+export { ReadingDirection } from "./yom/generated/yomu/yom/reading-direction.js";
+export type { MainIndex } from "./yom/generated/yomu/yom/main-index.js";
+export type { PageEntry } from "./yom/generated/yomu/yom/page-entry.js";
+export type { BlobRef } from "./yom/generated/yomu/yom/blob-ref.js";
+export type { BookMetadata } from "./yom/generated/yomu/yom/book-metadata.js";
+export type { OutlineEntry } from "./yom/generated/yomu/yom/outline-entry.js";
+export type { SearchTermRef } from "./yom/generated/yomu/yom/search-term-ref.js";
+export type { PDFExportMetadata } from "./yom/generated/yomu/yom/pdfexport-metadata.js";
+export type { OCRLayout } from "./yom/generated/yomu/yom/ocrlayout.js";
+export type { OCRPage } from "./yom/generated/yomu/yom/ocrpage.js";
+export type { OCRBlock } from "./yom/generated/yomu/yom/ocrblock.js";
+export type { OCRLine } from "./yom/generated/yomu/yom/ocrline.js";
+export type { OCRToken } from "./yom/generated/yomu/yom/ocrtoken.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;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,QAAQ,EACR,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,KAAK,SAAS,EACd,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,GAAG,GACT,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,YAAY,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,YAAY,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,YAAY,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,YAAY,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACxF,YAAY,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AACvE,YAAY,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * Public API for reading, writing, and validating YOM v1 packfiles.
+ *
+ * This entry point is platform-agnostic (no DOM/pdf.js dependency). For the
+ * browser-only PDF-to-YOM conversion pipeline, import from
+ * `yom-format/pipeline` instead.
+ */
+export { YOMPackfileReader, YOMReaderError } from "./yom/reader.js";
+export { MemoryByteSource, HttpRangeByteSource, ByteSourceError, } from "./yom/byteSource.js";
+export { YOMError, BlobTooLargeError, CorruptBlobError, MalformedIndexError, RangeNotSupportedError, } from "./yom/errors.js";
+export { verifyMainIndex } from "./yom/flatbufferVerify.js";
+export { MAX_BLOB_UNCOMPRESSED_IMAGE, MAX_BLOB_UNCOMPRESSED_TEXT, MAX_BLOB_UNCOMPRESSED_POSTINGS, MAX_TOTAL_UNCOMPRESSED, MAX_INFLATION_RATIO, maxBlobUncompressed, } from "./yom/constants.js";
+export { writeYOM, YOMWriterError, } from "./yom/writer.js";
+export { validateYOM, YOMValidationError } from "./yom/validator.js";
+export { YOM_FILE_EXTENSION, YOM_MIME_TYPE, YOM_MAGIC, YOM_HEADER_SIZE, YOM_FORMAT_VERSION, YOM_HASH_LENGTH, YOM_IMAGE_BLOB_ALIGNMENT, YOM_DEFAULT_BLOB_ALIGNMENT, requiredCompression, requiredAlignment, } from "./yom/constants.js";
+export { HEADER_FIELDS_SIZE, YOMHeaderParseError, encodeHeaderFields, encodeHeader, encodeFooter, parseHeaderFields, zeroingHashes, headersEqual, } from "./yom/header.js";
+export { buildSearchIndex, decodePostings, } from "./yom/searchIndex.js";
+export { normalizeText, buildNormalizedTextBlob, } from "./yom/textNormalizer.js";
+export { sha256, bytesEqual } from "./yom/hash.js";
+export { concatBytes } from "./yom/bytes.js";
+// FlatBuffers-generated enums and record types used by the API above.
+export { BlobKind } from "./yom/generated/yomu/yom/blob-kind.js";
+export { Compression } from "./yom/generated/yomu/yom/compression.js";
+export { ReadingDirection } from "./yom/generated/yomu/yom/reading-direction.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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAEL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAEhB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,QAAQ,EACR,cAAc,GAQf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAElB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,gBAAgB,EAChB,cAAc,GAIf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,sEAAsE;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/pipeline/avif.d.ts

@@ -0,0 +1,3 @@
+export declare function encodePageAvif(image: ImageData): Promise<Uint8Array>;
+export declare function encodeThumbnailAvif(image: ImageData): Promise<Uint8Array>;
+//# sourceMappingURL=avif.d.ts.map

package/dist/pipeline/avif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avif.d.ts","sourceRoot":"","sources":["../../src/pipeline/avif.ts"],"names":[],"mappings":"AAwBA,wBAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAG1E;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAG/E"}

package/dist/pipeline/avif.js

@@ -0,0 +1,30 @@
+import encode from "@jsquash/avif/encode";
+/**
+ * AVIF is the only page/thumbnail image codec YOM v1 supports (see
+ * docs/format-spec.md §5.1-5.2). `@jsquash/avif`'s `quality` is a 0-100
+ * cq-level scale, independent of the
+ * native encoder's ImageIO `0..1` quality knob (`AVIFCodec.swift`) -- these
+ * two encoders are not required to numerically match, only to both emit
+ * valid, reasonably-sized AVIF per the format's page/thumbnail split.
+ */
+const PAGE_QUALITY = 60;
+const THUMBNAIL_QUALITY = 40;
+/**
+ * libavif's `speed` is 0 (slowest/best compression) to 10 (fastest/worst
+ * compression); `@jsquash/avif`'s default is 6 ("balanced"). This app's own
+ * product direction is an "extremely fast, focused" reader over archival
+ * image quality (see `pivot-fast-reader-remove-ai-ocr`), and these pages are
+ * themselves lossy re-renders of the source PDF rather than original scans,
+ * so trading a little compression efficiency for much faster encoding is
+ * the right default for a browser-only, no-hardware-encoder pipeline.
+ */
+const ENCODE_SPEED = 9;
+export async function encodePageAvif(image) {
+    const buffer = await encode(image, { quality: PAGE_QUALITY, speed: ENCODE_SPEED });
+    return new Uint8Array(buffer);
+}
+export async function encodeThumbnailAvif(image) {
+    const buffer = await encode(image, { quality: THUMBNAIL_QUALITY, speed: ENCODE_SPEED });
+    return new Uint8Array(buffer);
+}
+//# sourceMappingURL=avif.js.map

package/dist/pipeline/avif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avif.js","sourceRoot":"","sources":["../../src/pipeline/avif.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAgB;IACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACnF,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAgB;IACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACxF,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}