@docmentis/udoc-wasm 0.0.0-stage → 0.8.1

package/dist/font-fulfill.js

@@ -0,0 +1,203 @@
+/**
+ * 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.
+ */
+/** Where css2 lives, unless the host's `googleFontEndpoint` names a mirror. */
+export const CSS2_ENDPOINT = "https://fonts.googleapis.com/css2";
+/**
+ * A user agent string that makes Google serve **woff2**, the format the engine
+ * parses. Google content-negotiates on `User-Agent`. A browser's `fetch` sends
+ * the browser's own, and modern browsers all get woff2; Node's sends `node`,
+ * which this replaces.
+ */
+const WOFF2_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120 Safari/537.36";
+/**
+ * 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 function parseFontFaces(css) {
+    const blocks = [];
+    for (const match of css.matchAll(/@font-face\s*\{([^}]*)\}/g)) {
+        const body = match[1] ?? "";
+        const url = /url\(\s*(['"]?)([^'")]+)\1\s*\)/.exec(body)?.[2];
+        if (!url)
+            continue;
+        blocks.push({ url, ranges: parseUnicodeRange(body) });
+    }
+    return blocks;
+}
+/** The inclusive codepoint ranges of a block's `unicode-range`, or `[]` if it has none. */
+function parseUnicodeRange(body) {
+    const declaration = /unicode-range\s*:\s*([^;}]*)/.exec(body)?.[1];
+    if (!declaration)
+        return [];
+    const ranges = [];
+    for (const token of declaration.split(",")) {
+        const text = token.trim();
+        // `U+0-7F`, `U+A0`, or the wildcard form `U+30??`.
+        const match = /^u\+([0-9a-f?]{1,6})(?:-([0-9a-f]{1,6}))?$/i.exec(text);
+        if (!match)
+            continue;
+        const [, low, high] = match;
+        if (low === undefined)
+            continue;
+        if (low.includes("?")) {
+            ranges.push([
+                Number.parseInt(low.replaceAll("?", "0"), 16),
+                Number.parseInt(low.replaceAll("?", "F"), 16),
+            ]);
+        }
+        else {
+            const start = Number.parseInt(low, 16);
+            ranges.push([start, high === undefined ? start : Number.parseInt(high, 16)]);
+        }
+    }
+    return ranges;
+}
+/** Whether a block is worth downloading for `characters`. */
+function blockCovers(block, characters) {
+    // Unstated coverage: download it rather than risk excluding the only font
+    // that has the character.
+    if (block.ranges.length === 0)
+        return true;
+    for (const ch of characters) {
+        const code = ch.codePointAt(0);
+        if (code === undefined)
+            continue;
+        if (block.ranges.some(([low, high]) => code >= low && code <= high))
+            return true;
+    }
+    return false;
+}
+/** The css2 URL for one order — the one place a boolean becomes a weight. */
+export function css2Url(request, endpoint = CSS2_ENDPOINT) {
+    const { family, bold, italic } = request.descriptor;
+    const weight = bold ? 700 : 400;
+    const axes = italic ? `ital,wght@1,${weight}` : `wght@${weight}`;
+    // `display=block` keeps Google from serving a swap-oriented subset set; the
+    // engine does its own stand-in rendering.
+    return `${endpoint}?family=${encodeURIComponent(family)}:${axes}&display=block`;
+}
+/** A memory with nothing in it — one per worker that fills orders. */
+export function createFontFetchMemory() {
+    return { blocks: new Map(), delivered: new Map() };
+}
+/**
+ * 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 async function fetchFontBinaries(request, fetcher = fetch, memory = createFontFetchMemory(), endpoint = CSS2_ENDPOINT) {
+    try {
+        const urls = typeof request.fetch === "object"
+            ? [request.fetch.url.url]
+            : await googleSubsetUrls(request, fetcher, memory, endpoint);
+        let delivered = memory.delivered.get(request.entry);
+        if (!delivered) {
+            delivered = new Set();
+            memory.delivered.set(request.entry, delivered);
+        }
+        const fetched = await Promise.all(urls
+            .filter((url) => !delivered.has(url))
+            .map(async (url) => {
+            try {
+                const response = await fetcher(url);
+                if (!response.ok)
+                    return null;
+                return { url, bytes: new Uint8Array(await response.arrayBuffer()) };
+            }
+            catch {
+                // This block is unreachable; the others still install.
+                return null;
+            }
+        }));
+        const binaries = [];
+        for (const got of fetched) {
+            // A block that 404s drops out; the rest still install.
+            if (!got)
+                continue;
+            // Remembered only once it is genuinely in hand. Claiming it earlier
+            // would close the narrow window where two callers (udoc-ui's
+            // `ensureFont` and its pump) fetch one font at the same time — but
+            // at the price that a failure inside that window would report the
+            // characters unavailable for a file nothing ever installed, and
+            // `unavailable` is permanent. A duplicate download is the cheaper
+            // wrong answer.
+            delivered.add(got.url);
+            binaries.push(got.bytes);
+        }
+        return binaries;
+    }
+    catch {
+        // Offline, CORS, a malformed response — all the same fact to the engine.
+        return [];
+    }
+}
+/** The woff2 URLs a Google order needs: the blocks whose ranges hold its characters. */
+async function googleSubsetUrls(request, fetcher, memory, endpoint) {
+    const blocks = await css2Blocks(css2Url(request, endpoint), fetcher, memory);
+    const covering = blocks.filter((block) => blockCovers(block, request.characters));
+    // One order can span scripts on purpose (`"éΩ"` wants latin-ext *and*
+    // greek), so this is every covering block, not the first.
+    return covering.map((block) => block.url);
+}
+/**
+ * The `@font-face` blocks a css2 URL answers with, asked for once per face.
+ *
+ * The response doesn't depend on the characters — it lists every subset — so a
+ * second order for the same face would fetch a document we have already read.
+ * A *failed* read is not remembered: a family unreachable once must not be
+ * unreachable for the rest of the session.
+ */
+function css2Blocks(url, fetcher, memory) {
+    const remembered = memory.blocks.get(url);
+    if (remembered)
+        return remembered;
+    const blocks = (async () => {
+        const response = await fetcher(url, {
+            headers: { Accept: "text/css,*/*;q=0.1", "User-Agent": WOFF2_UA },
+        });
+        if (!response.ok)
+            return [];
+        // A `url()` is relative to the stylesheet, as in any CSS — after
+        // redirects. Google's are absolute; a mirror's may not be, and a
+        // relative URL would otherwise resolve against the worker's `blob:`.
+        const base = response.url || url;
+        return parseFontFaces(await response.text()).map((block) => ({
+            ...block,
+            url: new URL(block.url, base).href,
+        }));
+    })();
+    memory.blocks.set(url, blocks);
+    blocks.catch(() => memory.blocks.delete(url));
+    return blocks;
+}

