@tsonic/js 10.0.26 → 10.0.31

package/README.md

@@ -1,31 +1,47 @@
 # @tsonic/js
 
-JavaScript-style APIs for **Tsonic** (TypeScript → .NET).
+JavaScript-style APIs for **Tsonic**.
+
+This package is part of Tsonic: https://tsonic.org.
 
 Use `@tsonic/js` when you want a JS-like standard library (`console`, `JSON`, `Map`, `Set`, `Date`, timers, etc.) while still compiling to a native binary with `tsonic`.
 
-## Quick Start
+## Prerequisites
 
-### New project
+- Install the .NET 10 SDK (required by Tsonic): https://dotnet.microsoft.com/download
+- Verify: `dotnet --version`
+
+## Quick Start
 
 ```bash
 mkdir my-app && cd my-app
-tsonic init
-tsonic add npm @tsonic/js
+npx --yes tsonic@latest init
+npx --yes tsonic@latest add npm @tsonic/js
+
+# Replace the default App.ts with a JSRuntime example
+cat > packages/my-app/src/App.ts <<'EOF'
+import { console, JSON } from "@tsonic/js/index.js";
+
+export function main(): void {
+  const value = JSON.parse<{ x: number }>('{"x": 1}');
+  console.log(JSON.stringify(value));
+}
+EOF
+
 npm run dev
 ```
 
-### Existing project
+## Existing project
 
 ```bash
-tsonic add npm @tsonic/js
+npx --yes tsonic@latest add npm @tsonic/js
 ```
 
 ## Versioning
 
-This repo is versioned by **.NET major**:
+This repo is versioned by runtime major:
 
-- **.NET 10** → `versions/10/` → npm: `@tsonic/js@10.x`
+- `10` → `versions/10/` → npm: `@tsonic/js@10.x`
 
 When publishing, run: `npm publish versions/10 --access public`
 
@@ -95,22 +111,7 @@ If you want Node-style modules (`fs`, `path`, `crypto`, `http`, …), use `@tson
 
 ## Development
 
-### Regenerating Types
-
-To regenerate TypeScript declarations:
-
-```bash
-./__build/scripts/generate.sh
-```
-
-**Prerequisites:**
-- .NET 10 SDK installed
-- `tsbindgen` repository at `../tsbindgen`
-- `js-runtime` repository at `../js-runtime` (built with `dotnet build -c Release`)
-
-**Environment variables:**
-- `DOTNET_VERSION` - .NET runtime version (default: `10.0.0`)
-- `DOTNET_HOME` - .NET installation directory (default: `$HOME/.dotnet`)
+See `__build/` for regeneration scripts.
 
 ## License
 

package/__internal/extensions/index.d.ts

@@ -62,9 +62,9 @@ export interface __Ext_Tsonic_JSRuntime_String {
 
 // Internal helper types for sticky extension scopes
 type __TsonicExtMapOf<T> = T extends { __tsonic_ext?: infer M } ? M : {};
-type __TsonicMergeExtMaps<A, B> = Omit<A, keyof B> & B;
+type __TsonicMergeExtMaps<A, B> = A & B;
 type __TsonicWithExt<TShape, K extends string, TApplier> = { __tsonic_ext?: __TsonicMergeExtMaps<__TsonicExtMapOf<TShape>, { [P in K]: TApplier }> };
-type __TsonicPreferExt<A, B> = Omit<A, keyof B> & B;
+type __TsonicPreferExt<A, B> = A & B;
 
 // Generic helper type for extension methods in namespace: Tsonic.JSRuntime
 type __TsonicExtSurface_Tsonic_JSRuntime<TShape> =

package/index.d.ts

@@ -8,9 +8,6 @@ import * as Internal from './index/internal/index.js';
 // Primitive type aliases for flattened exports
 import type { sbyte, byte, short, ushort, int, uint, long, ulong, int128, uint128, half, float, double, decimal, nint, nuint, char } from '@tsonic/core/types.js';
 
-// Namespace imports for flattened exports
-import * as System_Internal from "@tsonic/dotnet/System.js";
-
 // Cross-namespace type imports for constraints
 import type { IEnumerable as IEnumerable__System_Collections_Generic, IEnumerator, KeyValuePair, List } from '@tsonic/dotnet/System.Collections.Generic.js';
 import type { IEnumerable } from '@tsonic/dotnet/System.Collections.js';
@@ -57,7 +54,7 @@ export declare function isFinite(value: double): boolean;
 export declare function isNaN(value: double): boolean;
 export declare function Number(value: unknown): double;
 export declare function parseFloat(str: string): double;
-export declare function parseInt(str: string, radix?: Nullable<System_Internal.Int32>): Nullable<System_Internal.Int64>;
+export declare function parseInt(str: string, radix?: Nullable<int>): Nullable<long>;
 export declare function String(value: unknown): string;
 export declare const Infinity: double;
 export declare const NaN: double;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsonic/js",
-  "version": "10.0.26",
+  "version": "10.0.31",
   "description": "TypeScript type definitions for JavaScript Runtime (JSRuntime) library",
   "type": "module",
   "keywords": [
@@ -20,7 +20,7 @@
     "url": "https://github.com/tsoniclang/js.git"
   },
   "peerDependencies": {
-    "@tsonic/dotnet": "10.0.26",
-    "@tsonic/core": "10.0.26"
+    "@tsonic/dotnet": "10.0.31",
+    "@tsonic/core": "10.0.31"
   }
 }