@tsonic/nodejs 10.0.12 → 10.0.16

package/README.md

@@ -1,6 +1,25 @@
 # @tsonic/nodejs
 
-TypeScript type definitions for the Node.js CLR library.
+Node-style APIs for **Tsonic** (TypeScript → .NET).
+
+Use `@tsonic/nodejs` when you want Node-like modules (`fs`, `path`, `events`, `crypto`, `process`, `http`, …) while still compiling to a native binary with `tsonic`.
+
+## Quick Start
+
+### New project
+
+```bash
+mkdir my-app && cd my-app
+tsonic init
+tsonic add npm @tsonic/nodejs
+npm run dev
+```
+
+### Existing project
+
+```bash
+tsonic add npm @tsonic/nodejs
+```
 
 ## Versioning
 
@@ -10,18 +29,10 @@ This repo is versioned by **.NET major**:
 
 When publishing, run: `npm publish versions/10 --access public`
 
-## Features
+## Core Modules (what you get)
 
-- **Node.js-like APIs for .NET** - fs, path, events, http, and more
-- **camelCase members** - TypeScript-friendly naming conventions
-- **Primitive aliases** - `int`, `long`, `decimal`, etc. via `@tsonic/core`
-- **Full type safety** - Complete TypeScript declarations
-
-## Installation
-
-```bash
-npm install @tsonic/nodejs @tsonic/dotnet @tsonic/core
-```
+- `fs`, `path`, `events`, `crypto`, `process`
+- `http` (separate module entrypoint)
 
 ## Usage
 
@@ -50,19 +61,51 @@ const dir = path.dirname(fullPath);
 ### Events
 
 ```typescript
-import { EventEmitter } from "@tsonic/nodejs/index.js";
+import { EventEmitter, console } from "@tsonic/nodejs/index.js";
 
 class MyEmitter extends EventEmitter {}
 const emitter = new MyEmitter();
 emitter.on("data", (chunk) => console.log(chunk));
 ```
 
+### Crypto
+
+```ts
+import { crypto } from "@tsonic/nodejs/index.js";
+
+const hash = crypto.createHash("sha256").update("hello").digest("hex");
+void hash;
+```
+
+### Process
+
+```ts
+import { process } from "@tsonic/nodejs/index.js";
+
+const cwd = process.cwd();
+void cwd;
+```
+
 ### HTTP
 
 ```typescript
 import { http } from "@tsonic/nodejs/nodejs.Http.js";
 ```
 
+## Imports (important)
+
+This is an ESM package. Import from the explicit entrypoints:
+
+- `@tsonic/nodejs/index.js` for most Node-style APIs (`fs`, `path`, `crypto`, `process`, …)
+- submodules like `@tsonic/nodejs/nodejs.Http.js` for separately emitted namespaces
+
+Node’s built-in specifiers like `node:fs` are **not** supported here.
+
+## Relationship to `@tsonic/js`
+
+- `@tsonic/js` provides JavaScript runtime APIs (JS-style `console`, `JSON`, timers, etc.)
+- `@tsonic/nodejs` provides Node-style modules (`fs`, `path`, `crypto`, `http`, etc.)
+
 ## Documentation
 
 - `docs/README.md`
@@ -70,10 +113,7 @@ import { http } from "@tsonic/nodejs/nodejs.Http.js";
 
 ## Naming Conventions
 
-- **Types**: PascalCase (matches .NET)
-- **Members**: camelCase (TypeScript convention)
-
-To generate CLR/PascalCase member names, regenerate with `--naming clr` (or omit `--naming js`).
+- `@tsonic/nodejs` intentionally uses **Node/JS-style naming** (camelCase members).
 
 ## Development
 

package/index/bindings.json

@@ -11756,26 +11756,6 @@
           "declaringClrType": "nodejs.PassThrough",
           "declaringAssemblyName": "nodejs",
           "isExtensionMethod": false
