@lpdfio/lpdf 0.29.0 → 0.30.0

package/dist/markdown.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LpdfMarkdown = exports.LMarkdown = void 0;
+const _shared_1 = require("./_shared");
+// ── The markdown of a section ─────────────────────────────────────────────────
+/**
+ * Markdown as the content of a section, where a layout would go. It holds only Markdown: the `LMarkdown.styles`
+ * that say how each part looks, which are optional, and one `LMarkdown.content` with the text. What Markdown
+ * can't say, such as the page, a header, a footer or a cover, stays in the section around it: layers paint a
+ * header and a footer in the margin it leaves.
+ *
+ * ```ts
+ * L.markdown({ margin: '54pt', gap: 'm' }, [
+ *   LMarkdown.styles(NoAttr, [LMarkdown.h1({ color: 'muted' })]),
+ *   LMarkdown.content(NoAttr, [body]),
+ * ])
+ * ```
+ */
+function markdown(attrs, nodes = []) {
+    return { type: 'markdown', attrs: (0, _shared_1.buildAttrs)(attrs), nodes };
+}
+// ── LMarkdown: the parts of a markdown ────────────────────────────────────────
+/**
+ * The rules that say how the parts of a markdown look. A rule is named after the Markdown it styles and takes the
+ * attributes of the element it becomes. A rule here overrides the same rule of the file `src` names, which
+ * overrides the defaults.
+ */
+function styles(attrs, nodes = []) {
+    return { type: 'markdown-styles', attrs: (0, _shared_1.buildAttrs)(attrs), nodes };
+}
+/**
+ * The Markdown, as strings that make one text. The common indent of its lines is removed, so that indenting the
+ * code does not make a code block of it. It has no attributes: pass `NoAttr`.
+ */
+function content(attrs, nodes = []) {
+    return { type: 'markdown-content', attrs: {}, nodes };
+}
+function rule(type) {
+    return (attrs = null) => ({ type, attrs: (0, _shared_1.buildAttrs)(attrs) });
+}
+/** The parts of a markdown: its styles, its content and the rules of its styles. */
+exports.LMarkdown = Object.freeze({
+    styles,
+    content,
+    h1: rule('h1'),
+    h2: rule('h2'),
+    h3: rule('h3'),
+    h4: rule('h4'),
+    h5: rule('h5'),
+    h6: rule('h6'),
+    p: rule('p'),
+    code: rule('code'),
+    quote: rule('quote'),
+    li: rule('li'),
+    a: rule('a'),
+    strong: rule('strong'),
+    em: rule('em'),
+    del: rule('del'),
+    table: rule('table'),
+    th: rule('th'),
+    td: rule('td'),
+});
+exports.LpdfMarkdown = Object.freeze({ markdown });

package/dist/wasm/lpdf-web.js

@@ -46,6 +46,20 @@ export class LpdfEngine {
         const len1 = WASM_VECTOR_LEN;
         wasm.lpdfengine_load_image(this.__wbg_ptr, ptr0, len0, ptr1, len1);
     }
