fleuron 0.1.0

package/dist/protocol.js

@@ -0,0 +1,19 @@
+/**
+ * What crosses between a host and the worker the engine runs in.
+ *
+ * A request is an edit plus, sometimes, a render: inputs travel when
+ * they change rather than once per frame, and the module keeps every
+ * stage between them. Each request carries a generation, which the
+ * worker echoes back untouched. The host raises it whenever the
+ * input goes stale, and a reply that comes back behind the current
+ * one is dropped rather than painted.
+ */
+/** Whether a reply carries bytes. */
+export function isRendered(response) {
+    return 'bytes' in response;
+}
+/** Whether a reply is the engine reporting trouble. */
+export function isFailed(response) {
+    return 'error' in response;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkHH,qCAAqC;AACrC,MAAM,UAAU,UAAU,CAAC,QAAkB;IAC3C,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,QAAQ,CAAC,QAAkB;IACzC,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC"}

package/dist/svg.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The preview painter: one page of the display structure, as SVG.
+ *
+ * The engine has already shaped and broken the text, so the browser
+ * is given no room to do either. Every run is one `<text>` carrying
+ * an x for each character it holds, taken from the glyph the shaper
+ * put there, and the face is the file the engine shaped with, pinned
+ * to the instance it shaped at. A preview that disagrees with the
+ * export about where a glyph sits therefore has a bug here, and
+ * nowhere else.
+ *
+ * The coordinate system is the display structure's: points, origin top
+ * left, on a `viewBox` the size of the trim. Zoom is the width and
+ * height the element is given, and moves nothing inside it.
+ */
+import type { Asset, FontRefEntry, Page } from './wire.js';
+/** How a page is painted. */
+export interface PaintOptions {
+    /** The run's font table: `LayoutOutput.fonts`. */
+    fonts?: FontRefEntry[];
+    /** The run's asset table: `LayoutOutput.assets`. */
+    assets?: Asset[];
+    /** Points to CSS pixels. 1 draws the page at its trim size. */
+    zoom?: number;
+    /** What the page is printed on; `null` leaves it transparent. */
+    paper?: string | null;
+    /** What it is printed in. */
+    ink?: string;
+    /**
+     * Where an image's pixels come from: any url an `<img>` would
+     * take, including a `blob:` or `data:` one, or nothing when the
+     * host cannot supply them.
+     *
+     * Called with the asset the display structure placed, so a host keyed
+     * on urls needs no index of its own. It is only ever called when
+     * {@link PaintOptions.assets} is given, since the index means
+     * nothing without the table it indexes.
+     */
+    asset?: (asset: Asset, index: number) => string | null | undefined;
+}
+/**
+ * What a face is registered as, so a painter and whoever loaded the
+ * bytes agree on the name.
+ *
+ * Per id rather than per family: a variable file names several cuts,
+ * and each is drawn at its own place on the axes.
+ */
+export declare function faceFamily(fontId: number): string;
+/**
+ * Paints one page, as an `<svg>` element's markup.
+ *
+ * A face that is not loaded falls through the stack to whatever the
+ * browser has, so a page whose fonts never arrived is set in the
+ * wrong face rather than left blank.
+ */
+export declare function paintPage(page: Page, options?: PaintOptions): string;
+//# sourceMappingURL=svg.d.ts.map

package/dist/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../src/svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAY,YAAY,EAAa,IAAI,EAAsB,MAAM,WAAW,CAAC;AAEpG,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,oDAAoD;IACpD,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACpE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAgBxE"}

package/dist/svg.js

@@ -0,0 +1,210 @@
+/**
+ * The preview painter: one page of the display structure, as SVG.
+ *
+ * The engine has already shaped and broken the text, so the browser
+ * is given no room to do either. Every run is one `<text>` carrying
+ * an x for each character it holds, taken from the glyph the shaper
+ * put there, and the face is the file the engine shaped with, pinned
+ * to the instance it shaped at. A preview that disagrees with the
+ * export about where a glyph sits therefore has a bug here, and
+ * nowhere else.
+ *
+ * The coordinate system is the display structure's: points, origin top
+ * left, on a `viewBox` the size of the trim. Zoom is the width and
+ * height the element is given, and moves nothing inside it.
+ */
+/**
+ * What a face is registered as, so a painter and whoever loaded the
+ * bytes agree on the name.
+ *
+ * Per id rather than per family: a variable file names several cuts,
+ * and each is drawn at its own place on the axes.
+ */
+export function faceFamily(fontId) {
+    return `fleuron-face-${fontId}`;
+}
+/**
+ * Paints one page, as an `<svg>` element's markup.
+ *
+ * A face that is not loaded falls through the stack to whatever the
+ * browser has, so a page whose fonts never arrived is set in the
+ * wrong face rather than left blank.
+ */
+export function paintPage(page, options = {}) {
+    const zoom = options.zoom ?? 1;
+    const paper = options.paper === undefined ? '#ffffff' : options.paper;
+    const body = page.items.map((item) => paint(item, options)).join('');
+    const ground = paper === null
+        ? ''
+        : `<rect x="0" y="0" width="${num(page.width)}" height="${num(page.height)}" fill="${escape(paper)}"/>`;
+    return (`<svg xmlns="http://www.w3.org/2000/svg"` +
+        ` viewBox="0 0 ${num(page.width)} ${num(page.height)}"` +
+        ` width="${num(page.width * zoom)}" height="${num(page.height * zoom)}"` +
+        ` fill="${escape(options.ink ?? '#000000')}"` +
+        ` data-page="${page.number}" data-side="${page.side}">` +
+        `${ground}${body}</svg>`);
+}
+function paint(item, options) {
+    switch (item.kind) {
+        case 'text':
+            return text(item, options);
+        case 'rect':
+            return rect(item);
+        case 'image':
+            return image(item, options);
+    }
+}
+function text(item, options) {
+    const entry = options.fonts?.[item.fontId];
+    const xs = positions(item);
+    // Slope and weight are the face's own rather than the container's.
+    // A host element that happens to be bold would otherwise have the
+    // browser synthesise a second bold over a face that is already
+    // one, and a face that did not arrive would fall back upright.
+    return (`<text x="${xs.map(num).join(' ')}" y="${num(item.y)}"` +
+        ` font-family="${escape(stack(item.fontId, entry))}"` +
+        ` font-size="${num(item.size)}"` +
+        ` font-weight="${entry?.attributes.weight ?? 400}"` +
+        ` font-style="${entry?.attributes.italic === true ? 'italic' : 'normal'}"` +
+        ` style="${escape(style(entry))}" xml:space="preserve"` +
+        (entry === undefined ? ` data-missing-font="${item.fontId}"` : '') +
+        `>${escape(item.text)}</text>`);
+}
+function rect(item) {
+    return `<rect x="${num(item.x)}" y="${num(item.y)}" width="${num(item.w)}" height="${num(item.h)}"/>`;
+}
+/**
+ * A placed image. The pixels are the host's, and one it cannot
+ * supply is drawn as the box layout reserved for it rather than as
+ * nothing.
+ */
+function image(item, options) {
+    const box = `x="${num(item.x)}" y="${num(item.y)}"` +
+        ` width="${num(item.w)}" height="${num(item.h)}"`;
+    const asset = options.assets?.[item.asset];
+    const href = asset === undefined ? undefined : options.asset?.(asset, item.asset);
+    return href === null || href === undefined
+        ? `<rect ${box} fill="none" stroke="currentColor" stroke-dasharray="3 3" data-missing-asset="${item.asset}"/>`
+        : `<image ${box} href="${escape(href)}" preserveAspectRatio="none"/>`;
+}
+/**
+ * The families a run is drawn in, best first: the file the engine
+ * shaped with, then whatever the reader has under the same name,
+ * then a generic.
+ */
+function stack(fontId, entry) {
+    const names = [faceFamily(fontId), ...(entry === undefined ? [] : [entry.family])];
+    return [...names.map((name) => `"${name.replace(/["\\]/g, '')}"`), 'serif'].join(', ');
+}
+/**
+ * Where on its axes the face is drawn. A cut the file named is a
+ * location on that file, not a file of its own, so a painter that
+ * does not pin it draws the default weight for every one of them.
+ */
+function style(entry) {
+    const settings = (entry?.variations ?? [])
+        .map((axis) => `"${axis.tag}" ${num(axis.value)}`)
+        .join(', ');
+    // Runs carry the spaces the line was justified around, and SVG
+    // collapses them by default, which would slide every character
+    // after the first space one position along the x list.
+    return `white-space: pre` + (settings === '' ? '' : `; font-variation-settings: ${settings}`);
+}
+/**
+ * An x for each character of a run, from the glyph the shaper placed
+ * there.
+ *
+ * SVG positions characters, and the display structure positions glyphs,
+ * so the run's text is the join between them: each glyph carries the
+ * byte range it stands for, and its x lands on the character that
+ * range starts at. A character inside a ligature's range has no
+ * glyph of its own and is spaced evenly across it, which is what the
+ * browser does with it in the one case it matters: when the face that
+ * arrived forms no ligature and draws the characters separately.
+ */
+function positions(item) {
+    const starts = characters(item.text);
+    const index = new Map(starts.map((byte, at) => [byte, at]));
+    const xs = new Array(starts.length);
+    for (const glyph of item.glyphs) {
+        const at = index.get(glyph.range[0]);
+        if (at === undefined) {
+            continue;
+        }
+        const held = xs[at];
+        if (held === undefined || glyph.x < held) {
+            xs[at] = glyph.x;
+        }
+    }
+    return fill(xs, item.x);
+}
+/** The byte offset each character of a string begins at. */
+function characters(text) {
+    const starts = [];
+    let byte = 0;
+    for (const character of text) {
+        starts.push(byte);
+        const code = character.codePointAt(0) ?? 0;
+        byte += code < 0x80 ? 1 : code < 0x800 ? 2 : code < 0x10000 ? 3 : 4;
+    }
+    return starts;
+}
+/**
+ * Closes the gaps a glyph-to-character mapping leaves: interior ones
+ * are spaced evenly, and a run of them at the end is dropped, since
+ * an x list may be shorter than the text and the browser advances
+ * the rest itself.
+ */
+function fill(xs, left) {
+    // Where the next placed character is, read off in one pass
+    // backwards, so a long gap costs no more than a short one.
+    const ahead = new Array(xs.length);
+    let next = -1;
+    let last = -1;
+    for (let at = xs.length - 1; at >= 0; at -= 1) {
+        ahead[at] = next;
+        if (xs[at] !== undefined) {
+            next = at;
+            if (last === -1) {
+                last = at;
+            }
+        }
+    }
+    if (last === -1) {
+        return [left];
+    }
+    const out = [];
+    let held = left;
+    for (let at = 0; at <= last; at += 1) {
+        const x = xs[at];
+        const to = ahead[at] ?? -1;
+        held = x ?? held + ((xs[to] ?? held) - held) / (to - at + 1);
+        out.push(held);
+    }
+    return out;
+}
+/**
+ * The shortest decimal that reads back as the same 32-bit float.
+ *
+ * The display structure is `f32`, and printing one as the double it
+ * widened to writes seventeen digits of a number that only has
+ * seven. Both are the same position; only one of them is worth
+ * sending a page's worth of.
+ */
+function num(value) {
+    for (let digits = 0; digits <= 8; digits += 1) {
+        const text = value.toFixed(digits);
+        if (Math.fround(Number(text)) === Math.fround(value)) {
+            return digits === 0 ? text : text.replace(/\.?0+$/, '');
+        }
+    }
+    return String(value);
+}
+function escape(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+//# sourceMappingURL=svg.js.map

package/dist/svg.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * What this package is, so a bug report names the build without
+ * anyone opening `node_modules`. It is the version of the engine the
+ * module was built from as well: the workspace and both packages
+ * release together.
+ */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,8 @@
+/**
+ * What this package is, so a bug report names the build without
+ * anyone opening `node_modules`. It is the version of the engine the
+ * module was built from as well: the workspace and both packages
+ * release together.
+ */
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/wire.d.ts

@@ -0,0 +1,179 @@
+/**
+ * The wire: postcard bytes in, a display structure out.
+ *
+ * The engine encodes with postcard, which sends no field names and
+ * packs small numbers into one byte. Nothing in the buffer says what
+ * it is, so this reader walks the same fields in the same order the
+ * engine wrote them, and the version in front of the bytes is what
+ * catches the day those two stop agreeing.
+ */
+/** The encoding this reader understands. */
+export declare const WIRE_VERSION = 4;
+/** Which side of the spread a page falls on. */
+export type Side = 'recto' | 'verso';
+/** One glyph: an id in its font, an absolute x, and the text it stands for. */
+export interface Glyph {
+    /** Glyph id in the run's font. */
+    id: number;
+    /** Absolute x of the glyph's origin, in points. */
+    x: number;
+    /** Byte range in the run's text this glyph came from. */
+    range: [number, number];
+}
+/** A run of shaped glyphs sharing a font, a size and a baseline. */
+export interface TextItem {
+    kind: 'text';
+    /** Left edge of the run. */
+    x: number;
+    /** The run's baseline. */
+    y: number;
+    /** Index into {@link LayoutOutput.fonts}. */
+    fontId: number;
+    /** Em size in points. */
+    size: number;
+    /**
+     * The text the glyphs were shaped from. Only the shaper knew which
+     * glyph came from which character, so the correspondence travels
+     * with them: selection, copy-and-paste and accessible text read it
+     * through each glyph's range.
+     */
+    text: string;
+    /** The glyphs, in visual order. */
+    glyphs: Glyph[];
+}
+/** A filled rectangle: rules, borders, backgrounds. */
+export interface RectItem {
+    kind: 'rect';
+    /** Left edge. */
+    x: number;
+    /** Top edge. */
+    y: number;
+    /** Width in points. */
+    w: number;
+    /** Height in points. */
+    h: number;
+}
+/** An image's own idea of its size, from its header. */
+export interface Intrinsic {
+    /** Width in pixels. */
+    width: number;
+    /** Height in pixels. */
+    height: number;
+    /** Horizontal resolution in pixels per inch. */
+    dpiX: number;
+    /** Vertical resolution in pixels per inch. */
+    dpiY: number;
+}
+/**
+ * One image the book placed, as {@link ImageItem.asset} indexes it.
+ *
+ * All the display structure says about an image: layout read the header
+ * and decoded nothing, so a painter takes the url back to its own
+ * pixels.
+ */
+export interface Asset {
+    /** The url the content tree named it by. */
+    url: string;
+    /** What the header says it is. */
+    intrinsic: Intrinsic;
+}
+/** A placed image. Layout never decoded it; the painter does. */
+export interface ImageItem {
+    kind: 'image';
+    /** Left edge. */
+    x: number;
+    /** Top edge. */
+    y: number;
+    /** Width in points. */
+    w: number;
+    /** Height in points. */
+    h: number;
+    /** Index into {@link LayoutOutput.assets}. */
+    asset: number;
+}
+/** A single paint operation. */
+export type DrawItem = TextItem | RectItem | ImageItem;
+/** One typeset page, and what to paint on it. */
+export interface Page {
+    /** Folio, counting from 1. */
+    number: number;
+    /** Which side of the spread this page falls on. */
+    side: Side;
+    /** Trimmed page width in points. */
+    width: number;
+    /** Trimmed page height in points. */
+    height: number;
+    /**
+     * The content-tree node ids of the sections this page holds content
+     * from, in the order their content appears on it. A chapter that
+     * ends mid-page is followed there by the next one opening, so the
+     * page names both. A blank leaf names none.
+     */
+    sections: number[];
+    /** What to paint, in paint order. */
+    items: DrawItem[];
+}
+/** One axis of a variable face, pinned. */
+export interface AxisSetting {
+    /** The four-character OpenType axis tag, e.g. `wght`. */
+    tag: string;
+    /** The coordinate in the axis's own units. */
+    value: number;
+}
+/** The slope and weight a face answers for. */
+export interface FaceAttributes {
+    /** True for italic and oblique alike. */
+    italic: boolean;
+    /** Weight on the CSS 1–1000 scale. */
+    weight: number;
+}
+/** A font's identity, as the display structure indexes it. */
+export interface FontRefEntry {
+    /** Family for matching, lowercase. */
+    family: string;
+    /** Face name. */
+    name: string;
+    /** Style name. */
+    style: string;
+    /** What this face answers for. */
+    attributes: FaceAttributes;
+    /**
+     * Where on its file's axes this face sits, in user space. Empty
+     * for a static face and for a variable one at its default
+     * location. A painter pins these axes and draws the cut the run
+     * was shaped at rather than the file's default.
+     */
+    variations: AxisSetting[];
+}
+/** A book that laid out anyway, and what it had to complain about. */
+export interface Warning {
+    /** What went wrong, in one line. */
+    message: string;
+    /** Where it was written, when the engine knows. */
+    origin: string | null;
+}
+/** Everything one run produced: pages, the fonts they index, diagnostics. */
+export interface LayoutOutput {
+    /** The typeset pages, in reading order. */
+    pages: Page[];
+    /** The fonts this run used, indexed by `fontId`. */
+    fonts: FontRefEntry[];
+    /** The images this run placed, indexed by `ImageItem.asset`. */
+    assets: Asset[];
+    /** Everything the run had to complain about. */
+    warnings: Warning[];
+}
+/** A buffer this reader will not read, and why. */
+export declare class WireError extends Error {
+    constructor(message: string);
+}
+/**
+ * The version a buffer leads with, without reading the rest of it.
+ */
+export declare function wireVersionOf(bytes: Uint8Array): number;
+/**
+ * Reads a display structure, refusing a version this reader does not know
+ * rather than painting whatever the bytes happen to decode to.
+ */
+export declare function decodeDisplayList(bytes: Uint8Array): LayoutOutput;
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

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