@ishibashi0112/webview2-bridge-gen 0.2.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,133 @@
+# @ishibashi0112/webview2-bridge-gen
+
+Code generator for [webview2-bridge](https://github.com/ishibashi0112/webview2-bridge):
+write the contract between a Vite/React UI and a VB.NET WinForms (.NET Framework 4.8) host **once**, in [zod](https://zod.dev),
+and generate both sides.
+
+```
+contract.ts (zod)  ──>  contract.schema.json  ──>  contract-types.ts   (TypeScript, for the UI)
+                                               └─>  Dto.vb / Interfaces.vb / Dispatcher.Generated.vb / Events.vb   (VB.NET)
+```
+
+The front-end runtime is [`@ishibashi0112/webview2-bridge-client`](https://www.npmjs.com/package/@ishibashi0112/webview2-bridge-client);
+the VB.NET runtime is the NuGet package `WebView2Bridge.Runtime` (plus `WebView2Bridge.WinForms` for the host).
+
+## Install
+
+```sh
+pnpm add -D @ishibashi0112/webview2-bridge-gen zod
+```
+
+Requires Node.js 20.19+ and zod 4.
+
+## Define the contract
+
+```ts
+// contract/contract.ts
+import { z } from "zod";
+import { defineContract } from "@ishibashi0112/webview2-bridge-gen";
+
+// Give shared objects / enums a name with .meta({ id }) — it becomes the VB class name and the TS type name
+const Part = z
+  .object({ partNo: z.string(), name: z.string(), qty: z.number().int(), updatedAt: z.string() })
+  .meta({ id: "Part" });
+
+export const contract = defineContract({
+  methods: {
+    parts: {
+      search: {
+        input: z.object({ keyword: z.string().min(1), limit: z.number().int().optional() }),
+        output: z.object({ items: z.array(Part) }),
+      },
+    },
+  },
+  events: {
+    progress: z.object({ percent: z.number(), message: z.string().optional() }),
+  },
+});
+export type Contract = typeof contract;
+```
+
+## Configure and run
+
+```jsonc
+// webview2-bridge.gen.json (repository root)
+{
+  "contract": "contract/contract.ts",
+  "schemaOut": "contract/contract.schema.json",
+  "ts": { "outDir": "apps/web/src/generated", "contractImport": "@webview2-bridge/contract" },
+  "vb": { "outDir": "dotnet/MyApp.Contract/Generated", "namespace": "MyApp.Contract" }
+}
+```
+
+```sh
+webview2-bridge-gen            # generate (uses ./webview2-bridge.gen.json)
+webview2-bridge-gen --check    # CI: exit 1 if the generated files are out of date
+webview2-bridge-gen --config path/to/config.json
+```
+
+Generated files start with an `<auto-generated>` header; the generator only overwrites / removes files carrying that header.
+Commit the generated files.
+
+## What is generated
+
+**TypeScript** (`contract-types.ts`): `PartsSearchInput` / `PartsSearchOutput`, `ProgressEvent`, named types (`Part`),
+`MethodMap` / `EventMap`, `methodNames` / `eventNames`. Types are derived from the zod contract with `z.input` / `z.output`.
+
+**VB.NET** (into `Namespace Global.<namespace>`, referencing the `WebView2Bridge.Runtime` NuGet package):
+
+| File | Content |
+|---|---|
+| `Dto.vb` | one `Public Class` per object with `<JsonProperty("camelCase")>`; string enums as `NotInheritable Class` with `Public Const` |
+| `Interfaces.vb` | `Public Interface IPartsApi` with `Function Search(req As PartsSearchRequest) As Task(Of PartsSearchResponse)` |
+| `Dispatcher.Generated.vb` | `DispatcherExtensions.Register(dispatcher, api)` extension methods wiring `"parts.search"` to `IPartsApi.Search` |
+| `Events.vb` | `BridgeEvents` with `Sub Progress(payload As ProgressEvent)` emitting `"event.progress"` |
+
+Type mapping: `string`→`String`, `number`→`Double`, `int`→`Integer` (`.meta({ format: "int64" })`→`Long`), `boolean`→`Boolean`,
+`array`→`List(Of T)`, `record`→`Dictionary(Of String, T)`, `unknown`→`JToken`, `X | null`→nullable, optional value types→`Nullable(Of T)`.
+Optional properties get `NullValueHandling.Ignore` so `Nothing` is omitted from JSON (zod `.optional()` rejects `null`).
+Unions, intersections, dates and bigints are rejected with a clear error.
+
+Naming: `.meta({ id })` wins; otherwise `<Namespace><Method>Request` / `Response`, `<Event>Event`,
+nested objects `<Owner><Prop>`, array items singularized (`items` → `Item`).
+
+## VB runtime without NuGet
+
+The VB.NET runtime (`Dispatcher`, `JsonRpc`, `IBridgeEmitter`) and the WinForms glue (`WebViewBridge`) are bundled
+in this package. Point `vb.runtime.outDir` / `vb.winforms.outDir` at your projects and the generator writes them as
+auto-generated files, so **no custom NuGet package is needed** — your Contract project only references `Newtonsoft.Json`
+and your Host only `Microsoft.Web.WebView2`.
+
+```jsonc
+"vb": {
+  "outDir": "dotnet/MyApp.Contract/Generated",
+  "namespace": "MyApp.Contract",
+  "runtime":  { "outDir": "dotnet/MyApp.Contract/Runtime" },
+  "winforms": { "outDir": "dotnet/MyApp.Host/Bridge" }
+}
+```
+
+The files keep the namespaces `WebView2Bridge.Runtime` / `WebView2Bridge.WinForms`, so the code you write is identical
+whether the runtime comes from these files or from the NuGet packages of the same name. Upgrading the runtime = upgrading
+this npm package and running the generator again (`--check` reports outdated copies).
+
+## Options (`vb`)
+
+| Option | Default | Meaning |
+|---|---|---|
+| `namespace` | required | namespace of the generated code |
+| `runtimeNamespace` | `WebView2Bridge.Runtime` | namespace of `Dispatcher` / `IBridgeEmitter` (NuGet `WebView2Bridge.Runtime`) |
+| `dispatcherClass` | `Dispatcher` | runtime dispatcher class name |
+| `eventsClass` | `BridgeEvents` | generated events helper class name |
+| `emitterInterface` | `IBridgeEmitter` | runtime emitter interface name |
+| `runtime.outDir` | — | write the bundled VB runtime (3 files) here; omit when using the NuGet package or a ProjectReference |
+| `winforms.outDir` | — | write the bundled `WebViewBridge.vb` here; omit when using the NuGet package or a ProjectReference |
+
+## Programmatic use
+
+```ts
+import { defineContract, toSchema, emitTs, emitVb } from "@ishibashi0112/webview2-bridge-gen";
+import { generate, emitVbRuntime } from "@ishibashi0112/webview2-bridge-gen/generate"; // Node only (fs)
+```
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { generate } from "./generate.js";
+import { GenerateError } from "./schema.js";
+const DEFAULT_CONFIG = "webview2-bridge.gen.json";
+function usage() {
+    console.error(`Usage: webview2-bridge-gen [--config <file>] [--cwd <dir>] [--check]
+
+  --config  設定ファイル（既定: ./${DEFAULT_CONFIG}）
+  --cwd     設定ファイル内の相対パスの基準（既定: 設定ファイルのあるディレクトリ）
+  --check   書き込まず、生成物が最新かだけを確認する（差分があれば exit 1）`);
+    process.exit(2);
+}
+async function main(argv) {
+    let configPath = DEFAULT_CONFIG;
+    let cwd;
+    let check = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--config")
+            configPath = argv[++i] ?? usage();
+        else if (a === "--cwd")
+            cwd = argv[++i] ?? usage();
+        else if (a === "--check")
+            check = true;
+        else if (a === "-h" || a === "--help")
+            usage();
+        else {
+            console.error(`Unknown argument: ${a}`);
+            usage();
+        }
+    }
+    const absConfig = path.resolve(configPath);
+    const config = JSON.parse(await readFile(absConfig, "utf8"));
+    const base = cwd ? path.resolve(cwd) : path.dirname(absConfig);
+    const result = await generate(config, { cwd: base, check });
+    const rel = (p) => path.relative(base, p);
+    if (check) {
+        if (result.stale.length > 0) {
+            console.error("Generated files are out of date:\n" + result.stale.map((f) => `  ${rel(f)}`).join("\n"));
+            console.error("Run `pnpm gen`.");
+            return 1;
+        }
+        console.log(`Up to date (${result.files.length} files).`);
+        return 0;
+    }
+    console.log(result.files.map((f) => `wrote ${rel(f)}`).join("\n"));
+    return 0;
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    if (err instanceof GenerateError) {
+        console.error(`webview2-bridge-gen: ${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":"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"}

package/dist/define.d.ts

@@ -0,0 +1,19 @@
+import type { z } from "zod";
+/** 1 メソッド: 入力と出力の zod スキーマ */
+export interface MethodDef {
+    input: z.ZodType;
+    output: z.ZodType;
+}
+/** namespace → method 名 → MethodDef */
+export type NamespaceDef = Record<string, MethodDef>;
+/** 契約全体の形。`methods.<namespace>.<name>` と `events.<name>` */
+export interface ContractDef {
+    methods: Record<string, NamespaceDef>;
+    events: Record<string, z.ZodType>;
+}
+/**
+ * 契約を定義する。型を保持して返すだけの identity 関数。
+ * 実行時の検証・変換は行わない（ジェネレータと client が型パラメータとして受ける）。
+ */
+export declare function defineContract<const C extends ContractDef>(contract: C): C;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAErD,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAE1E"}

package/dist/define.js

@@ -0,0 +1,8 @@
+/**
+ * 契約を定義する。型を保持して返すだけの identity 関数。
+ * 実行時の検証・変換は行わない（ジェネレータと client が型パラメータとして受ける）。
+ */
+export function defineContract(contract) {
+    return contract;
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAA8B,QAAW;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/emit-ts.d.ts

@@ -0,0 +1,15 @@
+import { type ContractSchema } from "./schema.js";
+import type { EmittedFile } from "./emitted.js";
+export interface EmitTsOptions {
+    /** 契約モジュールの import 指定子（例: "@webview2-bridge/contract"） */
+    contractImport: string;
+    /** 契約モジュールが export している名前 */
+    contractExport?: string;
+}
+/**
+ * contract.schema.json → contract-types.ts
+ * 型は zod 契約から `z.input` / `z.output` で引く（JSON Schema から型を再構築しない）。
+ * JSON Schema は「どのメソッド・イベント・$defs があるか」と、$defs へ到達する経路の決定に使う。
+ */
+export declare function emitTs(schema: ContractSchema, options: EmitTsOptions): EmittedFile[];
+//# sourceMappingURL=emit-ts.d.ts.map

package/dist/emit-ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-ts.d.ts","sourceRoot":"","sources":["../src/emit-ts.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE,CAqEpF"}

package/dist/emit-ts.js

@@ -0,0 +1,113 @@
+import { isTsReserved, pascalCase } from "./naming.js";
+import { GenerateError, refName } from "./schema.js";
+/**
+ * contract.schema.json → contract-types.ts
+ * 型は zod 契約から `z.input` / `z.output` で引く（JSON Schema から型を再構築しない）。
+ * JSON Schema は「どのメソッド・イベント・$defs があるか」と、$defs へ到達する経路の決定に使う。
+ */
+export function emitTs(schema, options) {
+    const exportName = options.contractExport ?? "contract";
+    const out = [];
+    out.push("// <auto-generated>");
+    out.push("//     This code was generated by @ishibashi0112/webview2-bridge-gen from contract.schema.json.");
+    out.push("//     DO NOT EDIT. Changes will be lost when `pnpm gen` runs.");
+    out.push("// </auto-generated>");
+    out.push('import type { z } from "zod";');
+    out.push(`import type { ${exportName} } from ${JSON.stringify(options.contractImport)};`);
+    out.push("");
+    out.push(`type C = typeof ${exportName};`);
+    out.push("");
+    const methodEntries = [];
+    const defPaths = new Map();
+    out.push("// ---- methods");
+    for (const [ns, methods] of Object.entries(schema.methods)) {
+        for (const [name, m] of Object.entries(methods)) {
+            const base = `${pascalCase(ns)}${pascalCase(name)}`;
+            const access = `C["methods"][${JSON.stringify(ns)}][${JSON.stringify(name)}]`;
+            const inputName = `${base}Input`;
+            const outputName = `${base}Output`;
+            out.push(`/** \`${ns}.${name}\` の入力 */`);
+            out.push(`export type ${inputName} = z.input<${access}["input"]>;`);
+            out.push(`/** \`${ns}.${name}\` の出力 */`);
+            out.push(`export type ${outputName} = z.output<${access}["output"]>;`);
+            methodEntries.push({ rpcName: `${ns}.${name}`, input: inputName, output: outputName });
+            collectDefPaths(m.input, inputName, `methods.${ns}.${name}.input`, defPaths, schema.$defs);
+            collectDefPaths(m.output, outputName, `methods.${ns}.${name}.output`, defPaths, schema.$defs);
+        }
+    }
+    out.push("");
+    out.push("// ---- events");
+    const eventEntries = [];
+    for (const [name, e] of Object.entries(schema.events)) {
+        const typeName = `${pascalCase(name)}Event`;
+        out.push(`/** \`event.${name}\` のペイロード */`);
+        out.push(`export type ${typeName} = z.output<C["events"][${JSON.stringify(name)}]>;`);
+        eventEntries.push({ name, type: typeName });
+        collectDefPaths(e, typeName, `events.${name}`, defPaths, schema.$defs);
+    }
+    out.push("");
+    out.push("// ---- named types (.meta({ id }))");
+    for (const id of Object.keys(schema.$defs)) {
+        const p = defPaths.get(id);
+        if (!p) {
+            throw new GenerateError(`$defs "${id}" is not referenced from any method or event`, `$defs.${id}`);
+        }
+        if (isTsReserved(id))
+            throw new GenerateError(`meta id "${id}" is a reserved word in TypeScript`, `$defs.${id}`);
+        out.push(`export type ${id} = ${p};`);
+    }
+    out.push("");
+    out.push("// ---- maps");
+    out.push("export interface MethodMap {");
+    for (const m of methodEntries) {
+        out.push(`  ${JSON.stringify(m.rpcName)}: { input: ${m.input}; output: ${m.output} };`);
+    }
+    out.push("}");
+    out.push("export interface EventMap {");
+    for (const e of eventEntries) {
+        out.push(`  ${JSON.stringify(e.name)}: ${e.type};`);
+    }
+    out.push("}");
+    out.push("export type MethodName = keyof MethodMap;");
+    out.push("export type EventName = keyof EventMap;");
+    out.push(`export const methodNames = [${methodEntries.map((m) => JSON.stringify(m.rpcName)).join(", ")}] as const;`);
+    out.push(`export const eventNames = [${eventEntries.map((e) => JSON.stringify(e.name)).join(", ")}] as const;`);
+    return [{ path: "contract-types.ts", content: out.join("\n") + "\n" }];
+}
+/**
+ * `$ref` に最初に到達した経路を TS の indexed access 型として記録する。
+ * 例: PartsSearchOutput["items"][number]
+ */
+function collectDefPaths(s, rootExpr, path, acc, defs) {
+    const visit = (node, expr, viaOptional, p) => {
+        if (node.$ref) {
+            const id = refName(node.$ref);
+            if (acc.has(id))
+                return;
+            acc.set(id, viaOptional ? `NonNullable<${expr}>` : expr);
+            // $defs の中で参照される $defs は、その名前付き型を起点に辿る（例: Address = NonNullable<Customer["address"]>）
+            const def = defs[id];
+            if (def)
+                visit(def, id, false, `$defs.${id}`);
+            return;
+        }
+        const nullable = (Array.isArray(node.type) && node.type.includes("null")) ||
+            Boolean((node.anyOf ?? node.oneOf)?.some((u) => u.type === "null"));
+        const union = (node.anyOf ?? node.oneOf)?.filter((u) => u.type !== "null");
+        if (union && union.length === 1) {
+            visit(union[0], expr, viaOptional || nullable, p);
+            return;
+        }
+        const required = new Set(node.required ?? []);
+        for (const [name, child] of Object.entries(node.properties ?? {})) {
+            visit(child, `${expr}[${JSON.stringify(name)}]`, viaOptional || nullable || !required.has(name), `${p}.${name}`);
+        }
+        if (node.items)
+            visit(node.items, `${expr}[number]`, viaOptional || nullable, `${p}[]`);
+        if (typeof node.additionalProperties === "object") {
+            visit(node.additionalProperties, `${expr}[string]`, viaOptional || nullable, `${p}.*`);
+        }
+    };
+    visit(s, rootExpr, false, path);
+}
+//# sourceMappingURL=emit-ts.js.map

package/dist/emit-ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-ts.js","sourceRoot":"","sources":["../src/emit-ts.ts"],"names":[],"mappings":"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"}

package/dist/emit-vb.d.ts

@@ -0,0 +1,22 @@
+import { type ContractSchema } from "./schema.js";
+import type { EmittedFile } from "./emitted.js";
+export interface EmitVbOptions {
+    /** 生成物を置く名前空間（`Namespace Global.<namespace>`）。RootNamespace とは独立 */
+    namespace: string;
+    /** 手書き側と Partial で結合する Dispatcher クラス名 */
+    dispatcherClass?: string;
+    /** 型付きイベント発行ヘルパのクラス名 */
+    eventsClass?: string;
+    /** IBridgeEmitter の名前（手書きランタイム側の Interface） */
+    emitterInterface?: string;
+    /**
+     * ランタイム（Dispatcher / IBridgeEmitter）の名前空間。NuGet パッケージ WebView2Bridge.Runtime の既定は
+     * `WebView2Bridge.Runtime`。生成される Dispatcher 拡張と Events はこれを Imports する
+     */
+    runtimeNamespace?: string;
+}
+/**
+ * contract.schema.json → VB.NET ソース（Dto.vb / Interfaces.vb / Dispatcher.Generated.vb / Events.vb）
+ */
+export declare function emitVb(schema: ContractSchema, options: EmitVbOptions): EmittedFile[];
+//# sourceMappingURL=emit-vb.d.ts.map

package/dist/emit-vb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-vb.d.ts","sourceRoot":"","sources":["../src/emit-vb.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAyDD;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE,CASpF"}