@typbase/engine 0.3.1 → 0.4.0

package/engine.d.ts

@@ -1,7 +1,7 @@
 /* tslint:disable */
 /* eslint-disable */
 /**
- * A `#typbase.section(kind: ...)[...]` block. Ranges are raw source bytes;
+ * A `#typbase.section(kind: ...)[...]` block. Ranges are raw source bytes.
  * `content_start..content_end` is the markup inside the brackets.
  */
 export interface SectionSpan {
@@ -15,30 +15,34 @@ export interface SectionSpan {
 
 /**
  * A file, source, or package the compiler asked for but the world does not
- * have. Every compile returns the requests it accumulated; the caller
+ * have. Every compile returns the requests it accumulated, and the caller
  * resolves them (workspace source, blob bytes, package tarball) and recompiles.
  */
 export type TypstRequest = { type: "source"; value: string } | { type: "file"; value: string } | { type: "package"; value: { namespace: string; name: string; version: string } };
 
 /**
- * A notebook cell: one `// %%` marker line plus the content below it, up to
- * the next marker or the end of the document. Ranges are UTF-16 offsets into
+ * A notebook cell: one `//%` attribute line plus the content below it, up to
+ * the next boundary or the end of the document. Ranges are UTF-16 offsets into
  * the raw source, so they can be used as editor positions directly.
  */
 export interface CellSpan {
     /**
-     * Cell type from the marker label: `"markup"` or `"code"`.
+     * `"prose"`, `"code"`, `"log"`, or `"hidden"`.
      */
     kind: string;
     /**
-     * Marker line range, excluding the newline. Both zero on the implicit
-     * leading cell of a document whose first marker is not on line one.
+     * `name=` from the attribute line, when it carries one.
+     */
+    name: string | undefined;
+    /**
+     * Attribute line range, excluding the newline. Both zero on a cell that
+     * began at a heading and on the implicit cell above the first boundary.
      */
     marker_start: number;
     marker_end: number;
     /**
      * Content range. Blank lines below the content belong to the gap before
-     * the next marker and are excluded.
+     * the next boundary and are excluded.
      */
     content_start: number;
     content_end: number;
@@ -60,7 +64,7 @@ export interface SvgRangedFrame {
 
 /**
  * One flattened source block. `map[i]` is the raw byte offset of plain byte
- * `i`; FTS offsets in `plain` translate through it to editor positions.
+ * `i`. FTS offsets in `plain` translate through it to editor positions.
  */
 export interface FlattenedBlock {
     kind: string;
@@ -95,7 +99,7 @@ export interface LinkSpan {
     target_from: number;
     target_to: number;
     /**
-     * True when the target is computed at compile time; the index resolves
+     * True when the target is computed at compile time. The index resolves
      * the ids from a compile and this span only locates the call.
      */
     dynamic: boolean;
@@ -152,9 +156,19 @@ export interface SvgRender {
      */
     frames: SvgRangedFrame[];
     /**
-     * Rendered SVG frames for tooltips.
+     * Rendered SVG frames for tooltips. These keep their own definitions.
      */
     tooltips: SvgRangedFrame[];
+    /**
+     * The definitions [`frames`](Self::frames) reference, which the host has to
+     * place in the document. `None` when the frames drew nothing that needed
+     * any.
+     */
+    defs: string | undefined;
+    /**
+     * UTF-16 ranges of every equation, rendered or not.
+     */
+    equation_ranges: [number, number][];
     /**
      * Diagnostics and warnings produced during rendering.
      */
@@ -197,7 +211,7 @@ export interface RenderHtmlResult {
     diagnostics: TypstDiagnostic[];
     /**
      * Requests the caller must satisfy before re-rendering (query JSON,
-     * embedded pages). The editor's `compileHTML` carries them too; the
+     * embedded pages). The editor's `compileHTML` carries them too, but the
      * publish worker needs them on this path.
      */
     requests: TypstRequest[];
@@ -230,7 +244,22 @@ export interface CompileHTMLResult {
 
 export interface CompilePagedResult {
     frames: SvgRangedFrame[];
+    /**
+     * The definitions `frames` reference, for the host to place in the document.
+     * The frames are not self-contained without it.
+     */
+    defs: string | undefined;
+    /**
+     * Equation overlays, narrowed to the equation the caret is inside when the
+     * caller passed one.
+     */
     tooltips: SvgRangedFrame[];
+    /**
+     * UTF-16 ranges of every equation in the note, whether or not its overlay
+     * was rendered. The editor compares the cursor against these to know when
+     * it has entered math whose overlay the last render did not build.
+     */
+    equation_ranges: [number, number][];
     diagnostics: TypstDiagnostic[];
     requests: TypstRequest[];
 }
@@ -361,9 +390,14 @@ export class TypstState {
      * The editor's paged render: one SVG frame per source chunk, plus the
      * tooltip frames and diagnostics the editor needs.
      */
-    compilePaged(id: FileId, text: string, prelude: string): CompilePagedResult;
+    compilePaged(id: FileId, text: string, prelude: string, caret?: number | null): CompilePagedResult;
     createFileId(path: string): FileId;
     createSourceId(path: string, space_id: string): FileId;
+    /**
+     * Diagnostics for the current text, through the same error recovery the
+     * render uses, without rendering frames and without publishing a document.
+     */
+    diagnosePaged(id: FileId, text: string, prelude: string): CheckResult;
     /**
      * Clears Typst's global memoization caches. They make repeated compiles
      * cheap but grow for the lifetime of the instance, so call this when
@@ -377,25 +411,30 @@ export class TypstState {
      */
     evictCachesAged(max_age: number): void;
     /**
-     * Extracts notebook cells (`// %%` markers) as UTF-16 spans, ready for
-     * CodeMirror positions. Pure syntax pass; no state needed.
+     * Extracts notebook cells as UTF-16 spans, ready for CodeMirror
+     * positions. Shares the note's parse tree, like the other syntax passes.
      */
-    extractCells(text: string): CellSpan[];
+    extractCells(id: FileId, text: string): CellSpan[];
     /**
      * Extracts the app's link calls (`typbase.page-link`, `typbase.embed`,
-     * and `typbase://page/` URLs) with UTF-16 ranges. Pure syntax pass; no
-     * state needed.
+     * and `typbase://page/` URLs) with UTF-16 ranges. Shares the note's parse
+     * tree, like the other syntax passes.
      */
-    extractLinks(text: string): LinkSpan[];
+    extractLinks(id: FileId | null | undefined, text: string): LinkSpan[];
     /**
      * Extracts `#typbase.section` spans for the page doc's sections list.
      */
-    extractSections(text: string): SectionSpan[];
+    extractSections(id: FileId | null | undefined, text: string): SectionSpan[];
     /**
      * Plain-text flattening per block for the search index, plus the byte
-     * map back to raw source. Pure syntax pass; no state needed.
+     * map back to raw source.
+     */
+    flattenDocument(id: FileId | null | undefined, text: string): FlattenedBlock[];
+    /**
+     * The families a font file declares, so an upload can be filed under the
+     * name the font itself carries. Empty when the bytes are not a font.
      */
-    flattenDocument(text: string): FlattenedBlock[];
+    static fontFamilies(bytes: Uint8Array): string[];
     highlight(id: FileId, text: string): TypstHighlight[];
     hover(id: FileId, raw_cursor_utf16: number, side: number): string | undefined;
     insertFile(id: FileId, bytes: Uint8Array): void;
@@ -405,8 +444,8 @@ export class TypstState {
     jumpHTML(id: FileId, element: Uint32Array): TypstJump | undefined;
     jumpPaged(id: FileId, x: number, y: number): TypstJump | undefined;
     /**
-     * Current WASM heap size in bytes. The lab watches this to catch leaks;
-     * the wasm allocator rarely returns memory to the browser, so growth
+     * Current WASM heap size in bytes. The lab watches this to catch leaks.
+     * The wasm allocator rarely returns memory to the browser, so growth
      * here usually means a compile loop.
      */
     memoryBytes(): number;
@@ -419,20 +458,20 @@ export class TypstState {
     removePackage(spec: string): void;
     /**
      * Renders the whole note to one HTML document, with recovery. Used by
-     * publish, export, and chat; the editor's inline frames use
+     * publish, export, and chat. The editor's inline frames use
      * `compileHTML` instead.
      */
     renderHtml(id: FileId, text: string, prelude: string): RenderHtmlResult;
     /**
      * PDF publishing, compiled only when the `pdf` cargo feature is on.
-     * Returns the PDF bytes plus diagnostics; the caller uploads the bytes
+     * Returns the PDF bytes plus diagnostics. The caller uploads the bytes
      * as a blob on `at.typbase.post`.
      */
     renderPdf(id: FileId, text: string, prelude: string): RenderPdfResult;
     /**
      * SVG export of the paged document: one entry per page, or a single
      * merged document. Uses the PDF page geometry so the sheets match the
-     * PDF export; the caller sets the page width through `resize`.
+     * PDF export. The caller sets the page width through `resize`.
      */
     renderSvg(id: FileId, text: string, prelude: string, merged: boolean): RenderSvgResult;
     resize(id: FileId, width?: number | null, height?: number | null): boolean;
@@ -460,11 +499,23 @@ export class TypstState {
     setMathFont(id: FileId, math_font?: string | null): void;
     setTextSize(id: FileId, text_size: number): void;
     setTheme(id: FileId, theme: ThemeColors): void;
+    /**
+     * Typographic features the generated prelude turns on or off. They live in
+     * the space context rather than in an app-side prelude so the editor,
+     * previews, plugin surfaces, exports, and published pages all read the
+     * same values from one place.
+     */
+    setTypography(id: FileId, ligatures: boolean, kerning: boolean): void;
     /**
      * The style block alone, for exports and the project mirror: the same
      * text the engine prepends, minus the render-target page config.
      */
-    static stylePrelude(theme: ThemeColors, text_size: number, font: string, math_font: string | null | undefined, code_font: string | null | undefined, locale: string): string;
+    static stylePrelude(theme: ThemeColors, text_size: number, font: string, math_font: string | null | undefined, code_font: string | null | undefined, locale: string, ligatures: boolean, kerning: boolean): string;
+    /**
+     * Brings the engine's sources and maps up to date with `text` without
+     * rendering anything.
+     */
+    syncSource(id: FileId, text: string, prelude: string): boolean;
     /**
      * The stdlib source as shipped, for writing a compilable project to disk.
      */
@@ -477,7 +528,7 @@ export class TypstState {
  * The two wasm tasks write the same `pkg/` directory, so a stray
  * `engine:build-dev` edge in a release graph silently swaps the optimized
  * engine for the unoptimized one. Release tooling can read this before
- * publishing; custom sections cannot key that kind of check because wasm-opt
+ * publishing. Custom sections cannot key that kind of check because wasm-opt
  * and wasm-bindgen rewrite them.
  */
 export function isDevelopmentBuild(): boolean;
@@ -524,15 +575,17 @@ export interface InitOutput {
     readonly typststate_checkIndex: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly typststate_checkPaged: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly typststate_compileHTML: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-    readonly typststate_compilePaged: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly typststate_compilePaged: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly typststate_createFileId: (a: number, b: number, c: number) => number;
     readonly typststate_createSourceId: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly typststate_diagnosePaged: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly typststate_evictCaches: (a: number) => void;
     readonly typststate_evictCachesAged: (a: number, b: number) => void;
-    readonly typststate_extractCells: (a: number, b: number, c: number, d: number) => void;
-    readonly typststate_extractLinks: (a: number, b: number, c: number, d: number) => void;
-    readonly typststate_extractSections: (a: number, b: number, c: number, d: number) => void;
-    readonly typststate_flattenDocument: (a: number, b: number, c: number, d: number) => void;
+    readonly typststate_extractCells: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly typststate_extractLinks: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly typststate_extractSections: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly typststate_flattenDocument: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly typststate_fontFamilies: (a: number, b: number, c: number) => void;
     readonly typststate_highlight: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly typststate_hover: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly typststate_insertFile: (a: number, b: number, c: number, d: number) => void;
@@ -559,7 +612,9 @@ export interface InitOutput {
     readonly typststate_setMathFont: (a: number, b: number, c: number, d: number) => void;
     readonly typststate_setTextSize: (a: number, b: number, c: number) => void;
     readonly typststate_setTheme: (a: number, b: number, c: number) => void;
-    readonly typststate_stylePrelude: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+    readonly typststate_setTypography: (a: number, b: number, c: number, d: number) => void;
+    readonly typststate_stylePrelude: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => void;
+    readonly typststate_syncSource: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
     readonly typststate_typbaseLib: (a: number, b: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;

package/engine.js

@@ -371,9 +371,10 @@ export class TypstState {
      * @param {FileId} id
      * @param {string} text
      * @param {string} prelude
+     * @param {number | null} [caret]
      * @returns {CompilePagedResult}
      */
-    compilePaged(id, text, prelude) {
+    compilePaged(id, text, prelude, caret) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             _assertClass(id, FileId);
@@ -381,7 +382,7 @@ export class TypstState {
             const len0 = WASM_VECTOR_LEN;
             const ptr1 = passStringToWasm0(prelude, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len1 = WASM_VECTOR_LEN;
-            wasm.typststate_compilePaged(retptr, this.__wbg_ptr, id.__wbg_ptr, ptr0, len0, ptr1, len1);
+            wasm.typststate_compilePaged(retptr, this.__wbg_ptr, id.__wbg_ptr, ptr0, len0, ptr1, len1, isLikeNone(caret) ? Number.MAX_SAFE_INTEGER : (caret) >>> 0);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -416,6 +417,34 @@ export class TypstState {
         const ret = wasm.typststate_createSourceId(this.__wbg_ptr, ptr0, len0, ptr1, len1);
         return FileId.__wrap(ret);
     }
+    /**
+     * Diagnostics for the current text, through the same error recovery the
+     * render uses, without rendering frames and without publishing a document.
+     * @param {FileId} id
+     * @param {string} text
+     * @param {string} prelude
+     * @returns {CheckResult}
+     */
+    diagnosePaged(id, text, prelude) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(id, FileId);
+            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(prelude, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.typststate_diagnosePaged(retptr, this.__wbg_ptr, id.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Clears Typst's global memoization caches. They make repeated compiles
      * cheap but grow for the lifetime of the instance, so call this when
@@ -434,17 +463,19 @@ export class TypstState {
         wasm.typststate_evictCachesAged(this.__wbg_ptr, max_age);
     }
     /**
-     * Extracts notebook cells (`// %%` markers) as UTF-16 spans, ready for
-     * CodeMirror positions. Pure syntax pass; no state needed.
+     * Extracts notebook cells as UTF-16 spans, ready for CodeMirror
+     * positions. Shares the note's parse tree, like the other syntax passes.
+     * @param {FileId} id
      * @param {string} text
      * @returns {CellSpan[]}
      */
-    extractCells(text) {
+    extractCells(id, text) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(id, FileId);
             const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len0 = WASM_VECTOR_LEN;
-            wasm.typststate_extractCells(retptr, this.__wbg_ptr, ptr0, len0);
+            wasm.typststate_extractCells(retptr, this.__wbg_ptr, id.__wbg_ptr, ptr0, len0);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -461,17 +492,23 @@ export class TypstState {
     }
     /**
      * Extracts the app's link calls (`typbase.page-link`, `typbase.embed`,
-     * and `typbase://page/` URLs) with UTF-16 ranges. Pure syntax pass; no
-     * state needed.
+     * and `typbase://page/` URLs) with UTF-16 ranges. Shares the note's parse
+     * tree, like the other syntax passes.
+     * @param {FileId | null | undefined} id
      * @param {string} text
      * @returns {LinkSpan[]}
      */
-    extractLinks(text) {
+    extractLinks(id, text) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-            const len0 = WASM_VECTOR_LEN;
-            wasm.typststate_extractLinks(retptr, this.__wbg_ptr, ptr0, len0);
+            let ptr0 = 0;
+            if (!isLikeNone(id)) {
+                _assertClass(id, FileId);
+                ptr0 = id.__destroy_into_raw();
+            }
+            const ptr1 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.typststate_extractLinks(retptr, this.__wbg_ptr, ptr0, ptr1, len1);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -479,24 +516,30 @@ export class TypstState {
             if (r3) {
                 throw takeObject(r2);
             }
-            var v2 = getArrayJsValueFromWasm0(r0, r1);
+            var v3 = getArrayJsValueFromWasm0(r0, r1);
             wasm.__wbindgen_export4(r0, r1 * 4, 4);
-            return v2;
+            return v3;
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
      * Extracts `#typbase.section` spans for the page doc's sections list.
+     * @param {FileId | null | undefined} id
      * @param {string} text
      * @returns {SectionSpan[]}
      */
-    extractSections(text) {
+    extractSections(id, text) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-            const len0 = WASM_VECTOR_LEN;
-            wasm.typststate_extractSections(retptr, this.__wbg_ptr, ptr0, len0);
+            let ptr0 = 0;
+            if (!isLikeNone(id)) {
+                _assertClass(id, FileId);
+                ptr0 = id.__destroy_into_raw();
+            }
+            const ptr1 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.typststate_extractSections(retptr, this.__wbg_ptr, ptr0, ptr1, len1);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -504,25 +547,31 @@ export class TypstState {
             if (r3) {
                 throw takeObject(r2);
             }
-            var v2 = getArrayJsValueFromWasm0(r0, r1);
+            var v3 = getArrayJsValueFromWasm0(r0, r1);
             wasm.__wbindgen_export4(r0, r1 * 4, 4);
-            return v2;
+            return v3;
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
     /**
      * Plain-text flattening per block for the search index, plus the byte
-     * map back to raw source. Pure syntax pass; no state needed.
+     * map back to raw source.
+     * @param {FileId | null | undefined} id
      * @param {string} text
      * @returns {FlattenedBlock[]}
      */
-    flattenDocument(text) {
+    flattenDocument(id, text) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-            const len0 = WASM_VECTOR_LEN;
-            wasm.typststate_flattenDocument(retptr, this.__wbg_ptr, ptr0, len0);
+            let ptr0 = 0;
+            if (!isLikeNone(id)) {
+                _assertClass(id, FileId);
+                ptr0 = id.__destroy_into_raw();
+            }
+            const ptr1 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.typststate_flattenDocument(retptr, this.__wbg_ptr, ptr0, ptr1, len1);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -530,6 +579,27 @@ export class TypstState {
             if (r3) {
                 throw takeObject(r2);
             }
+            var v3 = getArrayJsValueFromWasm0(r0, r1);
+            wasm.__wbindgen_export4(r0, r1 * 4, 4);
+            return v3;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * The families a font file declares, so an upload can be filed under the
+     * name the font itself carries. Empty when the bytes are not a font.
+     * @param {Uint8Array} bytes
+     * @returns {string[]}
+     */
+    static fontFamilies(bytes) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.typststate_fontFamilies(retptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var v2 = getArrayJsValueFromWasm0(r0, r1);
             wasm.__wbindgen_export4(r0, r1 * 4, 4);
             return v2;
@@ -681,8 +751,8 @@ export class TypstState {
         }
     }
     /**
-     * Current WASM heap size in bytes. The lab watches this to catch leaks;
-     * the wasm allocator rarely returns memory to the browser, so growth
+     * Current WASM heap size in bytes. The lab watches this to catch leaks.
+     * The wasm allocator rarely returns memory to the browser, so growth
      * here usually means a compile loop.
      * @returns {number}
      */
@@ -731,7 +801,7 @@ export class TypstState {
     }
     /**
      * Renders the whole note to one HTML document, with recovery. Used by
-     * publish, export, and chat; the editor's inline frames use
+     * publish, export, and chat. The editor's inline frames use
      * `compileHTML` instead.
      * @param {FileId} id
      * @param {string} text
@@ -760,7 +830,7 @@ export class TypstState {
     }
     /**
      * PDF publishing, compiled only when the `pdf` cargo feature is on.
-     * Returns the PDF bytes plus diagnostics; the caller uploads the bytes
+     * Returns the PDF bytes plus diagnostics. The caller uploads the bytes
      * as a blob on `at.typbase.post`.
      * @param {FileId} id
      * @param {string} text
@@ -790,7 +860,7 @@ export class TypstState {
     /**
      * SVG export of the paged document: one entry per page, or a single
      * merged document. Uses the PDF page geometry so the sheets match the
-     * PDF export; the caller sets the page width through `resize`.
+     * PDF export. The caller sets the page width through `resize`.
      * @param {FileId} id
      * @param {string} text
      * @param {string} prelude
@@ -924,6 +994,19 @@ export class TypstState {
         var ptr0 = theme.__destroy_into_raw();
         wasm.typststate_setTheme(this.__wbg_ptr, id.__wbg_ptr, ptr0);
     }
+    /**
+     * Typographic features the generated prelude turns on or off. They live in
+     * the space context rather than in an app-side prelude so the editor,
+     * previews, plugin surfaces, exports, and published pages all read the
+     * same values from one place.
+     * @param {FileId} id
+     * @param {boolean} ligatures
+     * @param {boolean} kerning
+     */
+    setTypography(id, ligatures, kerning) {
+        _assertClass(id, FileId);
+        wasm.typststate_setTypography(this.__wbg_ptr, id.__wbg_ptr, ligatures, kerning);
+    }
     /**
      * The style block alone, for exports and the project mirror: the same
      * text the engine prepends, minus the render-target page config.
@@ -933,9 +1016,11 @@ export class TypstState {
      * @param {string | null | undefined} math_font
      * @param {string | null | undefined} code_font
      * @param {string} locale
+     * @param {boolean} ligatures
+     * @param {boolean} kerning
      * @returns {string}
      */
-    static stylePrelude(theme, text_size, font, math_font, code_font, locale) {
+    static stylePrelude(theme, text_size, font, math_font, code_font, locale, ligatures, kerning) {
         let deferred6_0;
         let deferred6_1;
         try {
@@ -950,7 +1035,7 @@ export class TypstState {
             var len3 = WASM_VECTOR_LEN;
             const ptr4 = passStringToWasm0(locale, wasm.__wbindgen_export, wasm.__wbindgen_export2);
             const len4 = WASM_VECTOR_LEN;
-            wasm.typststate_stylePrelude(retptr, ptr0, text_size, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+            wasm.typststate_stylePrelude(retptr, ptr0, text_size, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ligatures, kerning);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             deferred6_0 = r0;
@@ -961,6 +1046,23 @@ export class TypstState {
             wasm.__wbindgen_export4(deferred6_0, deferred6_1, 1);
         }
     }
+    /**
+     * Brings the engine's sources and maps up to date with `text` without
+     * rendering anything.
+     * @param {FileId} id
+     * @param {string} text
+     * @param {string} prelude
+     * @returns {boolean}
+     */
+    syncSource(id, text, prelude) {
+        _assertClass(id, FileId);
+        const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(prelude, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.typststate_syncSource(this.__wbg_ptr, id.__wbg_ptr, ptr0, len0, ptr1, len1);
+        return ret !== 0;
+    }
     /**
      * The stdlib source as shipped, for writing a compilable project to disk.
      * @returns {string}
@@ -990,7 +1092,7 @@ if (Symbol.dispose) TypstState.prototype[Symbol.dispose] = TypstState.prototype.
  * The two wasm tasks write the same `pkg/` directory, so a stray
  * `engine:build-dev` edge in a release graph silently swaps the optimized
  * engine for the unoptimized one. Release tooling can read this before
- * publishing; custom sections cannot key that kind of check because wasm-opt
+ * publishing. Custom sections cannot key that kind of check because wasm-opt
  * and wasm-bindgen rewrite them.
  * @returns {boolean}
  */
@@ -1067,10 +1169,10 @@ function __wbg_get_imports() {
         __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_debug_8ae0f55ba398115d: function(arg0, arg1) {
+        __wbg_debug_2e71d77890567dd4: function(arg0, arg1) {
             console.debug(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_error_33eecdebb3e1b6a7: function(arg0, arg1) {
+        __wbg_error_f24aab6c41ae4ad8: function(arg0, arg1) {
             console.error(getStringFromWasm0(arg0, arg1));
         },
         __wbg_getTime_63fb0332e6c4ec17: function(arg0) {

package/package.json

@@ -2,8 +2,8 @@
   "name": "@typbase/engine",
   "type": "module",
   "description": "Local-first knowledge base made for Typst and the Atmosphere.",
-  "version": "0.3.1",
-  "license": "AGPL-3.0",
+  "version": "0.4.0",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/lemueldls/typbase"