@tsonic/tsbindgen 0.7.51 → 0.7.53

package/README.md

@@ -10,6 +10,7 @@ tsbindgen generates TypeScript declaration files (`.d.ts`) from .NET assemblies
 - **Zero TypeScript errors** - Output validates cleanly with `tsc --strict`
 - **Nullable reference types** - NRT support for output positions (returns, properties, fields)
 - **CLR primitives** - Numeric type aliases (`int`, `long`, `decimal`, etc.) via `@tsonic/core`
+- **Broad CLR object safety** - `System.Object` projects to TypeScript `unknown`, and value-type constraints project to `NonNullable<unknown>`
 - **CLR-faithful names** - No casing transforms; member names match the CLR surface
 - **Generic type preservation** - Full generic type parameter support with constraints
 - **Unified bindings manifest** - CLR-specific information lives in `<Namespace>/bindings.json` (no metadata sidecars)
@@ -42,12 +43,14 @@ dotnet build src/tsbindgen/tsbindgen.csproj
 ### Generate BCL declarations
 
 ```bash
+DOTNET_RUNTIME=$(dirname "$(dotnet --list-runtimes | awk '/Microsoft.NETCore.App 10\\./ { print $3; exit }')")
+
 # Via npm
-npx tsbindgen generate -d ~/.dotnet/shared/Microsoft.NETCore.App/10.0.0 -o ./output
+npx tsbindgen generate -d "$DOTNET_RUNTIME" -o ./output
 
 # Via dotnet (from source)
 dotnet run --project src/tsbindgen/tsbindgen.csproj -- \
-  generate -d ~/.dotnet/shared/Microsoft.NETCore.App/10.0.0 -o ./output
+  generate -d "$DOTNET_RUNTIME" -o ./output
 ```
 
 ### Generate for a custom assembly
@@ -113,6 +116,8 @@ npx tsbindgen generate -a ./MyLibrary.dll -d $DOTNET_RUNTIME -o ./my-lib \
 Machine-readable dependency resolution for one or more seed assemblies. Useful for:
 - Debugging missing dependencies before generation
 - Tooling integrations (e.g. build systems) that need deterministic closure resolution
+- Source builds and tests that should resolve the installed .NET runtime without
+  assuming a fixed install directory
 
 ```bash
 # Standard SDK/runtime installs usually work with no extra ref dirs
@@ -124,6 +129,16 @@ npx tsbindgen resolve-closure \
   --ref-dir ./libs
 ```
 
+## .NET runtime discovery
+
+Repo-local test scripts discover the installed `Microsoft.NETCore.App` runtime
+through `dotnet --list-runtimes`. Set `DOTNET_RUNTIME` to override the runtime
+assembly directory explicitly.
+
+Surface-manifest validation is tied to the runtime assembly version. If the
+runtime version and baseline manifest do not match, the validator reports that
+version mismatch directly.
+
 ### Examples
 
 ```bash
@@ -244,6 +259,12 @@ CLR primitive types map to type aliases from `@tsonic/core`:
 | `System.Boolean` | `bool` (branded) |
 | `System.String` | `string` |
 | `System.Char` | `char` (branded) |
+| `System.Object` | `unknown` |
+| `System.ValueType` constraint | `NonNullable<unknown>` |
+
+`unknown` is intentional: it is the TypeScript boundary type for a broad CLR
+object slot. Generated packages do not import a package-specific catch-all value
+type for `System.Object`; callers narrow or adapt broad values explicitly.
 
 ### Generic Types
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsonic/tsbindgen",
-  "version": "0.7.51",
+  "version": "0.7.53",
   "description": "Generate TypeScript declarations from .NET assemblies",
   "type": "module",
   "bin": {
@@ -18,9 +18,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "dotnet publish src/tsbindgen/tsbindgen.csproj -c Release -o lib/",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run build"
+    "build": "dotnet publish src/tsbindgen/tsbindgen.csproj -c Release -o lib/"
   },
   "keywords": [
     "tsonic",