peisar 1.1.0

A practical Markdown parser written in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

# Node.js usage: Vite

Vite browser applications should use Peisar's WebAssembly package instead of
the native `peisar` package.

## Install

```sh
npm i @peisar/peisar-wasm32-wasi
```

## Basic usage

```ts
import { Peisar } from "@peisar/peisar-wasm32-wasi";

const document = new Peisar("# Hello from Vite", { fragment: true });

console.log(document.html);
```

This matches the example app in [examples/vite](../../examples/vite).

## Vite configuration

The WASM package uses threads, so local development and preview must enable
cross-origin isolation headers. Exclude the package from Vite's dependency
optimizer so its worker setup is preserved.

```ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";

export default defineConfig({
  server: {
    headers: {
      "Cross-Origin-Opener-Policy": "same-origin",
      "Cross-Origin-Embedder-Policy": "require-corp",
    },
  },
  plugins: [
    react(),
    {
      name: "configure-preview-response-headers",
      configurePreviewServer(server) {
        server.middlewares.use((_req, res, next) => {
          res.setHeader("Cross-Origin-Opener-Policy", "same-origin");
          res.setHeader("Cross-Origin-Embedder-Policy", "require-corp");
          next();
        });
      },
    },
  ],
  optimizeDeps: {
    exclude: ["@peisar/peisar-wasm32-wasi"],
  },
});
```

After changing the config, clear Vite's optimized dependency cache and restart
the dev server:

```sh
rm -rf node_modules/.vite
npm run dev
```

## Production notes

- Configure the same headers in production.
- Verify `globalThis.crossOriginIsolated === true`.
- With `Cross-Origin-Embedder-Policy: require-corp`, cross-origin assets must
  also allow embedding through CORS or `Cross-Origin-Resource-Policy`.