docxodus 12.4.0 → 12.5.0

package/dist/export-assets.json

@@ -1,19 +1,19 @@
 {
   "schema": "https://docxodus.dev/schemas/export/export-assets/v1",
   "schemaVersion": 1,
-  "packageVersion": "12.4.0",
+  "packageVersion": "12.5.0",
   "assets": [
     {
       "path": "./docxodus.worker.js",
       "mediaType": "text/javascript",
-      "byteLength": 24687,
-      "sha256": "7df9140c9554700f668539b84c61ac700b150404c4d861a346522154d6c787d7"
+      "byteLength": 34100,
+      "sha256": "d1f99e117dd531896d72c4ed30aa89a32790ff8dfccc3c12edd297506df39282"
     },
     {
       "path": "./export-browser.bundle.js",
       "mediaType": "text/javascript",
-      "byteLength": 324788,
-      "sha256": "8b0e71f4c52137f689d3317560f5614f15e208b250d37d13a51b55f03ee5f3fc"
+      "byteLength": 328496,
+      "sha256": "1a44e2ded4b32612022e413cd8c9a8e6240e9c8c6ee5376195a9d18f00e07eea"
     },
     {
       "path": "./export-resource-limits-v1.json",
@@ -48,74 +48,74 @@
     {
       "path": "./wasm/_framework/Docxodus.wasm",
       "mediaType": "application/wasm",
-      "byteLength": 4023577,
-      "sha256": "68d6226658f2556c7abcd278b4d207911d9e0087c0a96d4cccf6cf47db2a5d6a"
+      "byteLength": 4619545,
+      "sha256": "0d8c5a6064cef2b935eefb041668da7fe7461e14679a44569d1a3616eef34941"
     },
     {
       "path": "./wasm/_framework/DocxodusWasm.wasm",
       "mediaType": "application/wasm",
-      "byteLength": 507669,
-      "sha256": "cc737bbac62bc60b434367dc3e2d6593679a55df121d774c2514a85f5f4a5296"
+      "byteLength": 520981,
+      "sha256": "f0bb0fbec335eb27fa9e57673aaf319b71d682911771f579350e8df845c2902a"
     },
     {
       "path": "./wasm/_framework/System.Collections.Concurrent.wasm",
       "mediaType": "application/wasm",
       "byteLength": 23829,
-      "sha256": "c66981ef3497fc369fb144157fb048fcb28d54b4f6219dc01387d5f6f1ee4e9b"
+      "sha256": "08f4afc87ca78fd60381ed30bbeaec951a0b931f231e42433307645fb8160786"
     },
     {
       "path": "./wasm/_framework/System.Collections.Immutable.wasm",
       "mediaType": "application/wasm",
       "byteLength": 29973,
-      "sha256": "12ea45b1b88f9c35e242a8c39aba33bc94926099980dedb1ec10d53422367feb"
+      "sha256": "311f6d3c9a2ef199d2a00c4206007589d94c6a1a290b03d10cd0fe6fb9ae7b50"
     },
     {
       "path": "./wasm/_framework/System.Collections.NonGeneric.wasm",
       "mediaType": "application/wasm",
       "byteLength": 13589,
-      "sha256": "dfdd4a6b16e1fe76a9f7c65a1e380de361a4027c3cca1c629626decd081b38b6"
+      "sha256": "5ec0ca537eaa08ebbb4c7a88ecededc9caf10d38875b75cacfe19c388fcc41a9"
     },
     {
       "path": "./wasm/_framework/System.Collections.Specialized.wasm",
       "mediaType": "application/wasm",
       "byteLength": 9493,
-      "sha256": "05350ef3a8f17ad146490cce830464c41df76c9788fa6678324d7bd3d13d3c32"
+      "sha256": "979425164e71cba50a8141750ca7cd89e673b57e65a39af53616adf55563597f"
     },
     {
       "path": "./wasm/_framework/System.Collections.wasm",
       "mediaType": "application/wasm",
       "byteLength": 62229,
-      "sha256": "d8aba69be9b8c6bc4e2da673a10287ed479f4cd33a0423aa08292291729f8b9d"
+      "sha256": "64e468568fc95500e61b969fb9aae2258f4424e18c325be91db48e8b7a129b14"
     },
     {
       "path": "./wasm/_framework/System.ComponentModel.Primitives.wasm",
       "mediaType": "application/wasm",
       "byteLength": 7445,
-      "sha256": "90d6404c66fac608d46039b70ba728655341b7da2d9e89769726aef717958c0d"
+      "sha256": "b63fa548d31dfe982447f6022fb21a2c20d8f76521d50c678b881c564a53c431"
     },
     {
       "path": "./wasm/_framework/System.ComponentModel.TypeConverter.wasm",
       "mediaType": "application/wasm",
       "byteLength": 45333,
-      "sha256": "2d0814088cb3bec0836b563efba3ba35d710f2e084b1bb7ba5d085ad3e594975"
+      "sha256": "e42905fcc6b0c1950bef91b2924e24771ecee33b9460a9d9efcbaa92de046a9e"
     },
     {
       "path": "./wasm/_framework/System.ComponentModel.wasm",
       "mediaType": "application/wasm",
       "byteLength": 4885,
-      "sha256": "81139dd6618f1fc15a120ce1d275090442fc303fdda107391885ba609603dd6e"
+      "sha256": "ae61d7fef3fc207808051425e9cd66606bad3060ce2fd8ab6b21b4dd8b9a760f"
     },
     {
       "path": "./wasm/_framework/System.Console.wasm",
       "mediaType": "application/wasm",
       "byteLength": 15125,
-      "sha256": "8cdaa520b4acc334ae4fcd14476660e2df49a9818ecbd3ca6f6bc3e18129d950"
+      "sha256": "d8b1ae2a6c4e375e19e99807ebfa7512f7ba3df3dc39004ba4c8e6f9922fb615"
     },
     {
       "path": "./wasm/_framework/System.IO.Compression.wasm",
       "mediaType": "application/wasm",
       "byteLength": 112917,
-      "sha256": "40c8f37b71f7f0429245bddc090660df4e7da9e5f4be9ebb790573161d8e725b"
+      "sha256": "ade57aa1e200ff4462322a483f2d9fce5c4c5e10a6c6f2d413b2a27c2265f931"
     },
     {
       "path": "./wasm/_framework/System.IO.Packaging.wasm",
@@ -127,151 +127,151 @@
       "path": "./wasm/_framework/System.IO.Pipelines.wasm",
       "mediaType": "application/wasm",
       "byteLength": 5909,
-      "sha256": "2134c1b434b0d4642927084ae50eab04c0becc6fab14d82a7043d45536dc9bd1"
+      "sha256": "bcada4bfc72a9e80a7c1cd85d8dae0157352efaf9ad026455fe7a9dc820beed6"
     },
     {
       "path": "./wasm/_framework/System.Linq.Expressions.wasm",
       "mediaType": "application/wasm",
       "byteLength": 75541,
-      "sha256": "3e995b01db75188ddfbe1cd7d6a9c79a5e5157accae2c014c3f8e738a6c0d5d2"
+      "sha256": "ced08b53e2a822351d5e2a91052322d9cef3f04e39dde848a28491c59418c2c5"
     },
     {
       "path": "./wasm/_framework/System.Linq.wasm",
       "mediaType": "application/wasm",
       "byteLength": 90389,
-      "sha256": "c7678647f3924e3662a645cd430fe07818bf84e9e2d445a94dd482d6eed3ea76"
+      "sha256": "ab60b177059a48649e0678944374497e363896d5ed0233ed3d3c8a335b025344"
     },
     {
       "path": "./wasm/_framework/System.Memory.wasm",
       "mediaType": "application/wasm",
       "byteLength": 15637,
-      "sha256": "932580e803adc1d782b98664ab4fc9322b44700d0cd3acd15f56b365a9ac0d3a"
+      "sha256": "c842d872878d5ead014aedb34db23742b15e619ead1842b2c8f95b7d4c8039ac"
     },
     {
       "path": "./wasm/_framework/System.Net.Http.wasm",
       "mediaType": "application/wasm",
       "byteLength": 139029,
-      "sha256": "11a8214a232ccb048b1677eb7cae573db85590b5662a60ce6d4a87f151aa8867"
+      "sha256": "ce9bad577e8d06e93292c38284e5b6f4c717eb0886597ed38b538799975ae052"
     },
     {
       "path": "./wasm/_framework/System.Net.Primitives.wasm",
       "mediaType": "application/wasm",
       "byteLength": 7445,
-      "sha256": "24eaddecedb011251881efcf4588debb7a2807ac99e65dfa79785c1dd3deeb1b"
+      "sha256": "7929262d69d9dd1912c104c7eddba715733053e04ce02df9afd76f773012bd49"
     },
     {
       "path": "./wasm/_framework/System.ObjectModel.wasm",
       "mediaType": "application/wasm",
       "byteLength": 12565,
-      "sha256": "906053af64d8d294054fe2f03be527ae0bdbdfa292d73ac1b2cf058a734f705f"
+      "sha256": "4d1c98b1721b240b7fbde308671954ffb72ab7e892b308abe6c37b1a9b8baab3"
     },
     {
       "path": "./wasm/_framework/System.Private.CoreLib.wasm",
       "mediaType": "application/wasm",
-      "byteLength": 1650965,
-      "sha256": "813b21d926c9350da8bd3e24fb3feed29826219a15ecd4c9abcac61bbba4405e"
+      "byteLength": 1651477,
+      "sha256": "f9ee2281c6a4d626bac4607ae3e1b64a2df4cd1dfbc9a285dbc3e019913d4667"
     },
     {
       "path": "./wasm/_framework/System.Private.Uri.wasm",
       "mediaType": "application/wasm",
       "byteLength": 70933,
-      "sha256": "bdeca25946ac6e99c7593c1928ce47884a6d8b4402cb846749edef051cbc025d"
+      "sha256": "e9112c7fa56294400694ded9ae2daf4c6273fbf5621e70e2d3ce92e2ea0315bf"
     },
     {
       "path": "./wasm/_framework/System.Private.Xml.Linq.wasm",
       "mediaType": "application/wasm",
-      "byteLength": 66837,
-      "sha256": "e552e04d433e84f3eab3ebdc03deb723e915f0872401beed920cbf7764845084"
+      "byteLength": 67349,
+      "sha256": "557d594fa02c46dddf4a8fac43f6880a66b0f271f9f976c7f755e7f18896b49f"
     },
     {
       "path": "./wasm/_framework/System.Private.Xml.wasm",
       "mediaType": "application/wasm",
       "byteLength": 893205,
-      "sha256": "373b21d63467cd116241edee5631e4b376a03cb04a40af30c843fce836723b83"
+      "sha256": "f7cc319961d6ee1a8a730f3f260d3e0f771ab45a5498f7663e03f1e548fe259a"
     },
     {
       "path": "./wasm/_framework/System.Runtime.InteropServices.JavaScript.wasm",
       "mediaType": "application/wasm",
       "byteLength": 43797,
-      "sha256": "32cdacd4bc6b19490dcff9ee0f3a5fc8cf59860e2b508d4c97b3ecb1963da73e"
+      "sha256": "c2feec3f56b8c7a82e4aac54796241b3b330c57837d018698da3173d75427882"
     },
     {
       "path": "./wasm/_framework/System.Runtime.wasm",
       "mediaType": "application/wasm",
       "byteLength": 7957,
-      "sha256": "98dcb93c81ebc5006cf53c1daaee5b645431fb82aaa232ebe8abea801b7ab090"
+      "sha256": "8612e02d85097f3839231b0793dc8c7922e7d1fb5e6070d530727d4e06a29dc5"
     },
     {
       "path": "./wasm/_framework/System.Security.Cryptography.wasm",
       "mediaType": "application/wasm",
       "byteLength": 25365,
-      "sha256": "b13fda07394f658bfbc62baf960c66ed00273c4bc6b88f498f248974875c322d"
+      "sha256": "c0698926d06df7efb0bdba06e1489b23f061ea810f8e9a666efd0d8f9b008a18"
     },
     {
       "path": "./wasm/_framework/System.Text.Encodings.Web.wasm",
       "mediaType": "application/wasm",
       "byteLength": 29461,
-      "sha256": "fa4756a02716dc32ed7887d4b7a4a503e4315b968c340e48b7fe8eb44716de55"
+      "sha256": "7fb8c2aaaa4472a075226792ca9a6c653d810b2e28776aeda842013a3db90039"
     },
     {
       "path": "./wasm/_framework/System.Text.Json.wasm",
       "mediaType": "application/wasm",
-      "byteLength": 319253,
-      "sha256": "2ac232862e33154b80d4dc738f5b5a696ee96f5d435de7cba804ecc1673350eb"
+      "byteLength": 321301,
+      "sha256": "7448e3de4c4796314a14fa0869b7b81992dfa627b5624c717d30191b5b0812c2"
     },
     {
       "path": "./wasm/_framework/System.Text.RegularExpressions.wasm",
       "mediaType": "application/wasm",
       "byteLength": 258325,
-      "sha256": "282a9d69941dce33ba2187a24789b751173f0d6fb0181372a2ba413ff8d8264c"
+      "sha256": "c80f4b49565b32d50a15ec53e09ffbcfdb35472bc0161eca293737a30d76b150"
     },
     {
       "path": "./wasm/_framework/System.Xml.Linq.wasm",
       "mediaType": "application/wasm",
       "byteLength": 4373,
-      "sha256": "0ad08454c5421a0f47a07b4816f1b00222c626b83e2a02264bea1cf29bab044f"
+      "sha256": "7b9b71b657b457f8e567ee656b11defa4da8db17b01e1eba015a43ae3f325e57"
     },
     {
       "path": "./wasm/_framework/System.Xml.XDocument.wasm",
       "mediaType": "application/wasm",
       "byteLength": 4885,
-      "sha256": "4a533202e5c3bd64ea6f31625c5813fe09d5c269261d9e7fe3f04b26b5901c14"
+      "sha256": "13a711cccfeeaba38ada0d64175c49d2f572056ae0b552616347bcb64d68149a"
     },
     {
       "path": "./wasm/_framework/System.wasm",
       "mediaType": "application/wasm",
       "byteLength": 4885,
-      "sha256": "cbb3675a1f33f203ee280408e218412faf72d9eecd9586c7643bf20db1414c72"
+      "sha256": "bcf126d8aaa05eaaee1b09f3ef5f224a0983a01f089a0ee21f71733b9edbd118"
     },
     {
       "path": "./wasm/_framework/dotnet.boot.js",
       "mediaType": "text/javascript",
       "byteLength": 9374,
-      "sha256": "97a91a74bafc09d6fe939db7b4fbea3f237b58b6370783ac03d9e9869b67f760"
+      "sha256": "e6a30494914803e35644dc1db56322d051bf3b2ed2d0b5244a0e2ef14c63e11f"
     },
     {
       "path": "./wasm/_framework/dotnet.js",
       "mediaType": "text/javascript",
       "byteLength": 37884,
-      "sha256": "68f32af54f83c3633eac3ada6fed3e20c026386e1cdcaf137918cbfc02b2b25e"
+      "sha256": "5e8a03bf4210aa377a0a399b2b083bb8cbd0711ea9c0bdc24247814174024cf1"
     },
     {
       "path": "./wasm/_framework/dotnet.native.js",
       "mediaType": "text/javascript",
       "byteLength": 224345,
-      "sha256": "adf5c4ec92c46f0aa40fd668bec0472dc4984e889bc99df88a964c0e2c652c57"
+      "sha256": "1043e68414a17fa58a47cfaeec5bd181a95da9975541e52305dd956c9490be0b"
     },
     {
       "path": "./wasm/_framework/dotnet.native.wasm",
       "mediaType": "application/wasm",
-      "byteLength": 8549433,
-      "sha256": "4c0695671b4dc37cfd469fc5a5d10ee1f5f9f4f64ebef12238a850272e0e01ef"
+      "byteLength": 8485433,
+      "sha256": "d2960afcfa2fe5f92ea23e29e7bb6af4f24d3f21d3536a0e8af4440165dcfce5"
     },
     {
       "path": "./wasm/_framework/dotnet.runtime.js",
       "mediaType": "text/javascript",
       "byteLength": 198480,
-      "sha256": "319320bb291ef42ae849097e2ff4872061643d30fe2ed6065e45e302fc16c78d"
+      "sha256": "41b9eaad9187b46abbc2e752d7bfc06043e91fd264a61aecc959650fa24799db"
     }
   ]
 }

package/dist/export-browser.bundle.js

@@ -3177,6 +3177,37 @@ var PaginationEngine = class {
   }
 };
 