-        },
-        {
-          "stableId": "nodejs:nodejs.PassThrough::_transform(System.Object,System.String,System.Action_2):System.Void",
-          "clrName": "_transform",
-          "metadataToken": 0,
-          "canonicalSignature": "(System.Object,System.String,System.Action_2):System.Void",
-          "normalizedSignature": "_transform|(System.Object,System.String,System.Action_2):System.Void|static=false",
-          "emitScope": "ClassSurface",
-          "provenance": "BaseOverload",
-          "arity": 0,
-          "parameterCount": 3,
-          "isStatic": false,
-          "isAbstract": false,
-          "isVirtual": true,
-          "isOverride": false,
-          "isSealed": false,
-          "visibility": "Protected",
-          "declaringClrType": "nodejs.PassThrough",
-          "declaringAssemblyName": "nodejs",
-          "isExtensionMethod": false
         }
       ],
       "properties": [],
@@ -19677,46 +19657,6 @@
           "declaringClrType": "nodejs.TLSSocket",
           "declaringAssemblyName": "nodejs",
           "isExtensionMethod": false
-        },
-        {
-          "stableId": "nodejs:nodejs.TLSSocket::write(System.Byte[],System.Action_1):System.Boolean",
-          "clrName": "write",
-          "metadataToken": 0,
-          "canonicalSignature": "(System.Byte[],System.Action_1):System.Boolean",
-          "normalizedSignature": "write|(System.Byte[],System.Action_1):System.Boolean|static=false",
-          "emitScope": "ClassSurface",
-          "provenance": "BaseOverload",
-          "arity": 0,
-          "parameterCount": 2,
-          "isStatic": false,
-          "isAbstract": false,
-          "isVirtual": false,
-          "isOverride": false,
-          "isSealed": false,
-          "visibility": "Public",
-          "declaringClrType": "nodejs.TLSSocket",
-          "declaringAssemblyName": "nodejs",
-          "isExtensionMethod": false
-        },
-        {
-          "stableId": "nodejs:nodejs.TLSSocket::write(System.String,System.String,System.Action_1):System.Boolean",
-          "clrName": "write",
-          "metadataToken": 0,
-          "canonicalSignature": "(System.String,System.String,System.Action_1):System.Boolean",
-          "normalizedSignature": "write|(System.String,System.String,System.Action_1):System.Boolean|static=false",
-          "emitScope": "ClassSurface",
-          "provenance": "BaseOverload",
-          "arity": 0,
-          "parameterCount": 3,
-          "isStatic": false,
-          "isAbstract": false,
-          "isVirtual": false,
-          "isOverride": false,
-          "isSealed": false,
-          "visibility": "Public",
-          "declaringClrType": "nodejs.TLSSocket",
-          "declaringAssemblyName": "nodejs",
-          "isExtensionMethod": false
         }
       ],
       "properties": [

package/index/internal/index.d.ts

@@ -1351,7 +1351,6 @@ export interface PassThrough$instance extends Transform {
     readonly __tsonic_type_nodejs_PassThrough: never;
 
     _transform(chunk: unknown, encoding: string, callback: Action_2<Exception, unknown>): void;
-    _transform(chunk: unknown, encoding: string, callback: Action_2<Exception, unknown>): void;
 }
 
 
@@ -2313,8 +2312,6 @@ export interface TLSSocket$instance extends Socket {
     setMaxSendFragment(size: int): boolean;
     write(data: byte[], callback?: Action_1<Exception>): boolean;
     write(data: string, encoding?: string, callback?: Action_1<Exception>): boolean;
-    write(data: byte[], callback?: Action_1<Exception>): boolean;
-    write(data: string, encoding?: string, callback?: Action_1<Exception>): boolean;
 }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsonic/nodejs",
-  "version": "10.0.12",
+  "version": "10.0.16",
   "description": "TypeScript type definitions for Node.js CLR library",
   "type": "module",
   "keywords": [
@@ -19,7 +19,7 @@
     "url": "https://github.com/tsoniclang/nodejs.git"
   },
   "peerDependencies": {
-    "@tsonic/dotnet": "10.0.12",
-    "@tsonic/core": "10.0.12"
+    "@tsonic/dotnet": "10.0.16",
+    "@tsonic/core": "10.0.16"
   }
 }

package/tsonic.bindings.json

@@ -0,0 +1,10 @@
+{
+  "dotnet": {
+    "frameworkReferences": [
+      { "id": "Microsoft.AspNetCore.App", "types": "@tsonic/aspnetcore" }
+    ],
+    "packageReferences": [
+      { "id": "Tsonic.Nodejs", "version": "1.0.0", "types": "@tsonic/nodejs" }
+    ]
+  }
+}