beancount-wasm 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,106 @@
+# beancount-wasm
+
+This package ships Pyodide-compatible Beancount wheels for v2 and v3 and a tiny
+wrapper to install them into a Pyodide runtime.
+
+## Usage
+
+```js
+import { createBeancountRuntime } from "beancount-wasm/runtime";
+
+const { pyodide } = await createBeancountRuntime({
+  version: "v3",
+  // Optional: override the base URL for Pyodide assets.
+  // The base URL must contain pyodide.mjs and follow the same layout as
+  // https://cdn.jsdelivr.net/pyodide/v0.25.1/full/
+  // pyodideBaseUrl: "https://cdn.jsdelivr.net/pyodide/v0.25.1/full/",
+});
+
+const result = await pyodide.runPythonAsync(`
+from beancount import loader
+entries, errors, options = loader.load_string("2024-01-01 open Assets:Cash USD")
+len(entries)
+`);
+console.log(result);
+```
+
+## API
+
+### `createBeancountRuntime(options)`
+Loads Pyodide and installs Beancount in one step.
+
+Options:
+- `version`: `"v2"` or `"v3"` (aliases: `"2"`, `"3"`, default: `"v3"`)
+- `pyodideBaseUrl`: base URL for Pyodide assets (defaults to jsDelivr)
+- `wheelBaseUrl`: base URL for wheels (defaults to jsDelivr npm CDN)
+- `deps`: override Beancount dependency installation
+- `inline`: `"auto" | "prefer" | "only" | "off"` (default: `"auto"`)
+  - `auto`: try URL first, fallback to inline on failure
+  - `prefer`: try inline first, fallback to URL
+  - `only`: inline only
+  - `off`: URL only
+- `onStatus`: optional status callback
+
+Example forcing inline-only mode:
+
+```js
+import { createBeancountRuntime } from "beancount-wasm/runtime";
+
+const { pyodide } = await createBeancountRuntime({
+  version: "v2",
+  inline: "only",
+});
+```
+
+### `installBeancount(pyodide, options)`
+Installs Beancount into an existing Pyodide runtime.
+Uses the same options as `createBeancountRuntime` (minus `pyodideBaseUrl`).
+
+### `createFileTree(pyodide, { root, cache })`
+Creates a file tree helper for the Pyodide FS. Each file entry is
+`{ name, content }` where `name` is relative to `root`.
+
+The returned helper exposes:
+- `update(files)`: incremental writes for new/changed files
+- `remove(names)`: delete files by name
+- `reset(files)`: replace the tree to match the provided list
+
+Example:
+
+```js
+import { createFileTree } from "beancount-wasm/runtime";
+
+const fileTree = createFileTree(pyodide, { root: "/work" });
+fileTree.update([{ name: "main.bean", content: "2024-01-01 open Assets:Cash" }]);
+fileTree.remove(["old.bean"]);
+fileTree.reset([{ name: "main.bean", content: "..." }]);
+```
+
+### `resolveWheelUrl({ version, wheelBaseUrl })`
+Returns the URL used for the selected wheel.
+
+### `getWheelInfo(version)`
+Returns `{ version, filename, deps }` for the selected Beancount version.
+
+## Wheel assets
+
+The wheels live under `wheels/v2/` and `wheels/v3/` within the package. When
+serving in the browser, these files must be available over HTTP unless you rely
+on the built-in inline fallback (`inline: "auto"`).
+
+## Exports
+
+This package exposes subpath exports only:
+- `beancount-wasm/runtime`
+- `beancount-wasm/v2`
+- `beancount-wasm/v3`
+- `beancount-wasm/inline/v2`
+- `beancount-wasm/inline/v3`
+
+Version-specific entry example:
+
+```js
+import { createBeancountRuntime } from "beancount-wasm/v3";
+
+const { pyodide } = await createBeancountRuntime();
+```

package/dist/chunk-COWu0jBU.js

@@ -0,0 +1,21 @@
+//#region rolldown:runtime
+var __toBinary = /* @__PURE__ */ (() => {
+	var table = new Uint8Array(128);
+	for (var i = 0; i < 64; i++) {
+		table[i < 26 ? i + 65 : i < 52 ? i + 71 : i < 62 ? i - 4 : i * 4 - 205] = i;
+	}
+	return (base64) => {
+		var n = base64.length, bytes = new Uint8Array((n - (base64[n - 1] == "=") - (base64[n - 2] == "=")) * 3 / 4 | 0);
+		for (var i = 0, j = 0; i < n;) {
+			var c0 = table[base64.charCodeAt(i++)], c1 = table[base64.charCodeAt(i++)];
+			var c2 = table[base64.charCodeAt(i++)], c3 = table[base64.charCodeAt(i++)];
+			bytes[j++] = c0 << 2 | c1 >> 4;
+			bytes[j++] = c1 << 4 | c2 >> 2;
+			bytes[j++] = c2 << 6 | c3;
+		}
+		return bytes;
+	};
+})();
+
+//#endregion
+export { __toBinary as t };

package/dist/inline/v2.d.ts

@@ -0,0 +1,6 @@
+//#region src/inline/v2.d.ts
+declare const VERSION = "v2";
+declare const FILENAME = "beancount-2.3.6-cp311-cp311-emscripten_3_1_46_wasm32.whl";
+declare function getInlineWheelBytes(): any;
+//#endregion
+export { FILENAME, VERSION, getInlineWheelBytes };