bun-webview2 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.1 — 2026-10-13
+
+- `minWidth`/`minHeight` window options: minimum window size in client
+  coordinates, enforced on user drags and programmatic `setSize` alike
+  (via the C library's sizing hints + `WM_GETMINMAXINFO`, with the window
+  frame delta compensated). One-sided limits are rejected at creation.
+
 ## 0.3.0 — 2026-10-13
 
 - Window layer replaced: hosts now drive the [C `webview` library](https://github.com/webview/webview) through `bun:ffi` — zero npm runtime dependencies. The DLL (~540 KB) is built once with `zig c++` (no MSVC, no cmake); sources and pinned WebView2 SDK headers live in the build workspace.

package/README.md

@@ -84,6 +84,7 @@ Related, and also handled for you: on a never-navigated webview target, CDP comm
 |---|---|---|---|
 | `title` | `string` | `"bun-webview2"` | Window title |
 | `width` / `height` | `number` | `800` / `600` | Initial window size |
+| `minWidth` / `minHeight` | `number` | — | Minimum window size (client coordinates); enforced on drags and `setSize` alike. Both must be set together. |
 | `url` | `string` | — | Initial URL to load |
 | `html` | `string` | — | Initial inline HTML (loaded as a `data:` URL) |
 | `contextMenu` | `boolean` | `false` | Allow the native Chromium right-click menu (blocked by default) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-webview2",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "main": "./src/index.ts",
   "module": "./src/index.ts",
   "devDependencies": {

package/src/host-ffi.ts

@@ -21,6 +21,8 @@ interface HostConfig {
   readonly title: string;
   readonly width: number;
   readonly height: number;
+  readonly minWidth?: number;
+  readonly minHeight?: number;
 }
 
 interface HostCommand {
@@ -65,6 +67,7 @@ const advapi32 = dlopen("advapi32.dll", {
 const cstr = (s: string) => ptr(Buffer.from(`${s}\0`, "utf8"));
 
 const WEBVIEW_HINT_NONE = 0;
+const WEBVIEW_HINT_MIN = 1;
 const SWP_NOSIZE = 0x0001;
 const SWP_NOMOVE = 0x0002;
 const SWP_NOZORDER = 0x0004;
@@ -232,6 +235,23 @@ const bindCallback = new JSCallback(
 
 webview.symbols.webview_set_title(handle, cstr(config.title ?? "bun-webview2"));
 webview.symbols.webview_set_size(handle, config.width ?? 800, config.height ?? 600, WEBVIEW_HINT_NONE);
+if (typeof config.minWidth === "number" && typeof config.minHeight === "number") {
+  // WEBVIEW_HINT_MIN stores m_minsz; WM_GETMINMAXINFO enforces it on drags
+  // and programmatic resizes alike. The track size is in OUTER coordinates,
+  // so the frame delta is added to keep the minimum a CLIENT-size minimum.
+  const outer = Buffer.alloc(16);
+  const inner = Buffer.alloc(16);
+  user32.symbols.GetWindowRect(hwnd, ptr(outer));
+  user32.symbols.GetClientRect(hwnd, ptr(inner));
+  const frameW = outer.readInt32LE(8) - outer.readInt32LE(0) - (inner.readInt32LE(8) - inner.readInt32LE(0));
+  const frameH = outer.readInt32LE(12) - outer.readInt32LE(4) - (inner.readInt32LE(12) - inner.readInt32LE(4));
+  webview.symbols.webview_set_size(
+    handle,
+    Math.max(1, config.minWidth + frameW),
+    Math.max(1, config.minHeight + frameH),
+    WEBVIEW_HINT_MIN,
+  );
+}
 webview.symbols.webview_bind(handle, cstr("bwv2_host_cmd"), bindCallback.ptr, null);
 
 // about:blank keeps the initial document inert; the parent drives all real

package/src/window.ts

@@ -29,6 +29,10 @@ export interface Webview2WindowOptions extends HardeningOptions {
   readonly title?: string;
   readonly width?: number;
   readonly height?: number;
+  /** Minimum window size. Both must be set together — one-sided limits are rejected. */
+  readonly minWidth?: number;
+  /** @see minWidth */
+  readonly minHeight?: number;
   /** Initial URL to load. */
   readonly url?: string;
   /** Initial inline HTML to load (delivered as a data: URL). */
@@ -123,7 +127,9 @@ class WindowHost {
   readonly #closedWaiters: Array<() => void> = [];
   readonly #eventWaiters = new Set<(event: string, payload: unknown) => void>();
 
-  constructor(readonly options: { title: string; width: number; height: number }) {
+  constructor(
+    readonly options: { title: string; width: number; height: number; minWidth?: number; minHeight?: number },
+  ) {
     const config = JSON.stringify(options);
     // Compiled executables re-run themselves instead of acting as a runtime,
     // so shipped apps point BWV2_HOST_EXE at a pre-compiled host binary.
@@ -262,11 +268,16 @@ export class Webview2Window {
         `bun-webview2: dataDir ${opts.dataDir} requested, but this app already uses ${activeDataDir}. All windows share one data folder.`,
       );
     }
+    if ((opts.minWidth !== undefined) !== (opts.minHeight !== undefined)) {
+      throw new Error("bun-webview2: minWidth and minHeight must be set together — one-sided limits are not supported.");
+    }
 
     const host = new WindowHost({
       title: opts.title ?? "bun-webview2",
       width: opts.width ?? 800,
       height: opts.height ?? 600,
+      minWidth: opts.minWidth,
+      minHeight: opts.minHeight,
     });
 
     const target: CdpTargetInfo = await waitForPageTarget(activePort, claimedTargets, 15_000, activeDataDir);