@docmentis/udoc-wasm 0.0.0-stage → 0.8.1

package/LICENSE

@@ -0,0 +1,434 @@
+docMentis WASM Runtime License
+Version 2.0 - October 22, 2026
+Copyright (c) 2026 docMentis LLC. All rights reserved.
+
+THIS IS A PROPRIETARY SOFTWARE LICENSE, NOT AN OPEN-SOURCE LICENSE.
+
+This License governs the proprietary WebAssembly runtime (the "Runtime")
+distributed in the @docmentis/udoc-wasm npm package (the "Package"). The
+Package also contains third-party materials that are governed by their own
+licenses, as stated below.
+
+By installing, accessing, using, or redistributing the Runtime after being
+provided these terms, You accept this License. If You act for an organization,
+You represent that You have authority to bind it. If You do not agree, do not
+use or redistribute the Runtime.
+
+1. Definitions
+
+"docMentis" means docMentis LLC.
+
+"Runtime" means the proprietary WebAssembly executable (currently
+udoc_bg.wasm) and related proprietary runtime components supplied by
+docMentis under this License. The compiled WebAssembly includes a third-party
+CMYK ICC profile made available under Creative Commons CC0 1.0, URW++ font
+data licensed under the SIL Open Font License 1.1, Adobe Glyph List data
+licensed under a BSD 3-Clause license, and open-source Rust crates under their
+own licenses. Third-party materials are not proprietary intellectual property
+of docMentis.
+
+"Package" means the distributed @docmentis/udoc-wasm npm package, which
+includes the Runtime and may include additional files. In the currently
+described layout, Liberation, Carlito, and Caladea font files are provided
+separately under dist/fonts/, together with their respective OFL 1.1 license
+files. Those separate font files are not embedded in udoc_bg.wasm.
+
+"Application" means any product, application, library, website, service,
+API, development tool, command-line tool, or other integration that uses the
+Runtime, whether running in a browser, desktop, mobile, server, or automated
+workflow. Applications may be created by docMentis or third parties.
+
+"Permit" means an authorization issued by docMentis's online permit service
+allowing specified free use of the Runtime for a limited duration or scope.
+
+"Commercial License" means a separate agreement or license entitlement
+issued by docMentis that expressly grants additional rights to use the Runtime.
+
+"You" means the individual or legal entity that obtains, uses, or
+redistributes the Runtime.
+
+2. Permission to Use and Integrate
+
+Subject to this License, and to valid authorization under Section 3 or 4
+whenever the Runtime is executed, docMentis grants You a limited, worldwide,
+non-exclusive, non-transferable right to:
+
+(a) download, install, and execute the Runtime in an Application;
+(b) develop and distribute Your own Applications using its documented APIs,
+    including viewers, editors, document processors, server-side services,
+    command-line tools, and agent or automation integrations; and
+(c) make and distribute unmodified copies of the proprietary Runtime as an
+    embedded component of, or genuine dependency for, Your Application,
+    subject to Section 5 and independently applicable third-party licenses.
+
+Both commercial and non-commercial Applications are allowed. You may charge
+for Your own Application or service. You do not receive the Runtime source
+code, ownership rights in the Runtime, or permission to sublicense the
+proprietary Runtime independently of this License. The third-party materials
+remain subject to their own terms and public-domain dedications.
+
+3. Free Use and Online Permits
+
+The Runtime may be used without a commercial license fee only when its required
+valid online Permit has been obtained and verified in accordance with the
+Runtime's authorization mechanism. A Permit may be required for each document,
+operation, session, or other unit of use, as determined by the Runtime and
+permit service. Free use does not confer a right to offline operation.
+
+There is no fixed daily usage cap promised or imposed by this text. docMentis
+may introduce or change prospective free-use limits, permit eligibility,
+permit duration, verification requirements, or issuance policies. Such changes
+apply to subsequent Permit requests or issuances and do not, by themselves,
+retroactively invalidate an already issued Permit before its stated expiry.
+No continuous availability of the permit service or issuance of future free
+Permits is guaranteed.
+
+A valid Permit authorizes use only within its issued scope and lifetime. You
+must not bypass, forge, tamper with, or circumvent Permit checks or usage
+controls.
+
+4. Commercial Licenses
+
+A Commercial License may authorize offline use, operation without online
+Permits, removal of docMentis attribution, disabling of docMentis telemetry,
+or other specifically granted entitlements. Each entitlement is limited to the
+projects, products, domains, environments, dates, uses, and other scope stated
+in the applicable Commercial License. Expiration of a Commercial License may
+prevent continued Runtime operation unless another valid authorization exists.
+
+If an express provision of a Commercial License conflicts with this License,
+that provision governs the uses it specifically covers. This License does
+not automatically extend prior udoc-viewer licenses to additional products,
+projects, or capabilities merely because a newer Runtime can provide them.
+
+5. Redistribution
+
+You may deliver or host unmodified proprietary Runtime binaries as a genuine
+dependency or embedded component of Your Application, including client-side
+WebAssembly delivered to browsers, server deployments, and other installations.
+You may also identify the official npm Package as a dependency. Ordinary
+compression and relocation that preserve the binary contents are permitted.
+The Package's JavaScript files and TypeScript declarations are part of the
+Runtime, and You may bundle, minify, transpile, or otherwise transform them
+with build tools as part of Your Application; Section 6(a) does not restrict
+such transformation.
+
+These permissions relate to docMentis's proprietary rights only. The
+included CC0 color profile, OFL font data, Adobe Glyph List data and
+open-source crates retain their independent third-party status and the
+applicable rights described in Section 12.
+
+When distributing the Runtime, You must:
+
+(a) provide recipients with this License, the third-party notices and terms
+    reproduced in it, and dist/wasm/THIRD-PARTY-NOTICES.txt, or make those
+    terms reasonably accessible to recipients alongside the distributed
+    Runtime;
+(b) preserve proprietary notices and the copyright and license notices
+    required by applicable third-party licenses;
+(c) when separately distributing font files included in dist/fonts/, retain
+    the respective font license files alongside those files and comply with
+    their applicable license terms; and
+(d) make applicable terms reasonably accessible to browser recipients when
+    distributing the Runtime through a web Application.
+
+You may not rebrand, sell, publish, or license the proprietary Runtime as an
+independent competing runtime product. This does not prohibit selling Your
+Application or offering a hosted service that uses the Runtime. Recipients'
+rights to use the proprietary Runtime arise from this License or a valid
+Commercial License, not from a sublicense granted by You.
+
+6. Restrictions
+
+Except as expressly permitted by this License, an applicable Commercial
+License, independent third-party licenses, or applicable law, You must not:
+
+(a) alter, patch, or create a derivative version of the proprietary Runtime;
+(b) reverse engineer, decompile, disassemble, or attempt to obtain its
+    proprietary source code, except to the extent permitted by law;
+(c) circumvent or misrepresent license keys, online Permits, attribution
+    requirements, telemetry restrictions, or other authorization controls;
+(d) remove or falsify proprietary or third-party legal notices; or
+(e) use docMentis trademarks to suggest endorsement without permission.
+
+These restrictions apply to docMentis's proprietary code and do not limit
+independent rights granted under third-party licenses, including the SIL
+Open Font License for URW++ data embedded in the Runtime and for separately
+distributed fonts in dist/fonts/. Separately distributed open-source wrappers
+remain under their respective open-source licenses; their licenses do not
+change the proprietary Runtime's license.
+
+7. Attribution, Telemetry, and Privacy
+
+Where the Runtime or applicable documentation requires docMentis attribution
+or telemetry as a condition of free use, You must comply unless a Commercial
+License expressly provides otherwise. Waiver of docMentis attribution or
+telemetry does not waive any third-party copyright notice or license duty.
+
+Permit checks and telemetry may involve communications with docMentis services.
+Applicable privacy notices, rather than this License, describe associated
+data handling. This License does not authorize access to or collection of
+user document contents.
+
+8. Ownership
+
+The Runtime is licensed, not sold. docMentis retains title and all rights in
+its proprietary software. Third-party owners retain their rights in their
+respective materials. All rights not expressly granted are reserved.
+
+9. Term and Termination
+
+This License continues until terminated. If You materially breach it, and the
+breach is capable of cure, docMentis may terminate Your rights if You fail to
+cure within 15 days after written notice. Intentional circumvention of
+license controls or unauthorized distribution that cannot reasonably be cured
+may result in immediate termination. On termination, stop using and
+redistributing the proprietary Runtime under this License. Rights under
+independent open-source third-party licenses are not terminated by this
+provision. Commercial Licenses are governed by their own term and termination
+clauses.
+
+10. Disclaimer of Warranty
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, DOCMENTIS PROVIDES THE RUNTIME AND
+PERMIT SERVICE "AS IS" AND "AS AVAILABLE", WITHOUT WARRANTIES OF ANY KIND,
+EXPRESS, IMPLIED, OR STATUTORY, INCLUDING MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, AND NON-INFRINGEMENT. DOCMENTIS DOES NOT WARRANT THAT
+THE RUNTIME OR THE PERMIT SERVICE WILL BE ERROR-FREE, UNINTERRUPTED, OR
+CONTINUOUSLY AVAILABLE.
+
+11. Limitation of Liability; Governing Law
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, DOCMENTIS IS NOT LIABLE UNDER THIS
+LICENSE FOR INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR
+PUNITIVE DAMAGES, OR LOST PROFITS, REVENUE, DATA, OR BUSINESS OPPORTUNITIES.
+FOR FREE USE UNDER THIS LICENSE, DOCMENTIS'S TOTAL AGGREGATE LIABILITY IS
+LIMITED TO US$100. LIABILITY UNDER A SEPARATE COMMERCIAL LICENSE IS SUBJECT
+TO THAT AGREEMENT. NOTHING EXCLUDES LIABILITY THAT CANNOT LAWFULLY BE
+EXCLUDED.
+
+This License is governed by the laws of the State of California, USA,
+without regard to conflict-of-law principles. If any provision is held
+unenforceable, the remainder remains in effect to the extent permitted by law.
+A revised license may govern later Runtime versions, but does not
+automatically replace this License for previously distributed versions.
+
+12. Third-Party Materials
+
+This License does not change or replace the separate licenses for materials
+owned by third parties. The compiled Runtime and the separately distributed
+fonts are distinguished below.
+
+12.1 CC0 CMYK ICC color profile (embedded in udoc_bg.wasm)
+
+The Runtime incorporates a CMYK ICC profile from the Compact ICC Profiles
+collection by Clinton Ingram (saucecontrol), currently
+CGATS001Compat-v2-micro.icc. The collection's author has made this profile
+available under the Creative Commons CC0 1.0 Universal public-domain
+dedication, to the extent permitted by applicable law.
+
+Source: https://github.com/saucecontrol/Compact-ICC-Profiles
+CC0 text: https://creativecommons.org/publicdomain/zero/1.0/legalcode
+
+The CC0 profile may be copied, modified, embedded, used, and redistributed,
+including commercially, without a copyright attribution requirement or any
+separate end-user license acceptance required by CC0. This notice identifies
+the provenance of the profile; it is not a restriction or condition on use.
+The CC0 dedication applies to the profile, not to the proprietary Runtime or
+the separately licensed fonts. No endorsement by the profile's creator or by
+Creative Commons is implied.
+
+12.2 URW++ font software (embedded in udoc_bg.wasm)
+
+The compiled Runtime incorporates URW++ font data licensed under the SIL Open
+Font License, Version 1.1 (OFL 1.1). The URW++ copyright notice is reproduced
+in Appendix A and the full OFL 1.1 text is reproduced in Appendix B. These
+fonts remain under the OFL, even when incorporated into proprietary binaries.
+The OFL rights in the font software are independent of this License, including
+rights to use, extract, modify, and redistribute font data subject to the OFL.
+Where modified font data is distributed, the OFL's Reserved Font Name and other
+conditions continue to apply.
+
+12.3 Adobe Glyph List data (embedded in udoc_bg.wasm)
+
+The Runtime incorporates glyph-name-to-Unicode mapping data derived from the
+Adobe Glyph List, the Adobe Glyph List For New Fonts, and the ITC Zapf
+Dingbats Glyph List, published by Adobe under a BSD 3-Clause license. Adobe's
+copyright notice, the license conditions, and the disclaimer are reproduced in
+Appendix C. Those terms govern the glyph list data, not the proprietary
+Runtime.
+
+Source: https://github.com/adobe-type-tools/agl-aglfn
+
+12.4 Open-source Rust crates (compiled into udoc_bg.wasm)
+
+The Runtime is built from Rust source that uses third-party open-source
+crates, each under its own license. Each crate, the license it is used under,
+that license's text with the crate's copyright notices, and where to obtain
+the crate's source code are listed in dist/wasm/THIRD-PARTY-NOTICES.txt, which
+ships beside udoc_bg.wasm. Those licenses govern the respective crates, not
+the proprietary Runtime, and the rights they grant in those crates are
+independent of this License.
+
+12.5 Separately distributed font files (dist/fonts/)
+
+The Package also distributes Liberation, Carlito, and Caladea font files
+separately in dist/fonts/, not embedded in udoc_bg.wasm. These files are
+licensed under OFL 1.1. Their respective complete license files, including
+copyright and Reserved Font Name notices, ship in the same directory:
+LICENSE-Liberation.txt, OFL-Carlito.txt, and OFL-Caladea.txt.
+Those adjacent license files govern the corresponding separate font assets.
+The Appendix A URW++ notice does not purport to cover those separate fonts.
+
+If a later Package version incorporates additional third-party font data or
+other materials, their applicable notices and terms must be provided with that
+version as required by their respective licenses.
+
+13. Contact
+
+For commercial licensing or questions about this License:
+licensing@docmentis.com
+
+==========================================================================
+APPENDIX A - EMBEDDED URW++ FONT COPYRIGHT NOTICE
+==========================================================================
+
+Copyright (c) 2014,2015 by (URW)++ Design & Development
+
+The URW++ font data incorporated in udoc_bg.wasm remains governed by the
+SIL Open Font License, Version 1.1, reproduced in Appendix B.
+
+==========================================================================
+APPENDIX B - SIL OPEN FONT LICENSE VERSION 1.1 (URW++ SOURCE LICENSE)
+==========================================================================
+
+Copyright (c) 2014,2015 by (URW)++ Design & Development
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+==========================================================================
+APPENDIX C - ADOBE GLYPH LIST COPYRIGHT NOTICE AND LICENSE
+==========================================================================
+
+Copyright 2002-2019 Adobe (http://www.adobe.com/).
+
+Redistribution and use in source and binary forms, with or
+without modification, are permitted provided that the
+following conditions are met:
+
+Redistributions of source code must retain the above
+copyright notice, this list of conditions and the following
+disclaimer.
+
+Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following
+disclaimer in the documentation and/or other materials
+provided with the distribution.
+
+Neither the name of Adobe nor the names of its contributors
+may be used to endorse or promote products derived from this
+software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
+CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,3 +1,54 @@
-# Temporary Holding Version
+# @docmentis/udoc-wasm
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**The document engine behind docMentis.**
+
+`@docmentis/udoc-wasm` is a WebAssembly runtime that provides core document processing and rendering capabilities for applications built with docMentis. It is designed for use in document viewers, editors, and automated document workflows.
+
+The runtime is **proprietary software**, distributed under the [docMentis WASM Runtime License](https://cdn.jsdelivr.net/npm/@docmentis/udoc-wasm/LICENSE). It is not an open-source package.
+
+## Capabilities
+
+The runtime supports a range of document formats, including:
+
+- **PDF**
+- **Office documents:** DOCX, PPTX, and XLSX
+- **SVG and common image formats**
+- **Delimited text:** CSV, TSV, and PSV
+
+It provides the underlying document capabilities used by higher-level applications and SDKs. **This package is an engine, not a ready-made viewer or editor.**
+
+## Getting started
+
+For most applications, use a docMentis SDK that provides the user interface or workflow you need. If you are integrating the runtime directly, install it with:
+
+```bash
+npm install @docmentis/udoc-wasm
+```
+
+Visit [docMentis](https://www.docmentis.com/) for product information and integration resources.
+
+## Free use
+
+The runtime can be used **free of charge, including in commercial applications**, with a valid online permit issued by docMentis. An internet connection to the docMentis permit service is required for permit-based use.
+
+Permit requests authorize runtime use; they are **not document uploads or document-conversion requests**. See the [docMentis website](https://www.docmentis.com/) for information about privacy and telemetry.
+
+Free use is subject to the [Runtime License](https://cdn.jsdelivr.net/npm/@docmentis/udoc-wasm/LICENSE).
+
+## Commercial licensing
+
+Commercial licenses are available for deployments that require additional rights, such as offline operation or the removal of supported attribution and telemetry requirements.
+
+Commercial entitlements and their scope are defined by the applicable agreement. For licensing inquiries, contact [licensing@docmentis.com](mailto:licensing@docmentis.com).
+
+## Redistribution and third-party materials
+
+The runtime may be included in applications and redistributed in unmodified form, subject to the [Runtime License](https://cdn.jsdelivr.net/npm/@docmentis/udoc-wasm/LICENSE).
+
+The package contains third-party materials, including open-source dependencies, fonts, and a CC0-licensed ICC color profile. These materials remain subject to their respective licenses. Applicable notices and license information accompany the package and must be preserved as required when redistributing it.
+
+## License
+
+Copyright © 2026 docMentis LLC. All rights reserved.
+
+`@docmentis/udoc-wasm` is licensed under the [docMentis WASM Runtime License](https://cdn.jsdelivr.net/npm/@docmentis/udoc-wasm/LICENSE).

package/dist/error.d.ts

@@ -0,0 +1,16 @@
+import type { CallError, ErrorKind, StartError } from "./wasm/udoc.js";
+/**
+ * What a failure is, for code to branch on: core's kinds, the refusals the
+ * engine adds at its seam, and `crashed` — a trap that took the engine, and the
+ * session with it.
+ */
+export type UDocErrorCode = ErrorKind | StartError["code"] | CallError["code"] | "crashed";
+/** What a refusal carries beside its message: the specifics of its code. */
+export type UDocErrorDetail = StartError["detail"] | CallError["detail"];
+export declare class UDocError extends Error {
+    readonly code: UDocErrorCode;
+    readonly detail?: UDocErrorDetail;
+    constructor(code: UDocErrorCode, message: string, detail?: UDocErrorDetail, options?: ErrorOptions);
+    /** The one classifier: what the engine threw, a trap, or anything else. */
+    static from(thrown: unknown): UDocError;
+}

package/dist/error.js

@@ -0,0 +1,36 @@
+// The one error every udoc package reports. What the engine throws carries its
+// `code` already; `UDocError.from` classifies everything else once — a trap is
+// `crashed`, anything not the engine's own is `internal` — and a worker sends a
+// failure across its thread boundary as `{ code, message, detail }`, which the
+// other side rebuilds into a `UDocError`.
+//
+// Its own module, imported by relative path from the package root and exported
+// on its own as `@docmentis/udoc-wasm/error`: a host's main thread needs the
+// class without the glue, which only the worker running the engine loads.
+export class UDocError extends Error {
+    code;
+    detail;
+    constructor(code, message, detail, options) {
+        super(message, options);
+        this.name = "UDocError";
+        this.code = code;
+        if (detail !== undefined)
+            this.detail = detail;
+    }
+    /** The one classifier: what the engine threw, a trap, or anything else. */
+    static from(thrown) {
+        if (thrown instanceof UDocError)
+            return thrown;
+        if (thrown instanceof WebAssembly.RuntimeError) {
+            return new UDocError("crashed", thrown.message, undefined, { cause: thrown });
+        }
+        if (isEngineError(thrown))
+            return new UDocError(thrown.code, thrown.message, thrown.detail, { cause: thrown });
+        const message = thrown instanceof Error ? thrown.message : String(thrown);
+        return new UDocError("internal", message, undefined, { cause: thrown });
+    }
+}
+/** What the engine throws: an `Error` named `UDocError`, its code on it. */
+function isEngineError(thrown) {
+    return thrown instanceof Error && thrown.name === "UDocError" && typeof Reflect.get(thrown, "code") === "string";
+}

package/dist/font-fulfill.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Filling the engine's font orders — the half of the font system that lives out
+ * here, because fetching does.
+ *
+ * The engine never speaks HTTP. It hands out orders ("this family, these
+ * characters") and installs whatever comes back; choosing *how* to get the bytes
+ * is entirely this file's business. That is what makes the fetches real: they
+ * run concurrently, off the engine, on the host's own network stack — where the
+ * previous design had a synchronous XHR blocking the worker one font at a time.
+ *
+ * For a Google order that means the css2 API: ask for the family at a weight and
+ * style, read the `unicode-range` off each `@font-face` block, and download only
+ * the blocks whose ranges hold the characters actually asked for. The engine
+ * needs to know none of it — which is why the subset list it holds is a
+ * prefilter and not a download plan.
+ *
+ * Every host fills its orders here; only *when* differs. udoc-ui's worker
+ * installs fonts as they land and re-shapes what is on screen; udoc-node's
+ * fills every order before it answers, since a page it exports is final. Its own
+ * module, imported by relative path from the package root and exported on its
+ * own as `@docmentis/udoc-wasm/font-fulfill`: a host's main thread reads
+ * {@link CSS2_ENDPOINT} without the glue, which only the worker running the
+ * engine loads.
+ */
+import type { FontRequest } from "./wasm/udoc.js";
+/** Where css2 lives, unless the host's `googleFontEndpoint` names a mirror. */
+export declare const CSS2_ENDPOINT = "https://fonts.googleapis.com/css2";
+/** One `@font-face` block from a css2 response: where its file is, and what it covers. */
+interface FontFaceBlock {
+    url: string;
+    /** Inclusive codepoint ranges, from `unicode-range`. Empty means "unstated" → always download. */
+    ranges: Array<[number, number]>;
+}
+/**
+ * Parse the `@font-face` blocks out of a css2 response.
+ *
+ * Google's CSS is machine-generated and regular — one block per subset, each with
+ * a single `src: url(...)` and a `unicode-range` — so a scan beats pulling in a
+ * CSS parser. A block without a `unicode-range` keeps an empty range list, which
+ * {@link blockCovers} reads as "covers everything": unstated coverage must never
+ * exclude a block, or a character silently loses its font.
+ */
+export declare function parseFontFaces(css: string): FontFaceBlock[];
+/** The css2 URL for one order — the one place a boolean becomes a weight. */
+export declare function css2Url(request: FontRequest, endpoint?: string): string;
+/** How the fulfiller reaches the network. Injectable so tests stay offline. */
+export type Fetcher = (url: string, init?: RequestInit) => Promise<Response>;
+/**
+ * What a fulfiller carries between orders, and why it has to.
+ *
+ * The engine asks per **character**; Google serves per **file**. Those don't
+ * line up, and the gap costs a download every time: a block's `unicode-range` is
+ * what Google *declares*, not what its cmap holds. Roboto's `symbols` block
+ * claims `U+25A0-27BF` and carries 78 glyphs — no `★`, no `✦` — so a deck using
+ * both stars orders `★`, gets the symbols file, finds nothing, and then orders
+ * `✦`, whose range picks the very same file again. The engine can't prevent it:
+ * `unavailable` is per character on purpose (a vendor missing `✔` very likely has
+ * `é`), and nothing over there knows what a block or a file is.
+ *
+ * So the memory lives here, where URLs exist:
+ *
+ * - `blocks` — parsed css2 responses by URL, so one face is asked for once.
+ * - `delivered` — the woff2 URLs already handed to the engine, per entry. A file
+ *   the engine already installed cannot answer a character it didn't cover, so
+ *   re-fetching it is pure waste. Dropping it is also a *complete* answer: when
+ *   every block covering an order is already installed, `[]` is the truth —
+ *   this vendor has nothing more — and the engine retires those characters and
+ *   walks on to the next vendor without a single request.
+ *
+ * Per entry rather than per URL because that is what "already installed" is
+ * scoped to. Entry ids are minted from a process-global counter and never
+ * reused, so a memory outliving its session can only ever miss.
+ */
+export interface FontFetchMemory {
+    /** Parsed css2 responses, by request URL. */
+    blocks: Map<string, Promise<FontFaceBlock[]>>;
+    /** woff2 URLs already handed to the engine, by the entry they were fetched for. */
+    delivered: Map<number, Set<string>>;
+}
+/** A memory with nothing in it — one per worker that fills orders. */
+export declare function createFontFetchMemory(): FontFetchMemory;
+/**
+ * Fetch the binaries for one order.
+ *
+ * Returns `[]` for "nothing to install" — a family css2 doesn't have, a network
+ * failure, a response with no covering block. That is a **complete answer**, not
+ * an error: the engine records those characters as unavailable from this vendor
+ * and moves to the next one down its chain. Throwing instead would leave the
+ * order open forever.
+ */
+export declare function fetchFontBinaries(request: FontRequest, fetcher?: Fetcher, memory?: FontFetchMemory, endpoint?: string): Promise<Uint8Array[]>;
+export {};