fleuron 0.1.0

package/dist/wire.js

@@ -0,0 +1,174 @@
+/**
+ * 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 const WIRE_VERSION = 4;
+/** A buffer this reader will not read, and why. */
+export class WireError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WireError';
+    }
+}
+/** Walks a postcard buffer, one field at a time. */
+class Reader {
+    view;
+    bytes;
+    at = 0;
+    constructor(bytes) {
+        this.bytes = bytes;
+        this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    /** An unsigned varint, seven bits per byte, low group first. */
+    varint() {
+        let value = 0;
+        let shift = 0;
+        for (;;) {
+            const byte = this.bytes[this.at++];
+            if (byte === undefined) {
+                throw new WireError('the buffer ended mid-number');
+            }
+            value += (byte & 0x7f) * 2 ** shift;
+            if ((byte & 0x80) === 0) {
+                return value;
+            }
+            shift += 7;
+            if (shift > 63) {
+                throw new WireError('a varint ran past the width of a number');
+            }
+        }
+    }
+    bool() {
+        return this.varint() !== 0;
+    }
+    f32() {
+        const value = this.view.getFloat32(this.at, true);
+        this.at += 4;
+        return value;
+    }
+    string() {
+        const length = this.varint();
+        const start = this.at;
+        this.at += length;
+        if (this.at > this.bytes.length) {
+            throw new WireError('the buffer ended mid-string');
+        }
+        return decoder.decode(this.bytes.subarray(start, this.at));
+    }
+    /** A `Vec<T>`: a count, then that many of them. */
+    seq(item) {
+        const length = this.varint();
+        const out = new Array(length);
+        for (let i = 0; i < length; i += 1) {
+            out[i] = item();
+        }
+        return out;
+    }
+    /** An `Option<T>`: present or not, and the value when it is. */
+    option(item) {
+        return this.varint() === 0 ? null : item();
+    }
+    done() {
+        return this.at >= this.bytes.length;
+    }
+}
+const decoder = new TextDecoder();
+const SIDES = ['recto', 'verso'];
+function glyph(r) {
+    return { id: r.varint(), x: r.f32(), range: [r.varint(), r.varint()] };
+}
+function item(r) {
+    const variant = r.varint();
+    switch (variant) {
+        case 0:
+            return {
+                kind: 'text',
+                x: r.f32(),
+                y: r.f32(),
+                fontId: r.varint(),
+                size: r.f32(),
+                text: r.string(),
+                glyphs: r.seq(() => glyph(r)),
+            };
+        case 1:
+            return { kind: 'rect', x: r.f32(), y: r.f32(), w: r.f32(), h: r.f32() };
+        case 2:
+            return {
+                kind: 'image',
+                x: r.f32(),
+                y: r.f32(),
+                w: r.f32(),
+                h: r.f32(),
+                asset: r.varint(),
+            };
+        default:
+            throw new WireError(`draw item ${variant} is not one this reader knows`);
+    }
+}
+function page(r) {
+    const number = r.varint();
+    const side = SIDES[r.varint()];
+    if (side === undefined) {
+        throw new WireError('a page fell on neither side of the spread');
+    }
+    return {
+        number,
+        side,
+        width: r.f32(),
+        height: r.f32(),
+        sections: r.seq(() => r.varint()),
+        items: r.seq(() => item(r)),
+    };
+}
+function font(r) {
+    return {
+        family: r.string(),
+        name: r.string(),
+        style: r.string(),
+        attributes: { italic: r.bool(), weight: r.varint() },
+        variations: r.seq(() => ({ tag: r.string(), value: r.f32() })),
+    };
+}
+function asset(r) {
+    return {
+        url: r.string(),
+        intrinsic: { width: r.varint(), height: r.varint(), dpiX: r.f32(), dpiY: r.f32() },
+    };
+}
+function warning(r) {
+    return { message: r.string(), origin: r.option(() => r.string()) };
+}
+/**
+ * The version a buffer leads with, without reading the rest of it.
+ */
+export function wireVersionOf(bytes) {
+    return new Reader(bytes).varint();
+}
+/**
+ * Reads a display structure, refusing a version this reader does not know
+ * rather than painting whatever the bytes happen to decode to.
+ */
+export function decodeDisplayList(bytes) {
+    const r = new Reader(bytes);
+    const version = r.varint();
+    if (version !== WIRE_VERSION) {
+        throw new WireError(`wire version ${version}, expected ${WIRE_VERSION}`);
+    }
+    const output = {
+        pages: r.seq(() => page(r)),
+        fonts: r.seq(() => font(r)),
+        assets: r.seq(() => asset(r)),
+        warnings: r.seq(() => warning(r)),
+    };
+    if (!r.done()) {
+        throw new WireError('the buffer holds more than one display structure');
+    }
+    return output;
+}
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The worker, in the six lines it takes: load the module, hand every
+ * message to the engine, post what it says back.
+ *
+ * The handler goes on before the module has arrived, and every
+ * request waits on the same promise. A worker that installs its
+ * handler after the load loses whatever a host posted while the
+ * module was still coming down, and a host that mounts a preview and
+ * hands it a manuscript posts exactly then.
+ *
+ * A host that wants the module somewhere else, in an extension or a
+ * Node thread or a bundle that inlines the bytes, writes these lines
+ * itself over {@link createEngine}.
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/worker.js

@@ -0,0 +1,23 @@
+/**
+ * The worker, in the six lines it takes: load the module, hand every
+ * message to the engine, post what it says back.
+ *
+ * The handler goes on before the module has arrived, and every
+ * request waits on the same promise. A worker that installs its
+ * handler after the load loses whatever a host posted while the
+ * module was still coming down, and a host that mounts a preview and
+ * hands it a manuscript posts exactly then.
+ *
+ * A host that wants the module somewhere else, in an extension or a
+ * Node thread or a bundle that inlines the bytes, writes these lines
+ * itself over {@link createEngine}.
+ */
+import { createEngine } from './engine.js';
+const engine = createEngine();
+self.onmessage = ({ data }) => {
+    // Requests reach the engine in the order they arrived: promise
+    // callbacks run in the order they were registered, which is the
+    // order the messages did.
+    void engine.then((ready) => ready.submit(data, (response, transfer) => self.postMessage(response, transfer)));
+};
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAE9B,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;IAC5B,+DAA+D;IAC/D,gEAAgE;IAChE,0BAA0B;IAC1B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACzB,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CACjF,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "fleuron",
+  "version": "0.1.0",
+  "description": "Paged-media layout in a worker: markdown and CSS in, a display structure or PDF bytes out",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zachhannum/fleuron.git",
+    "directory": "crates/fleuron-wasm/npm"
+  },
+  "homepage": "https://fleuron.typeworks.dev/",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./worker": {
+      "types": "./dist/worker.d.ts",
+      "default": "./dist/worker.js"
+    },
+    "./fleuron_bg.wasm": "./wasm/fleuron_bg.wasm"
+  },
+  "files": [
+    "dist",
+    "wasm"
+  ],
+  "scripts": {
+    "build": "node scripts/prepare.mjs && tsc -p tsconfig.json",
+    "build:test": "tsc -p tsconfig.test.json",
+    "test": "npm run build:test && node build/harness.js",
+    "size": "npm run build:test && node build/size.js",
+    "test:browser": "npm run build:test && node build/browser.js",
+    "test:package": "npm run build && npm run build:test && node build/consumer.js"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "playwright": "1.56.1",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/wasm/fleuron.d.ts

@@ -0,0 +1,221 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * A retained pipeline, held in the module between calls.
+ *
+ * The session keeps the content tree, the styling and every stage
+ * between them and the page, so a second render pays for what
+ * changed and not for the book. What the stages cost, and what
+ * survives which edit, is the engine's own contract.
+ */
+export class Session {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Registers a face from font bytes, and returns the ids it was
+     * registered under. A variable file names several cuts and
+     * yields one id each.
+     *
+     * The bytes stay in the module. A host sends a face once, not
+     * once per render.
+     */
+    addFont(bytes: Uint8Array): Uint16Array;
+    /**
+     * Registers one image by the url the content tree names it by,
+     * and returns the index `DrawItem::Image.asset` will carry.
+     * `undefined` for bytes no probe recognises, which is a
+     * diagnostic on the next display structure and no image.
+     *
+     * The engine opens nothing, and a worker has nothing to open:
+     * the host fetches the file and hands the bytes over, as it does
+     * with a face. The bytes stay in the module, so an image crosses
+     * once rather than once per render.
+     */
+    addImage(url: string, bytes: Uint8Array): number | undefined;
+    /**
+     * The same run as PDF bytes. Both painters read the stages the
+     * preview settled, so an export cannot contradict what is on
+     * screen.
+     */
+    exportPdf(): Uint8Array;
+    /**
+     * The file a face was registered from, for a painter that has
+     * to draw with the bytes the engine shaped with.
+     *
+     * The bundled face is the case that needs this: it is inside
+     * the module and there is no URL a host could fetch it from.
+     * A variable file answers for every cut it named, so the same
+     * bytes come back for each of them, and the face's variations
+     * on the display structure say which instance to draw.
+     */
+    fontBytes(font_id: number): Uint8Array;
+    /**
+     * A session over the bundled face, with no content and the
+     * built-in sheet alone.
+     */
+    constructor();
+    /**
+     * The display structure, postcard-encoded, version first.
+     */
+    preview(): Uint8Array;
+    /**
+     * Drops every section that came from one source, and the
+     * complaints reading it raised.
+     */
+    removeMarkdown(name: string): void;
+    /**
+     * Sets the book from a content tree, as JSON.
+     *
+     * Markdown is the way in; this is the door for a host with a
+     * structured source of its own. Node ids are the engine's and
+     * are assigned on the way in, so a tree built by hand needs
+     * none.
+     */
+    setContent(json: string): void;
+    /**
+     * Which markdown the sources are written in: `commonmark`,
+     * `gfm` or `obsidian`.
+     */
+    setDialect(dialect: string): void;
+    /**
+     * Reads one markdown source as the whole book, its frontmatter
+     * the book's metadata.
+     *
+     * Everything below box construction is invalidated: this is the
+     * manuscript arriving, not an edit to it.
+     */
+    setMarkdown(name: string, text: string): void;
+    /**
+     * Names the book, from JSON: `title`, `author`, and an `extra`
+     * object for whatever else a frontend carries.
+     *
+     * A book read from several sources has no frontmatter of its
+     * own, so this is how it gets a title. Nothing between the
+     * content tree and the page reads metadata, so a book renamed
+     * between renders re-runs no stage; the PDF writer is the one
+     * thing that reads it.
+     */
+    setMetadata(json: string): void;
+    /**
+     * Reads several markdown sources as one book, in the order
+     * given.
+     *
+     * A lone source is the whole book, so its frontmatter is the
+     * book's. Several are chapters: each file's frontmatter belongs
+     * to the section it became, and the book is left unnamed rather
+     * than named after whichever chapter came first, which is what
+     * [`Session::set_metadata`] is for.
+     */
+    setSources(names: string[], texts: string[]): void;
+    /**
+     * Where a source's sections begin: at a heading of this level
+     * or shallower, or nowhere at all when the level is zero, which
+     * makes each file one section.
+     *
+     * Sections are what a page can start on, so this sets a book's
+     * page count before any styling does.
+     */
+    setSplit(level: number): void;
+    /**
+     * Sets the author styling from CSS text, cascading over the
+     * built-in sheet.
+     *
+     * Which stages this costs is the change's own business: a
+     * colour repaints nothing, page geometry re-fragments over the
+     * lines already broken, and only the measure or the face breaks
+     * them again.
+     */
+    setStyle(css: string): void;
+    /**
+     * How many times each stage has run since the session was made,
+     * as `[style, lines, flow, paint]`.
+     *
+     * What an edit cost, said in stage runs rather than
+     * milliseconds: a host watching this can see a cache serve
+     * where a clock would only see a fast machine.
+     */
+    stages(): Uint32Array;
+    /**
+     * Replaces every section that came from one source, reparsing
+     * that source alone. A name the book does not carry appends
+     * instead, which is how a file it has not seen before arrives.
+     *
+     * This is the keystroke path: one file crosses, one file is
+     * read, and every other section keeps the lines it already has.
+     */
+    updateMarkdown(name: string, text: string): void;
+}
+
+/**
+ * One markdown source and one stylesheet, laid out once: the batch
+ * case, over the same session a live preview keeps.
+ */
+export function render(markdown: string, css: string): Uint8Array;
+
+/**
+ * The same, as PDF bytes.
+ */
+export function renderPdf(markdown: string, css: string): Uint8Array;
+
+/**
+ * The version the display structure is encoded at. A host reads the same
+ * number off the front of every buffer and refuses one it does not
+ * know.
+ */
+export function wireVersion(): number;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_session_free: (a: number, b: number) => void;
+    readonly render: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly renderPdf: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly session_addFont: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly session_addImage: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly session_exportPdf: (a: number) => [number, number, number, number];
+    readonly session_fontBytes: (a: number, b: number) => [number, number, number, number];
+    readonly session_new: () => [number, number, number];
+    readonly session_preview: (a: number) => [number, number, number, number];
+    readonly session_removeMarkdown: (a: number, b: number, c: number) => void;
+    readonly session_setContent: (a: number, b: number, c: number) => [number, number];
+    readonly session_setDialect: (a: number, b: number, c: number) => [number, number];
+    readonly session_setMarkdown: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly session_setMetadata: (a: number, b: number, c: number) => [number, number];
+    readonly session_setSources: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+    readonly session_setSplit: (a: number, b: number) => [number, number];
+    readonly session_setStyle: (a: number, b: number, c: number) => void;
+    readonly session_stages: (a: number) => [number, number];
+    readonly session_updateMarkdown: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly wireVersion: () => number;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;