+    /**
+     * Register the text of a file of Markdown rules, the root of which is a `<markdown-styles>`, for the
+     * `src` that names it. The engine reads no files: call this once for every `<markdown-styles src="…">`
+     * of the document before `render_pdf`, as `load_font` is called for a font.
+     * @param {string} src
+     * @param {string} xml
+     */
+    load_markdown_styles(src, xml) {
+        const ptr0 = passStringToWasm0(src, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(xml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.lpdfengine_load_markdown_styles(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+    }
     /**
      * @param {string} license_key
      */
@@ -152,26 +166,40 @@ export class LpdfEngine {
         wasm.lpdfengine_set_created_on(this.__wbg_ptr, ptr0, len0);
     }
     /**
-     * Configure RC4-128 encryption applied to every subsequent `render_pdf` call.
+     * Configure encryption applied to every subsequent `render_pdf` call.
      *
      * `permissions_json` is a JSON object with boolean fields matching the
      * `Permissions` struct (`print`, `modify`, `copy`, `annotate`, `fill_forms`,
      * `accessibility`, `assemble`, `print_hq`). Omitted fields default to `true`.
      *
+     * `algorithm` is `"aes-256"` or `"rc4-128"`. AES-256 needs `entropy`: at least 32
+     * random bytes from the host's secure generator, from which the core cuts the file
+     * key, salts and IVs. RC4-128 ignores it. Fails when the algorithm is unknown or
+     * AES-256 gets too little entropy.
+     *
      * To apply permissions without an open password, pass an empty `user_password`
      * and a non-empty `owner_password`.
      * @param {string} user_password
      * @param {string} owner_password
      * @param {string} permissions_json
+     * @param {string} algorithm
+     * @param {Uint8Array} entropy
      */
-    set_encryption(user_password, owner_password, permissions_json) {
+    set_encryption(user_password, owner_password, permissions_json, algorithm, entropy) {
         const ptr0 = passStringToWasm0(user_password, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passStringToWasm0(owner_password, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len1 = WASM_VECTOR_LEN;
         const ptr2 = passStringToWasm0(permissions_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len2 = WASM_VECTOR_LEN;
-        wasm.lpdfengine_set_encryption(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
+        const ptr3 = passStringToWasm0(algorithm, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passArray8ToWasm0(entropy, wasm.__wbindgen_malloc);
+        const len4 = WASM_VECTOR_LEN;
+        const ret = wasm.lpdfengine_set_encryption(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
     }
     /**
      * Inject glyph advance-width tables for custom fonts.
@@ -344,6 +372,132 @@ export function kit_to_xml(json) {
         wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
     }
 }
+
+/**
+ * The template `template` with an `<image>` declared for each path of the JSON array `srcs`, named as
+ * `markdown_file_images` says.
+ * @param {string} template
+ * @param {string} srcs
+ * @returns {string}
+ */
+export function markdown_declare_images(template, srcs) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(template, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(srcs, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.markdown_declare_images(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * The rules a `<markdown>` with no styles uses, as the file to start a style of one's own from.
+ * @returns {string}
+ */
+export function markdown_default_styles() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.markdown_default_styles();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+
+/**
+ * The data a template gets for the `.md` file `markdown`, as JSON: the text as `markdown`, and the fields of its
+ * front matter, each a string.
+ * @param {string} markdown
+ * @returns {string}
+ */
+export function markdown_file_data(markdown) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.markdown_file_data(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * The relative paths of the images of the `.md` file `markdown`, as a JSON array. The caller declares them with
+ * `markdown_declare_images` and loads each file, relative to the `.md`, under the name `markdown-image-N` where N
+ * counts from 1 in the order of the array.
+ * @param {string} markdown
+ * @returns {string}
+ */
+export function markdown_file_images(markdown) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.markdown_file_images(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+/**
+ * The looks a `.md` file can start from besides the default one, as a JSON array of `name`, `label`, `description`
+ * and `styles`: the file of styles, to write beside the `.md` file and edit.
+ * @returns {string}
+ */
+export function markdown_style_presets() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.markdown_style_presets();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+
+/**
+ * The template that wraps a `.md` file when it is rendered with no template of its own: A4, a margin and the
+ * page number. It reads the Markdown from the data `markdown`, the rest of which is the file's front matter.
+ * @returns {string}
+ */
+export function markdown_template() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.markdown_template();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,

package/dist/wasm/lpdf.js

@@ -46,6 +46,20 @@ class LpdfEngine {
         const len1 = WASM_VECTOR_LEN;
         wasm.lpdfengine_load_image(this.__wbg_ptr, ptr0, len0, ptr1, len1);
     }
+    /**
+     * Register the text of a file of Markdown rules, the root of which is a `<markdown-styles>`, for the
+     * `src` that names it. The engine reads no files: call this once for every `<markdown-styles src="…">`
+     * of the document before `render_pdf`, as `load_font` is called for a font.
+     * @param {string} src
+     * @param {string} xml
+     */
+    load_markdown_styles(src, xml) {
+        const ptr0 = passStringToWasm0(src, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(xml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.lpdfengine_load_markdown_styles(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+    }
     /**
      * @param {string} license_key
      */
@@ -152,26 +166,40 @@ class LpdfEngine {
         wasm.lpdfengine_set_created_on(this.__wbg_ptr, ptr0, len0);
     }
     /**
-     * Configure RC4-128 encryption applied to every subsequent `render_pdf` call.
+     * Configure encryption applied to every subsequent `render_pdf` call.
      *
      * `permissions_json` is a JSON object with boolean fields matching the
      * `Permissions` struct (`print`, `modify`, `copy`, `annotate`, `fill_forms`,
      * `accessibility`, `assemble`, `print_hq`). Omitted fields default to `true`.
      *
+     * `algorithm` is `"aes-256"` or `"rc4-128"`. AES-256 needs `entropy`: at least 32
+     * random bytes from the host's secure generator, from which the core cuts the file
+     * key, salts and IVs. RC4-128 ignores it. Fails when the algorithm is unknown or
+     * AES-256 gets too little entropy.
+     *
      * To apply permissions without an open password, pass an empty `user_password`
      * and a non-empty `owner_password`.
      * @param {string} user_password
      * @param {string} owner_password
      * @param {string} permissions_json
+     * @param {string} algorithm
+     * @param {Uint8Array} entropy
      */
-    set_encryption(user_password, owner_password, permissions_json) {
+    set_encryption(user_password, owner_password, permissions_json, algorithm, entropy) {
         const ptr0 = passStringToWasm0(user_password, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passStringToWasm0(owner_password, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len1 = WASM_VECTOR_LEN;
         const ptr2 = passStringToWasm0(permissions_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len2 = WASM_VECTOR_LEN;
-        wasm.lpdfengine_set_encryption(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
+        const ptr3 = passStringToWasm0(algorithm, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passArray8ToWasm0(entropy, wasm.__wbindgen_malloc);
+        const len4 = WASM_VECTOR_LEN;
+        const ret = wasm.lpdfengine_set_encryption(this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
     }
     /**
      * Inject glyph advance-width tables for custom fonts.
@@ -349,6 +377,138 @@ function kit_to_xml(json) {
     }
 }
 exports.kit_to_xml = kit_to_xml;
+
+/**
+ * The template `template` with an `<image>` declared for each path of the JSON array `srcs`, named as
+ * `markdown_file_images` says.
+ * @param {string} template
+ * @param {string} srcs
+ * @returns {string}
+ */
+function markdown_declare_images(template, srcs) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(template, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(srcs, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.markdown_declare_images(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+exports.markdown_declare_images = markdown_declare_images;
+
+/**
+ * The rules a `<markdown>` with no styles uses, as the file to start a style of one's own from.
+ * @returns {string}
+ */
+function markdown_default_styles() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.markdown_default_styles();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+exports.markdown_default_styles = markdown_default_styles;
+
+/**
+ * The data a template gets for the `.md` file `markdown`, as JSON: the text as `markdown`, and the fields of its
+ * front matter, each a string.
+ * @param {string} markdown
+ * @returns {string}
+ */
+function markdown_file_data(markdown) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.markdown_file_data(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+exports.markdown_file_data = markdown_file_data;
+
+/**
+ * The relative paths of the images of the `.md` file `markdown`, as a JSON array. The caller declares them with
+ * `markdown_declare_images` and loads each file, relative to the `.md`, under the name `markdown-image-N` where N
+ * counts from 1 in the order of the array.
+ * @param {string} markdown
+ * @returns {string}
+ */
+function markdown_file_images(markdown) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(markdown, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.markdown_file_images(ptr0, len0);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+exports.markdown_file_images = markdown_file_images;
+
+/**
+ * The looks a `.md` file can start from besides the default one, as a JSON array of `name`, `label`, `description`
+ * and `styles`: the file of styles, to write beside the `.md` file and edit.
+ * @returns {string}
+ */
+function markdown_style_presets() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.markdown_style_presets();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+exports.markdown_style_presets = markdown_style_presets;
+
+/**
+ * The template that wraps a `.md` file when it is rendered with no template of its own: A4, a margin and the
+ * page number. It reads the Markdown from the data `markdown`, the rest of which is the file's front matter.
+ * @returns {string}
+ */
+function markdown_template() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.markdown_template();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+exports.markdown_template = markdown_template;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lpdfio/lpdf",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Node.js SDK for Lpdf — PDF as Code on every platform. You describe a document as code or XML. Lpdf renders a compact, pixel-perfect PDF — identical across platforms.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,5 +48,8 @@
     "@types/node": "^20.0.0",
     "esbuild": "^0.25.0",
     "typescript": "^5.0.0"
+  },
+  "allowScripts": {
+    "esbuild": false
   }
 }