yom-format 0.1.0

package/dist/yom/generated/yomu/yom/search-term-ref.d.ts

@@ -0,0 +1,34 @@
+import * as flatbuffers from 'flatbuffers';
+export declare class SearchTermRef implements flatbuffers.IUnpackableObject<SearchTermRefT> {
+    bb: flatbuffers.ByteBuffer | null;
+    bb_pos: number;
+    __init(i: number, bb: flatbuffers.ByteBuffer): SearchTermRef;
+    static getRootAsSearchTermRef(bb: flatbuffers.ByteBuffer, obj?: SearchTermRef): SearchTermRef;
+    static getSizePrefixedRootAsSearchTermRef(bb: flatbuffers.ByteBuffer, obj?: SearchTermRef): SearchTermRef;
+    term(): string | null;
+    term(optionalEncoding: flatbuffers.Encoding): string | Uint8Array | null;
+    dictionaryOffset(): bigint;
+    dictionaryLength(): bigint;
+    postingsOffset(): bigint;
+    postingsLength(): bigint;
+    static startSearchTermRef(builder: flatbuffers.Builder): void;
+    static addTerm(builder: flatbuffers.Builder, termOffset: flatbuffers.Offset): void;
+    static addDictionaryOffset(builder: flatbuffers.Builder, dictionaryOffset: bigint): void;
+    static addDictionaryLength(builder: flatbuffers.Builder, dictionaryLength: bigint): void;
+    static addPostingsOffset(builder: flatbuffers.Builder, postingsOffset: bigint): void;
+    static addPostingsLength(builder: flatbuffers.Builder, postingsLength: bigint): void;
+    static endSearchTermRef(builder: flatbuffers.Builder): flatbuffers.Offset;
+    static createSearchTermRef(builder: flatbuffers.Builder, termOffset: flatbuffers.Offset, dictionaryOffset: bigint, dictionaryLength: bigint, postingsOffset: bigint, postingsLength: bigint): flatbuffers.Offset;
+    unpack(): SearchTermRefT;
+    unpackTo(_o: SearchTermRefT): void;
+}
+export declare class SearchTermRefT implements flatbuffers.IGeneratedObject {
+    term: string | Uint8Array | null;
+    dictionaryOffset: bigint;
+    dictionaryLength: bigint;
+    postingsOffset: bigint;
+    postingsLength: bigint;
+    constructor(term?: string | Uint8Array | null, dictionaryOffset?: bigint, dictionaryLength?: bigint, postingsOffset?: bigint, postingsLength?: bigint);
+    pack(builder: flatbuffers.Builder): flatbuffers.Offset;
+}
+//# sourceMappingURL=search-term-ref.d.ts.map