package/dist/fonts/LICENSE-Liberation.txt

@@ -0,0 +1,102 @@
+Digitized data copyright (c) 2010 Google Corporation
+	with Reserved Font Arimo, Tinos and Cousine.
+Copyright (c) 2012 Red Hat, Inc.
+	with Reserved Font Name Liberation.
+
+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.
+

package/dist/fonts/OFL-Caladea.txt

@@ -0,0 +1,93 @@
+Copyright 2012 The Caladea Project Authors (https://github.com/huertatipografica/Caladea)
+
+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.

package/dist/fonts/OFL-Carlito.txt

@@ -0,0 +1,94 @@
+Copyright 2013 The Carlito Project Authors (https://github.com/googlefonts/carlito), with Reserved Font Name "Carlito"
+
+
+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:
+https://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.

package/dist/google-font-catalog.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The Google font catalog this package ships — which families exist, which
+ * faces each serves, and which subsets it declares. `startSession` registers it
+ * on every session it starts, unless its caller passes a list of its own.
+ *
+ * **Generated. Do not edit by hand.** Refresh with `npm run gen:google-font-catalog`
+ * (see `scripts/gen-google-font-catalog.mjs`), which reads Google Fonts' public
+ * family metadata and rewrites this file.
+ *
+ * The catalog is *host* data, not engine data: the engine never speaks the
+ * Google protocol, so the list of what Google offers is JS beside the glue, and
+ * refreshing it is not a Rust release. A host narrows it, extends it, or drops
+ * it entirely — an empty catalog simply means no Google fonts. `subsets` feeds
+ * only the engine's script prefilter (it decides whether asking this family for
+ * this character is worth a round trip); what actually gets downloaded is chosen
+ * from the live `unicode-range`s in the css2 response.
+ *
+ * Generated from https://fonts.google.com/metadata/fonts on 2026-10-19: 1839 families.
+ */
+import type { GoogleFontFamily } from "./wasm/udoc.js";
+export declare const GOOGLE_FONT_CATALOG: readonly GoogleFontFamily[];