postext 1.23.0 → 1.25.0

package/dist/fonts/fontSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontSet.d.ts","sourceRoot":"","sources":["../../src/fonts/fontSet.ts"],"names":[],"mappings":"AAUA,OAAO,EAA8D,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAmD3G,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,eAAe,GAAG,IAAI,GAAG,SAA4B,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAqBnI;AAED,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;AAIzE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAKzE;AAkBD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,eAAe,GAAG,IAAI,GAAG,SAA4B,GAAG,MAAM,IAAI,CA0CrG;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,OAAO,GAAE,eAAe,GAAG,IAAI,GAAG,SAA4B,GAAG,OAAO,CAEvG"}

package/dist/fonts/fontSet.js

@@ -0,0 +1,173 @@
+// Faces that arrive after text was measured (#629). The engine keeps, per
+// font set, which faces of each family were loaded when it last looked;
+// a build looks again at its start (cheaply: only when the set grew or
+// shrank, or a face finished loading), and drops the widths of the
+// families whose faces changed, so nothing measured with a fallback face
+// outlives the face's arrival. `watchFonts` does the same as faces load,
+// once per animation frame, and tells hosts (`onFontsChanged`) to lay out
+// again.
+import { evictFontFamilies } from '../measure/font';
+import { defaultFontSet, forgetInstalledFamilies } from './faces';
+const tracked = new WeakMap();
+function unquote(family) {
+    const f = family.trim();
+    return /^(["']).*\1$/.test(f) ? f.slice(1, -1) : f;
+}
+/** The loaded faces of every family of `fontSet`. */
+function signatureOf(fontSet) {
+    const parts = new Map();
+    for (const face of fontSet) {
+        if (face.status !== 'loaded')
+            continue;
+        const family = unquote(face.family).toLowerCase();
+        let list = parts.get(family);
+        if (!list)
+            parts.set(family, (list = []));
+        list.push(`${face.weight}/${face.style}/${face.unicodeRange ?? ''}`);
+    }
+    const out = new Map();
+    for (const [family, list] of parts)
+        out.set(family, list.sort().join(';'));
+    return out;
+}
+function track(fontSet) {
+    let t = tracked.get(fontSet);
+    if (t)
+        return t;
+    const entry = {
+        size: fontSet.size ?? -1,
+        signature: signatureOf(fontSet),
+        dirty: false,
+        onLoadingDone: () => {
+            entry.dirty = true;
+        },
+    };
+    fontSet.addEventListener?.('loadingdone', entry.onLoadingDone);
+    tracked.set(fontSet, entry);
+    t = entry;
+    return t;
+}
+/** Whether the engine has looked at `fontSet` before. */
+export function isFontSetTracked(fontSet) {
+    return tracked.has(fontSet);
+}
+/**
+ * Look at `fontSet` again: the families whose loaded faces changed since
+ * the last look get their measurements dropped (`evictFontFamilies`) and
+ * are returned. The first look only records the set. Cheap when nothing
+ * happened: the set is walked only when its size changed or a face
+ * finished loading. `evict: false` records the set without dropping
+ * anything (the caller drops what it knows changed).
+ */
+export function syncFontSet(fontSet = defaultFontSet(), options) {
+    if (!fontSet)
+        return [];
+    if (!tracked.has(fontSet)) {
+        track(fontSet);
+        return [];
+    }
+    const t = track(fontSet);
+    const size = fontSet.size ?? -1;
+    if (!t.dirty && size === t.size && size !== -1)
+        return [];
+    const signature = signatureOf(fontSet);
+    const changed = [];
+    for (const [family, sig] of signature)
+        if (t.signature.get(family) !== sig)
+            changed.push(family);
+    for (const family of t.signature.keys())
+        if (!signature.has(family))
+            changed.push(family);
+    t.signature = signature;
+    t.size = size;
+    t.dirty = false;
+    if (changed.length > 0) {
+        forgetInstalledFamilies();
+        if (options?.evict !== false)
+            evictFontFamilies(changed);
+    }
+    return changed;
+}
+const listeners = new Set();
+/**
+ * Call `listener` whenever faces of a watched font set arrive or leave
+ * (see {@link watchFonts}), after the engine has dropped what it measured
+ * in their families: the host lays out again. Returns the unsubscribe.
+ */
+export function onFontsChanged(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+const watches = new WeakMap();
+function nextFrame(run) {
+    const g = globalThis;
+    // A hidden page runs no animation frames: a timer stands in.
+    if (typeof g.requestAnimationFrame === 'function' && !g.document?.hidden)
+        g.requestAnimationFrame(run);
+    else
+        setTimeout(run, 16);
+}
+/**
+ * Watch `fontSet` (by default `document.fonts`, or `self.fonts` in a
+ * worker): when faces finish loading, the measurements of their families
+ * are dropped — at most once per animation frame, however many slices a
+ * burst brings — and the {@link onFontsChanged} listeners are told.
+ * Calls nest; the returned function stops this watch. `prepareFonts`
+ * starts one on the set it loads into.
+ */
+export function watchFonts(fontSet = defaultFontSet()) {
+    if (!fontSet || !fontSet.addEventListener)
+        return () => { };
+    const set = fontSet;
+    track(set);
+    let w = watches.get(set);
+    if (!w) {
+        const watch = {
+            count: 0,
+            pending: new Set(),
+            scheduled: false,
+            listener: (event) => {
+                for (const face of event.fontfaces ?? [])
+                    watch.pending.add(unquote(face.family).toLowerCase());
+                if (watch.scheduled)
+                    return;
+                watch.scheduled = true;
+                nextFrame(() => {
+                    watch.scheduled = false;
+                    const changed = syncFontSet(set);
+                    // A build between the event and this frame may have dropped
+                    // them already: the faces still arrived.
+                    const families = [...new Set([...changed, ...watch.pending])];
+                    watch.pending.clear();
+                    if (families.length === 0)
+                        return;
+                    for (const l of [...listeners])
+                        l(families);
+                });
+            },
+        };
+        set.addEventListener('loadingdone', watch.listener);
+        watches.set(set, watch);
+        w = watch;
+    }
+    w.count++;
+    let stopped = false;
+    const current = w;
+    return () => {
+        if (stopped)
+            return;
+        stopped = true;
+        current.count--;
+        if (current.count === 0) {
+            set.removeEventListener?.('loadingdone', current.listener);
+            watches.delete(set);
+        }
+    };
+}
+/** Whether `fontSet` is watched. */
+export function isWatchingFonts(fontSet = defaultFontSet()) {
+    return !!fontSet && watches.has(fontSet);
+}
+//# sourceMappingURL=fontSet.js.map

package/dist/fonts/fontSet.js.map

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

package/dist/fonts/prepare.d.ts

@@ -0,0 +1,120 @@
+import type { PostextConfig, PostextContent } from '../types';
+import type { VDTDocument } from '../vdt';
+import { type FontContentText } from './usage';
+import { type FontFaceLike, type FontFaceRequest, type FontFaceSetLike, type FontFallbackOptions } from './faces';
+/** A font file: its bytes, or the URL to fetch it from (a CSS `src`
+ *  value — `url(…)`, `local(…)` — is taken as written). */
+export type FontFileSource = ArrayBuffer | ArrayBufferView | string;
+/** A font file with the descriptors of its face, when they are not the
+ *  ones asked for: the slice a file covers (`unicodeRange`), a variable
+ *  weight range (`'100 900'`), an upright file given for an italic. */
+export interface FontFile {
+    source: FontFileSource;
+    unicodeRange?: string;
+    weight?: number | string;
+    style?: 'normal' | 'italic' | string;
+}
+/** What a resolver answers: one file, several (the slices of a face, in
+ *  the order they are added to the font set), or nothing (it has no such
+ *  face). Throwing counts as nothing. */
+export type FontResolverAnswer = FontFileSource | FontFile | readonly (FontFileSource | FontFile)[] | null | undefined;
+export interface FontResolveRequest {
+    /** The characters the document sets (a space included), for a resolver
+     *  serving a family as slices: only the files holding them. */
+    text: string;
+    codePoints: Set<number>;
+}
+/**
+ * A host's font files, asked for each face no `FontFace` of the font set
+ * declares: `(family, weight, style, { text, codePoints })`. The shape of
+ * postext-pdf's `PdfFontProvider`, so one function serves the screen and
+ * the PDF. A resolver may also declare the face itself (add a style sheet,
+ * a `FontFace`) and answer null: the engine then loads what it declared.
+ */
+export type FontResolver = (family: string, weight: number, style: 'normal' | 'italic', request: FontResolveRequest) => FontResolverAnswer | Promise<FontResolverAnswer>;
+type FontFaceConstructor = new (family: string, source: string | ArrayBuffer | ArrayBufferView, descriptors?: FontFaceDescriptors) => FontFaceLike;
+export interface PrepareFontsOptions {
+    /** The font set to load into: by default `document.fonts`, or
+     *  `self.fonts` in a worker. */
+    fontSet?: FontFaceSetLike | null;
+    /** Files for the faces nothing declares. */
+    resolve?: FontResolver;
+    /** Give up waiting after this many ms (default 10 000): a face still
+     *  loading then is reported missing. */
+    timeoutMs?: number;
+    /** Watch the font set afterwards ({@link watchFonts}). Default true. */
+    watch?: boolean;
+    /** Register the resolved files with the font registry, for SVG
+     *  pictures and layout workers. Default true. */
+    register?: boolean;
+    /** Faces to load beyond the configuration's. */
+    faces?: readonly FontFaceRequest[];
+    /** The `FontFace` constructor (default the global one). */
+    FontFace?: FontFaceConstructor;
+    /** The probe that tells an installed family from a missing one. */
+    measureWidth?: FontFallbackOptions['measureWidth'];
+}
+/** What a preparation found. */
+export interface FontReport {
+    /** Faces a loaded face answers for (or an installed family). */
+    loaded: FontFaceRequest[];
+    /** Faces no face of the family answers for: their text is measured
+     *  with a fallback face. */
+    missing: FontFaceRequest[];
+    /** Faces the browser draws from another weight or slant of the family
+     *  (bold made heavier, italic slanted). */
+    synthesized: FontFaceRequest[];
+    /** `FontFace`s added from the resolver's files. */
+    added: number;
+}
+/** The texts of a build's content: the Markdown, the metadata and the
+ *  resources' captions, notes and cells. */
+export declare function contentTexts(content: PostextContent | FontContentText): string[];
+/**
+ * The characters a document sets — its text, its resources' and
+ * metadata's, the configuration's own texts, the ASCII digits and letters
+ * of folios and labels — once each: the sample a face is loaded for, so a
+ * family served as slices (`unicode-range`: Latin Extended, Greek, Arabic,
+ * the CJK slices) brings the files the document needs.
+ */
+export declare function fontSampleText(content: PostextContent | FontContentText, config?: PostextConfig): string;
+/** The faces a configuration and its text ask for, in a fixed order:
+ *  families as `configFontFamilies` lists them, then the weights from light
+ *  to heavy, upright before italic. */
+export declare function configFontFaces(config: PostextConfig | undefined, text?: FontContentText): FontFaceRequest[];
+/**
+ * Load every face `config` and its text ask for (body, headings, lists,
+ * callout titles and bodies, tables, design texts, running heads,
+ * contents, code, comic lettering, in each weight and slant the
+ * configuration sets) into the font set, for the characters the document
+ * sets, before the first build. A face the set declares is loaded through
+ * it (`fontSet.load`); one it does not is asked of `options.resolve`, and
+ * the files it gives are added as `FontFace`s (and registered for SVG
+ * pictures). The measurements of the families that changed are dropped.
+ * Resolves with which faces are there, which are missing and which the
+ * browser would synthesize. Where there is no font set (Node), every face
+ * is reported loaded and nothing is done.
+ */
+export declare function prepareFonts(content: PostextContent | FontContentText, config?: PostextConfig, options?: PrepareFontsOptions): Promise<FontReport>;
+/** A document, or several (the chapters of a book). */
+export type BuiltDocuments = VDTDocument | readonly VDTDocument[];
+export interface LoadedFontsOptions extends PrepareFontsOptions {
+    /** The text the documents set, for the sample faces are loaded for.
+     *  Default: the text of the documents' lines. */
+    text?: FontContentText;
+    /** Extra builds at most (default 2). */
+    maxRounds?: number;
+    /** Told what the last round found. */
+    onFonts?: (report: FontReport) => void;
+}
+/**
+ * Run `build`, then load the faces its pages set text in that the font set
+ * could not give (a weight the configuration did not name, a face
+ * resolved only now), drop their measurements and build again — at most
+ * `maxRounds` extra builds (2). `build` returns a document or several.
+ * Faces that stay missing are reported (`onFonts`) and listed by each
+ * document's `fontFallback` warnings.
+ */
+export declare function withLoadedFonts<T extends BuiltDocuments>(build: () => T | Promise<T>, options?: LoadedFontsOptions): Promise<T>;
+export {};
+//# sourceMappingURL=prepare.d.ts.map

package/dist/fonts/prepare.d.ts.map

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