package/dist/yom/generated/yomu/yom/search-term-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-term-ref.d.ts","sourceRoot":"","sources":["../../../../../src/yom/generated/yomu/yom/search-term-ref.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,aAAa,CAAC;AAI3C,qBAAa,aAAc,YAAW,WAAW,CAAC,iBAAiB,CAAC,cAAc,CAAC;IACjF,EAAE,EAAE,WAAW,CAAC,UAAU,GAAC,IAAI,CAAQ;IACvC,MAAM,SAAK;IACX,MAAM,CAAC,CAAC,EAAC,MAAM,EAAE,EAAE,EAAC,WAAW,CAAC,UAAU,GAAE,aAAa;IAM3D,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAC,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,EAAC,aAAa,GAAE,aAAa;IAI1F,MAAM,CAAC,kCAAkC,CAAC,EAAE,EAAC,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,EAAC,aAAa,GAAE,aAAa;IAKtG,IAAI,IAAG,MAAM,GAAC,IAAI;IAClB,IAAI,CAAC,gBAAgB,EAAC,WAAW,CAAC,QAAQ,GAAE,MAAM,GAAC,UAAU,GAAC,IAAI;IAMlE,gBAAgB,IAAG,MAAM;IAKzB,gBAAgB,IAAG,MAAM;IAKzB,cAAc,IAAG,MAAM;IAKvB,cAAc,IAAG,MAAM;IAKvB,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO;IAIrD,MAAM,CAAC,OAAO,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAC,WAAW,CAAC,MAAM;IAIzE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAC,MAAM;IAI/E,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAC,MAAM;IAI/E,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,EAAE,cAAc,EAAC,MAAM;IAI3E,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,EAAE,cAAc,EAAC,MAAM;IAI3E,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,GAAE,WAAW,CAAC,MAAM;IAKvE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAC,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAC,MAAM,EAAE,gBAAgB,EAAC,MAAM,EAAE,cAAc,EAAC,MAAM,EAAE,cAAc,EAAC,MAAM,GAAE,WAAW,CAAC,MAAM;IAUzM,MAAM,IAAI,cAAc;IAWxB,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;CAOjC;AAED,qBAAa,cAAe,YAAW,WAAW,CAAC,gBAAgB;IAE1D,IAAI,EAAE,MAAM,GAAC,UAAU,GAAC,IAAI;IAC5B,gBAAgB,EAAE,MAAM;IACxB,gBAAgB,EAAE,MAAM;IACxB,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,MAAM;gBAJtB,IAAI,GAAE,MAAM,GAAC,UAAU,GAAC,IAAW,EACnC,gBAAgB,GAAE,MAAoB,EACtC,gBAAgB,GAAE,MAAoB,EACtC,cAAc,GAAE,MAAoB,EACpC,cAAc,GAAE,MAAoB;IAI7C,IAAI,CAAC,OAAO,EAAC,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,MAAM;CAWpD"}

package/dist/yom/generated/yomu/yom/search-term-ref.js