+// src/verification-request.ts
+function serializeVerificationRequest(request) {
+  if (request === null || typeof request !== "object" || Array.isArray(request)) {
+    throw new RangeError("a verification request must be an object");
+  }
+  const { companionArtifacts, ...rest } = request;
+  const wire = { ...rest };
+  if (companionArtifacts !== void 0) {
+    wire.companionArtifacts = companionArtifacts.map(encodeCompanion);
+  }
+  return JSON.stringify(wire);
+}
+function encodeCompanion(artifact) {
+  const { bytes, ...rest } = artifact;
+  const wire = { ...rest };
+  if (bytes !== void 0) wire.bytesB64 = bytesToBase64(bytes);
+  return wire;
+}
+function bytesToBase64(bytes) {
+  if (typeof btoa === "function") {
+    let binary = "";
+    const chunkSize = 32768;
+    for (let i = 0; i < bytes.length; i += chunkSize) {
+      const chunk = bytes.subarray(i, i + chunkSize);
+      binary += String.fromCharCode.apply(null, chunk);
+    }
+    return btoa(binary);
+  }
+  return Buffer.from(bytes).toString("base64");
+}
+
 // src/worker-proxy.ts
 var WorkerOperationError = class extends Error {
   constructor(message, code) {
@@ -3302,7 +3333,7 @@ async function createWorkerDocxodus(options) {
       );
       return response.manifest;
     },
-    async verifyDeliverable(document2, baseline) {
+    async verifyDeliverable(document2, baseline, request) {
       const bytes = await toBytes(document2);
       const baselineBytes = baseline === void 0 ? void 0 : await toBytes(baseline);
       const transfer = [bytes.buffer];
@@ -3312,7 +3343,8 @@ async function createWorkerDocxodus(options) {
           id: generateId(),
           type: "verifyDeliverable",
           documentBytes: bytes,
-          baselineBytes
+          baselineBytes,
+          requestJson: request === void 0 ? void 0 : serializeVerificationRequest(request)
         },
         transfer
       );
@@ -3355,6 +3387,70 @@ async function createWorkerDocxodus(options) {
       );
       return response.semanticChanges;
     },
+    async createExternalAnnotationSet(document2, documentId) {
+      const bytes = await toBytes(document2);
+      const response = await sendRequest(
+        { id: generateId(), type: "createExternalAnnotationSet", documentBytes: bytes, documentId },
+        [bytes.buffer]
+      );
+      if (!response.success || !response.annotationSet) {
+        throw new Error(response.error ?? "createExternalAnnotationSet failed");
+      }
+      return response.annotationSet;
+    },
+    async validateExternalAnnotations(document2, annotationSet) {
+      const bytes = await toBytes(document2);
+      const response = await sendRequest(
+        { id: generateId(), type: "validateExternalAnnotations", documentBytes: bytes, annotationSet },
+        [bytes.buffer]
+      );
+      if (!response.success || !response.validation) {
+        throw new Error(response.error ?? "validateExternalAnnotations failed");
+      }
+      return response.validation;
+    },
+    async projectAnnotationsOntoHtml(html, annotationSet, projectionOptions) {
+      const response = await sendRequest({
+        id: generateId(),
+        type: "projectAnnotationsOntoHtml",
+        html,
+        annotationSet,
+        projectionOptions
+      });
+      if (!response.success || response.html === void 0) {
+        throw new Error(response.error ?? "projectAnnotationsOntoHtml failed");
+      }
+      return response.html;
+    },
+    async convertDocxToHtmlWithExternalAnnotations(document2, annotationSet, conversionOptions2, projectionOptions) {
+      const bytes = await toBytes(document2);
+      const response = await sendRequest(
+        {
+          id: generateId(),
+          type: "convertDocxToHtmlWithExternalAnnotations",
+          documentBytes: bytes,
+          annotationSet,
+          conversionOptions: conversionOptions2,
+          projectionOptions
+        },
+        [bytes.buffer]
+      );
+      if (!response.success || response.html === void 0) {
+        throw new Error(response.error ?? "convertDocxToHtmlWithExternalAnnotations failed");
+      }
+      return response.html;
+    },
+    async exportToOpenContract(document2) {
+      const bytes = await toBytes(document2);
+      const response = await sendRequest(
+        { id: generateId(), type: "exportToOpenContract", documentBytes: bytes },
+        [bytes.buffer]
+      );
+      if (!response.success || !response.export) {
+        throw new Error(response.error ?? "exportToOpenContract failed");
+      }
+      return response.export;
+    },
     async generatePackageManifestJson(document2, limits) {
       const bytes = await toBytes(document2);
       const response = await sendRequest(
@@ -3518,11 +3614,12 @@ async function createWorkerDocxodus(options) {
           }
           return res.semanticChanges;
         },
-        async verifyDeliverable() {
+        async verifyDeliverable(request) {
           const res = await sendRequest({
             id: generateId(),
             type: "sessionVerifyDeliverable",
-            handle
+            handle,
+            requestJson: request === void 0 ? void 0 : serializeVerificationRequest(request)
           });
           if (!res.success || !res.verification) {
             throw new Error(res.error ?? "sessionVerifyDeliverable failed");

package/dist/external-annotation-wire.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Wire-shape readers for the external annotation family.
+ *
+ * The engine serializes these results with PascalCase property names (and older builds with
+ * camelCase), so every consumer has to normalize them once. The main-thread entry points in
+ * `core.ts` and the Web Worker (`docxodus.worker.ts`) both read through here, which is what
+ * lets the worker hand back the same typed objects the main thread would without a second
+ * copy of the mapping.
+ */
+import type { ExternalAnnotationSet, ExternalAnnotationValidationResult, OpenContractDocExport } from "./types.js";
+/** Read an OpenContracts document export from the engine's parsed JSON. */
+export declare function readOpenContractExport(parsed: any): OpenContractDocExport;
+/** Read an external annotation set — an OpenContracts export plus identity and label tables. */
+export declare function readExternalAnnotationSet(parsed: any): ExternalAnnotationSet;
+/** Read the result of validating an annotation set against a document. */
+export declare function readExternalAnnotationValidation(parsed: any): ExternalAnnotationValidationResult;
+/** The engine wraps projected HTML in a small JSON envelope; unwrap it. */
+export declare function readProjectedHtml(parsed: any): string;
+//# sourceMappingURL=external-annotation-wire.d.ts.map

package/dist/external-annotation-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-annotation-wire.d.ts","sourceRoot":"","sources":["../src/external-annotation-wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEV,qBAAqB,EACrB,kCAAkC,EAClC,qBAAqB,EAMtB,MAAM,YAAY,CAAC;AAgGpB,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,qBAAqB,CAWzE;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,GAAG,qBAAqB,CAW5E;AAED,0EAA0E;AAC1E,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,GAAG,GAAG,kCAAkC,CAYhG;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAErD"}

package/dist/external-annotation-wire.js

@@ -0,0 +1,139 @@
+/**
+ * Wire-shape readers for the external annotation family.
+ *
+ * The engine serializes these results with PascalCase property names (and older builds with
+ * camelCase), so every consumer has to normalize them once. The main-thread entry points in
+ * `core.ts` and the Web Worker (`docxodus.worker.ts`) both read through here, which is what
+ * lets the worker hand back the same typed objects the main thread would without a second
+ * copy of the mapping.
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+function readPawlsPage(p) {
+    return {
+        page: {
+            width: p.Page?.Width ?? p.page?.width,
+            height: p.Page?.Height ?? p.page?.height,
+            index: p.Page?.Index ?? p.page?.index,
+        },
+        tokens: (p.Tokens || p.tokens || []).map((t) => ({
+            x: t.X ?? t.x,
+            y: t.Y ?? t.y,
+            width: t.Width ?? t.width,
+            height: t.Height ?? t.height,
+            text: t.Text ?? t.text,
+        })),
+    };
+}
+function readAnnotationJson(json) {
+    if (!json)
+        return undefined;
+    // A text span carries offsets; anything else is a page-keyed dictionary.
+    if (json.Start !== undefined || json.start !== undefined) {
+        return {
+            id: json.Id ?? json.id,
+            start: json.Start ?? json.start,
+            end: json.End ?? json.end,
+            text: json.Text ?? json.text,
+        };
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(json)) {
+        const v = value;
+        result[key] = {
+            bounds: {
+                top: v.Bounds?.Top ?? v.bounds?.top,
+                bottom: v.Bounds?.Bottom ?? v.bounds?.bottom,
+                left: v.Bounds?.Left ?? v.bounds?.left,
+                right: v.Bounds?.Right ?? v.bounds?.right,
+            },
+            tokensJsons: (v.TokensJsons || v.tokensJsons || []).map((t) => ({
+                pageIndex: t.PageIndex ?? t.pageIndex,
+                tokenIndex: t.TokenIndex ?? t.tokenIndex,
+            })),
+            rawText: v.RawText ?? v.rawText,
+        };
+    }
+    return result;
+}
+function readAnnotation(a) {
+    return {
+        id: a.Id ?? a.id,
+        annotationLabel: a.AnnotationLabel ?? a.annotationLabel,
+        rawText: a.RawText ?? a.rawText,
+        page: a.Page ?? a.page,
+        annotationJson: readAnnotationJson(a.AnnotationJson ?? a.annotationJson),
+        parentId: a.ParentId ?? a.parentId,
+        annotationType: a.AnnotationType ?? a.annotationType,
+        structural: a.Structural ?? a.structural,
+    };
+}
+function readRelationship(r) {
+    return {
+        id: r.Id ?? r.id,
+        relationshipLabel: r.RelationshipLabel ?? r.relationshipLabel,
+        sourceAnnotationIds: r.SourceAnnotationIds ?? r.sourceAnnotationIds ?? [],
+        targetAnnotationIds: r.TargetAnnotationIds ?? r.targetAnnotationIds ?? [],
+        structural: r.Structural ?? r.structural,
+    };
+}
+function readLabel(l) {
+    return {
+        id: l.Id ?? l.id,
+        color: l.Color ?? l.color,
+        description: l.Description ?? l.description ?? "",
+        icon: l.Icon ?? l.icon ?? "",
+        text: l.Text ?? l.text,
+        labelType: l.LabelType ?? l.labelType ?? "text",
+    };
+}
+function readLabels(raw) {
+    const labels = {};
+    for (const [key, value] of Object.entries(raw || {}))
+        labels[key] = readLabel(value);
+    return labels;
+}
+/** Read an OpenContracts document export from the engine's parsed JSON. */
+export function readOpenContractExport(parsed) {
+    return {
+        title: parsed.Title ?? parsed.title,
+        content: parsed.Content ?? parsed.content,
+        description: parsed.Description ?? parsed.description,
+        pageCount: parsed.PageCount ?? parsed.pageCount,
+        pawlsFileContent: (parsed.PawlsFileContent || parsed.pawlsFileContent || []).map(readPawlsPage),
+        docLabels: parsed.DocLabels ?? parsed.docLabels ?? [],
+        labelledText: (parsed.LabelledText || parsed.labelledText || []).map(readAnnotation),
+        relationships: (parsed.Relationships || parsed.relationships)?.map(readRelationship),
+    };
+}
+/** Read an external annotation set — an OpenContracts export plus identity and label tables. */
+export function readExternalAnnotationSet(parsed) {
+    return {
+        documentId: parsed.DocumentId ?? parsed.documentId,
+        documentHash: parsed.DocumentHash ?? parsed.documentHash,
+        createdAt: parsed.CreatedAt ?? parsed.createdAt,
+        updatedAt: parsed.UpdatedAt ?? parsed.updatedAt,
+        version: parsed.Version ?? parsed.version,
+        ...readOpenContractExport(parsed),
+        textLabels: readLabels(parsed.TextLabels || parsed.textLabels),
+        docLabelDefinitions: readLabels(parsed.DocLabelDefinitions || parsed.docLabelDefinitions),
+    };
+}
+/** Read the result of validating an annotation set against a document. */
+export function readExternalAnnotationValidation(parsed) {
+    return {
+        isValid: parsed.IsValid ?? parsed.isValid,
+        hashMismatch: parsed.HashMismatch ?? parsed.hashMismatch,
+        issues: (parsed.Issues || parsed.issues || []).map((i) => ({
+            annotationId: i.AnnotationId ?? i.annotationId,
+            issueType: i.IssueType ?? i.issueType,
+            description: i.Description ?? i.description,
+            expectedText: i.ExpectedText ?? i.expectedText,
+            actualText: i.ActualText ?? i.actualText,
+        })),
+    };
+}
+/** The engine wraps projected HTML in a small JSON envelope; unwrap it. */
+export function readProjectedHtml(parsed) {
+    return parsed.Html ?? parsed.html;
+}
+//# sourceMappingURL=external-annotation-wire.js.map

package/dist/external-annotation-wire.js.map

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