Merge main into proxy branch (formatting and docs)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

crates/yaak-templates/build-wasm.cjs

@@ -1,8 +1,27 @@
-const { execSync } = require('node:child_process');
+const { execSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
 
-if (process.env.SKIP_WASM_BUILD === '1') {
-  console.log('Skipping wasm-pack build (SKIP_WASM_BUILD=1)');
+if (process.env.SKIP_WASM_BUILD === "1") {
+  console.log("Skipping wasm-pack build (SKIP_WASM_BUILD=1)");
   return;
 }
 
-execSync('wasm-pack build --target bundler', { stdio: 'inherit' });
+execSync("wasm-pack build --target bundler", { stdio: "inherit" });
+
+// Rewrite the generated entry to use Vite's ?init import style instead of
+// the ES Module Integration style that wasm-pack generates, which Vite/rolldown
+// does not support in production builds.
+const entry = path.join(__dirname, "pkg", "yaak_templates.js");
+fs.writeFileSync(
+  entry,
+  [
+    'import init from "./yaak_templates_bg.wasm?init";',
+    'export * from "./yaak_templates_bg.js";',
+    'import * as bg from "./yaak_templates_bg.js";',
+    'const instance = await init({ "./yaak_templates_bg.js": bg });',
+    "bg.__wbg_set_wasm(instance.exports);",
+    "instance.exports.__wbindgen_start();",
+    "",
+  ].join("\n"),
+);

crates/yaak-templates/index.ts

@@ -1,6 +1,6 @@
-export * from './bindings/parser';
-import { Tokens } from './bindings/parser';
-import { escape_template, parse_template, unescape_template } from './pkg';
+export * from "./bindings/parser";
+import { Tokens } from "./bindings/parser";
+import { escape_template, parse_template, unescape_template } from "./pkg";
 
 export function parseTemplate(template: string) {
   return parse_template(template) as Tokens;

crates/yaak-templates/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yaakapp-internal/templates",
-  "private": true,
   "version": "1.0.0",
+  "private": true,
   "main": "index.ts",
   "scripts": {
     "bootstrap": "npm run build",

crates/yaak-templates/pkg/yaak_templates.js

@@ -1,5 +1,6 @@
-import * as wasm from "./yaak_templates_bg.wasm";
+import init from "./yaak_templates_bg.wasm?init";
 export * from "./yaak_templates_bg.js";
-import { __wbg_set_wasm } from "./yaak_templates_bg.js";
-__wbg_set_wasm(wasm);
-wasm.__wbindgen_start();
+import * as bg from "./yaak_templates_bg.js";
+const instance = await init({ "./yaak_templates_bg.js": bg });
+bg.__wbg_set_wasm(instance.exports);
+instance.exports.__wbindgen_start();