@@ -0,0 +1,99 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+import * as flatbuffers from 'flatbuffers';
+export class SearchTermRef {
+    bb = null;
+    bb_pos = 0;
+    __init(i, bb) {
+        this.bb_pos = i;
+        this.bb = bb;
+        return this;
+    }
+    static getRootAsSearchTermRef(bb, obj) {
+        return (obj || new SearchTermRef()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+    }
+    static getSizePrefixedRootAsSearchTermRef(bb, obj) {
+        bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+        return (obj || new SearchTermRef()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+    }
+    term(optionalEncoding) {
+        const offset = this.bb.__offset(this.bb_pos, 4);
+        return offset ? this.bb.__string(this.bb_pos + offset, optionalEncoding) : null;
+    }
+    dictionaryOffset() {
+        const offset = this.bb.__offset(this.bb_pos, 6);
+        return offset ? this.bb.readUint64(this.bb_pos + offset) : BigInt('0');
+    }
+    dictionaryLength() {
+        const offset = this.bb.__offset(this.bb_pos, 8);
+        return offset ? this.bb.readUint64(this.bb_pos + offset) : BigInt('0');
+    }
+    postingsOffset() {
+        const offset = this.bb.__offset(this.bb_pos, 10);
+        return offset ? this.bb.readUint64(this.bb_pos + offset) : BigInt('0');
+    }
+    postingsLength() {
+        const offset = this.bb.__offset(this.bb_pos, 12);
+        return offset ? this.bb.readUint64(this.bb_pos + offset) : BigInt('0');
+    }
+    static startSearchTermRef(builder) {
+        builder.startObject(5);
+    }
+    static addTerm(builder, termOffset) {
+        builder.addFieldOffset(0, termOffset, 0);
+    }
+    static addDictionaryOffset(builder, dictionaryOffset) {
+        builder.addFieldInt64(1, dictionaryOffset, BigInt('0'));
+    }
+    static addDictionaryLength(builder, dictionaryLength) {
+        builder.addFieldInt64(2, dictionaryLength, BigInt('0'));
+    }
+    static addPostingsOffset(builder, postingsOffset) {
+        builder.addFieldInt64(3, postingsOffset, BigInt('0'));
+    }
+    static addPostingsLength(builder, postingsLength) {
+        builder.addFieldInt64(4, postingsLength, BigInt('0'));
+    }
+    static endSearchTermRef(builder) {
+        const offset = builder.endObject();
+        return offset;
+    }
+    static createSearchTermRef(builder, termOffset, dictionaryOffset, dictionaryLength, postingsOffset, postingsLength) {
+        SearchTermRef.startSearchTermRef(builder);
+        SearchTermRef.addTerm(builder, termOffset);
+        SearchTermRef.addDictionaryOffset(builder, dictionaryOffset);
+        SearchTermRef.addDictionaryLength(builder, dictionaryLength);
+        SearchTermRef.addPostingsOffset(builder, postingsOffset);
+        SearchTermRef.addPostingsLength(builder, postingsLength);
+        return SearchTermRef.endSearchTermRef(builder);
+    }
+    unpack() {
+        return new SearchTermRefT(this.term(), this.dictionaryOffset(), this.dictionaryLength(), this.postingsOffset(), this.postingsLength());
+    }
+    unpackTo(_o) {
+        _o.term = this.term();
+        _o.dictionaryOffset = this.dictionaryOffset();
+        _o.dictionaryLength = this.dictionaryLength();
+        _o.postingsOffset = this.postingsOffset();
+        _o.postingsLength = this.postingsLength();
+    }
+}
+export class SearchTermRefT {
+    term;
+    dictionaryOffset;
+    dictionaryLength;
+    postingsOffset;
+    postingsLength;
+    constructor(term = null, dictionaryOffset = BigInt('0'), dictionaryLength = BigInt('0'), postingsOffset = BigInt('0'), postingsLength = BigInt('0')) {
+        this.term = term;
+        this.dictionaryOffset = dictionaryOffset;
+        this.dictionaryLength = dictionaryLength;
+        this.postingsOffset = postingsOffset;
+        this.postingsLength = postingsLength;
+    }
+    pack(builder) {
+        const term = (this.term !== null ? builder.createString(this.term) : 0);
+        return SearchTermRef.createSearchTermRef(builder, term, this.dictionaryOffset, this.dictionaryLength, this.postingsOffset, this.postingsLength);
+    }
+}
+//# sourceMappingURL=search-term-ref.js.map

package/dist/yom/generated/yomu/yom/search-term-ref.js.map

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

package/dist/yom/generated/yomu/yom.d.ts

@@ -0,0 +1,6 @@
+export { OCRBlock, OCRBlockT } from './yom/ocrblock.js';
+export { OCRLayout, OCRLayoutT } from './yom/ocrlayout.js';
+export { OCRLine, OCRLineT } from './yom/ocrline.js';
+export { OCRPage, OCRPageT } from './yom/ocrpage.js';
+export { OCRToken, OCRTokenT } from './yom/ocrtoken.js';
+//# sourceMappingURL=yom.d.ts.map

package/dist/yom/generated/yomu/yom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yom.d.ts","sourceRoot":"","sources":["../../../../src/yom/generated/yomu/yom.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/yom/generated/yomu/yom.js

@@ -0,0 +1,8 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+export { OCRBlock, OCRBlockT } from './yom/ocrblock.js';
+export { OCRLayout, OCRLayoutT } from './yom/ocrlayout.js';
+export { OCRLine, OCRLineT } from './yom/ocrline.js';
+export { OCRPage, OCRPageT } from './yom/ocrpage.js';
+export { OCRToken, OCRTokenT } from './yom/ocrtoken.js';
+//# sourceMappingURL=yom.js.map

package/dist/yom/generated/yomu/yom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yom.js","sourceRoot":"","sources":["../../../../src/yom/generated/yomu/yom.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,oIAAoI;AAEpI,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/yom/hash.d.ts

@@ -0,0 +1,4 @@
+/** SHA-256 over `data`, returned as raw bytes (matches CryptoKit's `SHA256.hash` used natively). */
+export declare function sha256(data: Uint8Array): Promise<Uint8Array>;
+export declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+//# sourceMappingURL=hash.d.ts.map

package/dist/yom/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/yom/hash.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAGlE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAMhE"}

package/dist/yom/hash.js

@@ -0,0 +1,21 @@
+/** SHA-256 over `data`, returned as raw bytes (matches CryptoKit's `SHA256.hash` used natively). */
+export async function sha256(data) {
+    const digest = await crypto.subtle.digest("SHA-256", toArrayBuffer(data));
+    return new Uint8Array(digest);
+}
+export function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+// `crypto.subtle.digest` requires an ArrayBuffer-backed view; a Uint8Array
+// sliced from a larger buffer (e.g. via `subarray`) may have a non-zero
+// `byteOffset`, so copy defensively rather than pass `data.buffer` directly.
+function toArrayBuffer(data) {
+    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+}
+//# sourceMappingURL=hash.js.map

package/dist/yom/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/yom/hash.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB;IAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAa,EAAE,CAAa;IACrD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2EAA2E;AAC3E,wEAAwE;AACxE,6EAA6E;AAC7E,SAAS,aAAa,CAAC,IAAgB;IACrC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAgB,CAAC;AAC9F,CAAC"}

package/dist/yom/header.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Fixed binary layout shared by the YOM v1 header (4096 bytes, zero padded)
+ * and its footer mirror (the same fields, unpadded, appended at the end of
+ * the file). Mirrors the Swift implementation in
+ * `swift/Sources/YOMFormat/YOMHeader.swift` byte-for-byte:
+ * little-endian `magic(4) | formatVersion(4) | indexOffset(8) |
+ * indexCompressedLength(8) | indexUncompressedLength(8) | indexHash(32) |
+ * fileHash(32)`, 96 bytes total. Both `indexHash` and `fileHash` are zeroed
+ * out of the header/footer bytes fed into the whole-file SHA-256
+ * calculation (see `zeroingHashes`); the real digests are patched in only
+ * after that hash has been computed.
+ */
+export declare const HEADER_FIELDS_SIZE: number;
+export interface YOMHeader {
+    magic: Uint8Array;
+    formatVersion: number;
+    indexOffset: bigint;
+    indexCompressedLength: bigint;
+    indexUncompressedLength: bigint;
+    indexHash: Uint8Array;
+    fileHash: Uint8Array;
+}
+export declare class YOMHeaderParseError extends Error {
+    constructor();
+}
+/** The fixed 96-byte field block, identical for header and footer. */
+export declare function encodeHeaderFields(header: YOMHeader): Uint8Array;
+/** The full 4096-byte, zero-padded header. */
+export declare function encodeHeader(header: YOMHeader): Uint8Array;
+/** The unpadded footer mirror (just the field block). */
+export declare function encodeFooter(header: YOMHeader): Uint8Array;
+/**
+ * Parses the fixed 96-byte field block from the front of `data`. Does NOT
+ * validate magic/version/semantic correctness -- callers (reader,
+ * validator) decide what to do with the parsed values.
+ */
+export declare function parseHeaderFields(data: Uint8Array): YOMHeader;
+/**
+ * A copy with both hash fields zeroed, used as the input to the whole-file
+ * hash calculation (see module doc comment).
+ */
+export declare function zeroingHashes(header: YOMHeader): YOMHeader;
+export declare function headersEqual(a: YOMHeader, b: YOMHeader): boolean;
+//# sourceMappingURL=header.d.ts.map

package/dist/yom/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/yom/header.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAwD,CAAC;AAExF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAI7C;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAmBhE;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAK1D;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CA2B7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAM1D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAUhE"}

package/dist/yom/header.js

@@ -0,0 +1,115 @@
+import { YOM_HASH_LENGTH, YOM_HEADER_SIZE } from "./constants.js";
+/**
+ * Fixed binary layout shared by the YOM v1 header (4096 bytes, zero padded)
+ * and its footer mirror (the same fields, unpadded, appended at the end of
+ * the file). Mirrors the Swift implementation in
+ * `swift/Sources/YOMFormat/YOMHeader.swift` byte-for-byte:
+ * little-endian `magic(4) | formatVersion(4) | indexOffset(8) |
+ * indexCompressedLength(8) | indexUncompressedLength(8) | indexHash(32) |
+ * fileHash(32)`, 96 bytes total. Both `indexHash` and `fileHash` are zeroed
+ * out of the header/footer bytes fed into the whole-file SHA-256
+ * calculation (see `zeroingHashes`); the real digests are patched in only
+ * after that hash has been computed.
+ */
+export const HEADER_FIELDS_SIZE = 4 + 4 + 8 + 8 + 8 + YOM_HASH_LENGTH + YOM_HASH_LENGTH;
+export class YOMHeaderParseError extends Error {
+    constructor() {
+        super("YOM header truncated");
+    }
+}
+/** The fixed 96-byte field block, identical for header and footer. */
+export function encodeHeaderFields(header) {
+    const out = new Uint8Array(HEADER_FIELDS_SIZE);
+    const view = new DataView(out.buffer);
+    let cursor = 0;
+    out.set(header.magic, cursor);
+    cursor += 4;
+    view.setUint32(cursor, header.formatVersion, true);
+    cursor += 4;
+    view.setBigUint64(cursor, header.indexOffset, true);
+    cursor += 8;
+    view.setBigUint64(cursor, header.indexCompressedLength, true);
+    cursor += 8;
+    view.setBigUint64(cursor, header.indexUncompressedLength, true);
+    cursor += 8;
+    out.set(header.indexHash, cursor);
+    cursor += YOM_HASH_LENGTH;
+    out.set(header.fileHash, cursor);
+    cursor += YOM_HASH_LENGTH;
+    return out;
+}
+/** The full 4096-byte, zero-padded header. */
+export function encodeHeader(header) {
+    const fields = encodeHeaderFields(header);
+    const out = new Uint8Array(YOM_HEADER_SIZE);
+    out.set(fields, 0);
+    return out;
+}
+/** The unpadded footer mirror (just the field block). */
+export function encodeFooter(header) {
+    return encodeHeaderFields(header);
+}
+/**
+ * Parses the fixed 96-byte field block from the front of `data`. Does NOT
+ * validate magic/version/semantic correctness -- callers (reader,
+ * validator) decide what to do with the parsed values.
+ */
+export function parseHeaderFields(data) {
+    if (data.length < HEADER_FIELDS_SIZE)
+        throw new YOMHeaderParseError();
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    let cursor = 0;
+    const magic = data.slice(cursor, cursor + 4);
+    cursor += 4;
+    const formatVersion = view.getUint32(cursor, true);
+    cursor += 4;
+    const indexOffset = view.getBigUint64(cursor, true);
+    cursor += 8;
+    const indexCompressedLength = view.getBigUint64(cursor, true);
+    cursor += 8;
+    const indexUncompressedLength = view.getBigUint64(cursor, true);
+    cursor += 8;
+    const indexHash = data.slice(cursor, cursor + YOM_HASH_LENGTH);
+    cursor += YOM_HASH_LENGTH;
+    const fileHash = data.slice(cursor, cursor + YOM_HASH_LENGTH);
+    cursor += YOM_HASH_LENGTH;
+    return {
+        magic,
+        formatVersion,
+        indexOffset,
+        indexCompressedLength,
+        indexUncompressedLength,
+        indexHash,
+        fileHash,
+    };
+}
+/**
+ * A copy with both hash fields zeroed, used as the input to the whole-file
+ * hash calculation (see module doc comment).
+ */
+export function zeroingHashes(header) {
+    return {
+        ...header,
+        indexHash: new Uint8Array(YOM_HASH_LENGTH),
+        fileHash: new Uint8Array(YOM_HASH_LENGTH),
+    };
+}
+export function headersEqual(a, b) {
+    return (bytesEqual(a.magic, b.magic) &&
+        a.formatVersion === b.formatVersion &&
+        a.indexOffset === b.indexOffset &&
+        a.indexCompressedLength === b.indexCompressedLength &&
+        a.indexUncompressedLength === b.indexUncompressedLength &&
+        bytesEqual(a.indexHash, b.indexHash) &&
+        bytesEqual(a.fileHash, b.fileHash));
+}
+function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=header.js.map

package/dist/yom/header.js.map

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

package/dist/yom/reader.d.ts

@@ -0,0 +1,57 @@
+import type { MainIndex } from "./generated/yomu/yom/main-index.js";
+import type { PageEntry } from "./generated/yomu/yom/page-entry.js";
+import { type ByteSource, type HttpRangeOptions } from "./byteSource.js";
+/**
+ * Opens a YOM v1 packfile for random-access reading over a {@link ByteSource}
+ * -- either an in-memory buffer ({@link MemoryByteSource}) or an HTTP server
+ * that honours `Range` requests ({@link HttpRangeByteSource}). Ports the Swift
+ * implementation in `swift/Sources/YOMFormat/YOMPackfileReader.swift`.
+ *
+ * `open`/`openSource`/`openURL` read only the fixed header and the main
+ * FlatBuffers index up front -- never the blob area. The index is
+ * bounds-verified (Gap 3) before traversal; each blob read enforces the
+ * reader-side size caps (Gap 2) before decompressing, then verifies the
+ * blob's stored SHA-256 as the final gate.
+ *
+ * Because reads may hit the network, all blob accessors are `Promise`-based.
+ * `pageImage`/`thumbnailImage` never invoke zstd: page and thumbnail blobs are
+ * always `.none` compression per `requiredCompression`.
+ */
+export declare class YOMReaderError extends Error {
+}
+export declare class YOMPackfileReader {
+    readonly mainIndex: MainIndex;
+    private readonly source;
+    private readonly indexBytes;
+    private constructor();
+    /** Opens from an in-memory buffer (wraps a {@link MemoryByteSource}). */
+    static open(bytes: Uint8Array): Promise<YOMPackfileReader>;
+    /** Opens over any {@link ByteSource}. Reads only the header + index. */
+    static openSource(source: ByteSource): Promise<YOMPackfileReader>;
+    /**
+     * Opens a `.yom` over HTTP using `Range` requests -- fetching only the
+     * header + index up front, then each blob on demand. When the server does
+     * not support ranges, throws `RangeNotSupportedError` unless
+     * `fallbackToFullFetch` is set, in which case it does a single full `GET`
+     * and reads from memory.
+     */
+    static openURL(url: string, opts?: HttpRangeOptions & {
+        fallbackToFullFetch?: boolean;
+    }): Promise<YOMPackfileReader>;
+    get pageCount(): number;
+    /** The book title stored in the package's metadata, or `""` if absent. */
+    get title(): string;
+    page(index: number): PageEntry;
+    /**
+     * Reads exactly one blob's byte range, enforcing the reader-side size caps
+     * (Gap 2) before decompressing, then verifying its stored hash against the
+     * decompressed (original) bytes -- the same convention the writer uses when
+     * hashing.
+     */
+    readBlob(blobIndex: number): Promise<Uint8Array>;
+    /** Never invokes zstd -- page image blobs are always `.none` by policy. */
+    pageImage(pageIndex: number): Promise<Uint8Array>;
+    /** Never invokes zstd -- thumbnail blobs are always `.none` by policy. */
+    thumbnailImage(pageIndex: number): Promise<Uint8Array>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/yom/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/yom/reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAQpE,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAGzB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IAEpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,OAAO;IAMP,yEAAyE;WAC5D,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIhE,wEAAwE;WAC3D,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuBvE;;;;;;OAMG;WACU,OAAO,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,gBAAgB,GAAG;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAO,GAC9D,OAAO,CAAC,iBAAiB,CAAC;IAiB7B,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,0EAA0E;IAC1E,IAAI,KAAK,IAAI,MAAM,CAIlB;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAM9B;;;;;OAKG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BtD,2EAA2E;IACrE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIvD,0EAA0E;IACpE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAG7D"}

package/dist/yom/reader.js

@@ -0,0 +1,141 @@
+import { Compression } from "./generated/yomu/yom/compression.js";
+import { YOM_FORMAT_VERSION, YOM_HEADER_SIZE, YOM_MAGIC } from "./constants.js";
+import { parseHeaderFields } from "./header.js";
+import { bytesEqual, sha256 } from "./hash.js";
+import { zstdDecompress } from "./zstd.js";
+import { getVerifiedRootAsMainIndex } from "./flatbufferVerify.js";
+import { enforceBlobSizePolicy } from "./blobLimits.js";
+import { HttpRangeByteSource, MemoryByteSource, } from "./byteSource.js";
+import { RangeNotSupportedError } from "./errors.js";
+/**
+ * Opens a YOM v1 packfile for random-access reading over a {@link ByteSource}
+ * -- either an in-memory buffer ({@link MemoryByteSource}) or an HTTP server
+ * that honours `Range` requests ({@link HttpRangeByteSource}). Ports the Swift
+ * implementation in `swift/Sources/YOMFormat/YOMPackfileReader.swift`.
+ *
+ * `open`/`openSource`/`openURL` read only the fixed header and the main
+ * FlatBuffers index up front -- never the blob area. The index is
+ * bounds-verified (Gap 3) before traversal; each blob read enforces the
+ * reader-side size caps (Gap 2) before decompressing, then verifies the
+ * blob's stored SHA-256 as the final gate.
+ *
+ * Because reads may hit the network, all blob accessors are `Promise`-based.
+ * `pageImage`/`thumbnailImage` never invoke zstd: page and thumbnail blobs are
+ * always `.none` compression per `requiredCompression`.
+ */
+export class YOMReaderError extends Error {
+}
+export class YOMPackfileReader {
+    mainIndex;
+    source;
+    // Retained so the index ByteBuffer that `mainIndex` reads from stays alive.
+    indexBytes;
+    constructor(source, indexBytes, mainIndex) {
+        this.source = source;
+        this.indexBytes = indexBytes;
+        this.mainIndex = mainIndex;
+    }
+    /** Opens from an in-memory buffer (wraps a {@link MemoryByteSource}). */
+    static async open(bytes) {
+        return YOMPackfileReader.openSource(new MemoryByteSource(bytes));
+    }
+    /** Opens over any {@link ByteSource}. Reads only the header + index. */
+    static async openSource(source) {
+        if (source.size < YOM_HEADER_SIZE)
+            throw new YOMReaderError("file too small");
+        const headerBytes = await source.read(0, YOM_HEADER_SIZE);
+        const header = parseHeaderFields(headerBytes);
+        if (!bytesEqual(header.magic, YOM_MAGIC))
+            throw new YOMReaderError("bad magic");
+        if (header.formatVersion !== YOM_FORMAT_VERSION) {
+            throw new YOMReaderError(`unsupported format version ${header.formatVersion}`);
+        }
+        const indexOffset = Number(header.indexOffset);
+        const indexLength = Number(header.indexUncompressedLength);
+        if (indexOffset < YOM_HEADER_SIZE || indexOffset + indexLength > source.size) {
+            throw new YOMReaderError("index out of bounds");
+        }
+        const indexBytes = await source.read(indexOffset, indexLength);
+        // Cheap root + vector-length bounds verify on the hot open path (Gap 3).
+        const mainIndex = getVerifiedRootAsMainIndex(indexBytes, false);
+        return new YOMPackfileReader(source, indexBytes, mainIndex);
+    }
+    /**
+     * Opens a `.yom` over HTTP using `Range` requests -- fetching only the
+     * header + index up front, then each blob on demand. When the server does
+     * not support ranges, throws `RangeNotSupportedError` unless
+     * `fallbackToFullFetch` is set, in which case it does a single full `GET`
+     * and reads from memory.
+     */
+    static async openURL(url, opts = {}) {
+        const { fallbackToFullFetch, ...rangeOpts } = opts;
+        try {
+            const source = await HttpRangeByteSource.create(url, rangeOpts);
+            return await YOMPackfileReader.openSource(source);
+        }
+        catch (err) {
+            if (fallbackToFullFetch && err instanceof RangeNotSupportedError) {
+                const fetchFn = rangeOpts.fetch ?? ((input, init) => fetch(input, init));
+                const res = await fetchFn(url, { headers: rangeOpts.headers, signal: rangeOpts.signal });
+                if (!res.ok)
+                    throw new YOMReaderError(`full fetch failed with status ${res.status} for ${url}`);
+                const bytes = new Uint8Array(await res.arrayBuffer());
+                return YOMPackfileReader.openSource(new MemoryByteSource(bytes));
+            }
+            throw err;
+        }
+    }
+    get pageCount() {
+        return this.mainIndex.pagesLength();
+    }
+    /** The book title stored in the package's metadata, or `""` if absent. */
+    get title() {
+        const book = this.mainIndex.book();
+        const title = book?.title();
+        return typeof title === "string" ? title : "";
+    }
+    page(index) {
+        const page = this.mainIndex.pages(index);
+        if (!page)
+            throw new YOMReaderError("page index out of range");
+        return page;
+    }
+    /**
+     * Reads exactly one blob's byte range, enforcing the reader-side size caps
+     * (Gap 2) before decompressing, then verifying its stored hash against the
+     * decompressed (original) bytes -- the same convention the writer uses when
+     * hashing.
+     */
+    async readBlob(blobIndex) {
+        if (blobIndex < 0 || blobIndex >= this.mainIndex.blobsLength()) {
+            throw new YOMReaderError("blob index out of range");
+        }
+        const blob = this.mainIndex.blobs(blobIndex);
+        if (!blob)
+            throw new YOMReaderError("blob index out of range");
+        const start = Number(blob.offset());
+        const compressedLength = Number(blob.compressedLength());
+        const uncompressedLength = Number(blob.uncompressedLength());
+        if (start < 0 || compressedLength < 0 || start + compressedLength > this.source.size) {
+            throw new YOMReaderError("blob out of bounds");
+        }
+        enforceBlobSizePolicy(blob.kind(), compressedLength, uncompressedLength);
+        const rawBytes = await this.source.read(start, compressedLength);
+        const original = blob.compression() === Compression.None ? rawBytes : await zstdDecompress(rawBytes, uncompressedLength);
+        const actualHash = await sha256(original);
+        const expectedHash = blob.hashArray();
+        if (!expectedHash || !bytesEqual(actualHash, expectedHash)) {
+            throw new YOMReaderError("blob hash mismatch");
+        }
+        return original;
+    }
+    /** Never invokes zstd -- page image blobs are always `.none` by policy. */
+    async pageImage(pageIndex) {
+        return this.readBlob(this.page(pageIndex).pageImageBlobIndex());
+    }
+    /** Never invokes zstd -- thumbnail blobs are always `.none` by policy. */
+    async thumbnailImage(pageIndex) {
+        return this.readBlob(this.page(pageIndex).thumbnailBlobIndex());
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/yom/reader.js.map

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

package/dist/yom/searchIndex.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Builds YOM's search dictionary + postings blobs over normalized text
+ * (`textNormalizer.ts` output), using character bigrams. Ports the Swift
+ * implementation in `swift/Sources/YOMFormat/YOMSearchIndexBuilder.swift`.
+ *
+ * **Dictionary blob**: the concatenated UTF-8 bytes of every term, in sorted
+ * order. Redundant with `SearchTermRef.term` in the main index but is a
+ * deliberately simple, schema-valid choice (see the Swift source's doc
+ * comment) -- the format only requires the byte range exist, not that it
+ * hold any particular content.
+ *
+ * **Postings blob**: for each term, a delta+varint-encoded sequence of
+ * `(page, position)` hits sorted by page then position, where `position` is
+ * the *code-point* offset within that page's normalized text. Never
+ * compressed (`.none`) per the fixed policy.
+ *
+ * Iterates by Unicode code point (`Array.from`), the closest JS analogue of
+ * Swift's extended-grapheme-cluster `Character` iteration -- the two only
+ * diverge for combining marks/emoji sequences, which NFKC-normalized
+ * Japanese book text does not produce in practice.
+ */
+export interface SearchTerm {
+    term: string;
+    dictionaryOffset: number;
+    dictionaryLength: number;
+    postingsOffset: number;
+    postingsLength: number;
+}
+export interface SearchIndexResult {
+    dictionaryBlob: Uint8Array;
+    postingsBlob: Uint8Array;
+    searchTerms: SearchTerm[];
+}
+export interface Hit {
+    page: number;
+    position: number;
+}
+export declare function buildSearchIndex(normalizedPageTexts: string[]): SearchIndexResult;
+/** Decodes one term's postings byte range back into `(page, position)` hits. */
+export declare function decodePostings(blob: Uint8Array): Hit[];
+//# sourceMappingURL=searchIndex.d.ts.map