create-webview2-bridge 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ishibashi0112
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# create-webview2-bridge
+
+Scaffold a **WinForms (VB.NET / .NET Framework 4.8) + WebView2 + Vite/React** app wired with
+[webview2-bridge](https://github.com/ishibashi0112/webview2-bridge): one zod contract, generated TypeScript types and
+VB.NET DTO / Interface / Dispatcher, and a JSON-RPC bridge over `postMessage`.
+
+```sh
+pnpm create webview2-bridge my-app --name MyInventory
+# or: npm create webview2-bridge my-app -- --name MyInventory
+# or: npx create-webview2-bridge my-app --name MyInventory
+
+cd my-app
+pnpm install
+pnpm gen:check      # generated files match the bundled generator
+pnpm dev            # http://localhost:5173 in a plain browser (mock transport)
+```
+
+On Windows, run the WinForms host against the dev server:
+
+```bat
+set WEBVIEW2_BRIDGE_DEV_URL=http://localhost:5173
+dotnet run --project dotnet/MyInventory.Host
+```
+
+This is a thin alias for `webview2-bridge-gen init` from
+[`@ishibashi0112/webview2-bridge-gen`](https://www.npmjs.com/package/@ishibashi0112/webview2-bridge-gen), which
+documents the generator, the contract format and the VB.NET runtime. `--name` becomes the VB namespace and project
+names (PascalCase; defaults to the directory name). The generated README walks through the dev loop and the Windows checks.
+
+Requires Node.js 20.19+, pnpm (or npm) and, for the VB side, the .NET SDK 8+ and the WebView2 Runtime.
+
+MIT

package/dist/cli.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * `pnpm create webview2-bridge <dir> [--name <AppName>] [--force]`
+ *   = `webview2-bridge-gen init <dir> ...` の短い入口。
+ * npm / pnpm の `create` は `create-<name>` パッケージを実行する規約なので、この薄いパッケージを別名で公開している。
+ * 中身は @ishibashi0112/webview2-bridge-gen の scaffold を呼ぶだけ。
+ */
+import path from "node:path";
+import { scaffold, defaultAppName } from "@ishibashi0112/webview2-bridge-gen/generate";
+function usage() {
+    console.error(`Usage: pnpm create webview2-bridge <dir> [--name <AppName>] [--force]
+       npm  create webview2-bridge <dir> [--name <AppName>] [--force]
+
+  <dir>     新規アプリを書き出すディレクトリ
+  --name    アプリ名（PascalCase。VB の名前空間・プロジェクト名になる。既定: <dir> の名前から生成）
+  --force   <dir> にファイルがあっても書き込む`);
+    process.exit(2);
+}
+export async function main(argv) {
+    let dir;
+    let name;
+    let force = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--name")
+            name = argv[++i] ?? usage();
+        else if (a === "--force")
+            force = true;
+        else if (a === "-h" || a === "--help")
+            usage();
+        else if (a.startsWith("-")) {
+            console.error(`Unknown argument: ${a}`);
+            usage();
+        }
+        else if (dir === undefined)
+            dir = a;
+        else {
+            console.error(`Unexpected argument: ${a}`);
+            usage();
+        }
+    }
+    if (dir === undefined)
+        usage();
+    const targetDir = path.resolve(dir);
+    const appName = name ?? defaultAppName(path.basename(targetDir));
+    const result = await scaffold({ targetDir, name: appName, force });
+    console.log(result.files.map((f) => `wrote ${f}`).join("\n"));
+    console.log(`
+Created ${appName} in ${targetDir} (${result.files.length} files).
+
+Next:
+  cd ${dir}
+  pnpm install        # esbuild の postinstall 許可は pnpm-workspace.yaml に設定済み
+  pnpm gen:check      # 生成物が同梱版と一致することを確認（契約を変えたら pnpm gen）
+  pnpm dev            # http://localhost:5173 をブラウザで開く（MemoryTransport のモック）
+  # Windows: set WEBVIEW2_BRIDGE_DEV_URL=http://localhost:5173 && dotnet run --project dotnet/${appName}.Host
+
+See README.md in the new directory for the full walkthrough.`);
+    return 0;
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    // gen の GenerateError（名前不正・ディレクトリ非空）はメッセージだけ出す
+    if (err instanceof Error && err.name === "GenerateError")
+        console.error(`create-webview2-bridge: ${err.message}`);
+    else
+        console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAEvF,SAAS,KAAK;IACZ,OAAO,CAAC,KAAK,CAAC;;;;;iCAKiB,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,IAAI,GAAuB,CAAC;IAC5B,IAAI,IAAwB,CAAC;IAC7B,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,CAAC,KAAK,QAAQ;YAAE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;aAC3C,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,GAAG,IAAI,CAAC;aAClC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,EAAE,CAAC;aAC1C,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;YACxC,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS;YAAE,GAAG,GAAG,CAAC,CAAC;aACjC,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;YAC3C,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,IAAI,GAAG,KAAK,SAAS;QAAE,KAAK,EAAE,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC;UACJ,OAAO,OAAO,SAAS,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;;;OAGlD,GAAG;;;;gGAIsF,OAAO;;6DAE1C,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAY,EAAE,EAAE;IACf,+CAA+C;IAC/C,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,CAAC,KAAK,CAAC,2BAA2B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;;QAC7G,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-webview2-bridge",
+  "version": "0.3.0",
+  "description": "Scaffold a WinForms (VB.NET / .NET Framework 4.8) + WebView2 + Vite/React app wired with webview2-bridge: `pnpm create webview2-bridge my-app`",
+  "keywords": [
+    "webview2",
+    "winforms",
+    "vb.net",
+    "react",
+    "vite",
+    "scaffold",
+    "create"
+  ],
+  "license": "MIT",
+  "author": "ishibashi0112",
+  "homepage": "https://github.com/ishibashi0112/webview2-bridge#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ishibashi0112/webview2-bridge.git",
+    "directory": "packages/create"
+  },
+  "bugs": "https://github.com/ishibashi0112/webview2-bridge/issues",
+  "type": "module",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "bin": {
+    "create-webview2-bridge": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ishibashi0112/webview2-bridge-gen": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}