@tsonic/nodejs 10.0.37 → 10.0.39

package/README.md

@@ -15,18 +15,22 @@ Use `@tsonic/nodejs` when you want Node-like modules (`fs`, `path`, `events`, `c
 
 ```bash
 mkdir my-app && cd my-app
-npx --yes tsonic@latest init
+npx --yes tsonic@latest init --surface nodejs
 npx --yes tsonic@latest add npm @tsonic/nodejs
+```
 
-# Replace the default App.ts with a Node.js-style example
-cat > packages/my-app/src/App.ts <<'EOF'
-import { console, path } from "@tsonic/nodejs/index.js";
+```ts
+import { join } from "node:path";
+import { readFileSync } from "node:fs";
 
 export function main(): void {
-  console.log(path.posix.join("a", "b", "c"));
+  const fullPath = join("src", "App.ts");
+  console.log(fullPath);
+  console.log(readFileSync(fullPath, "utf-8"));
 }
-EOF
+```
 
+```bash
 npm run dev
 ```
 
@@ -36,6 +40,12 @@ npm run dev
 npx --yes tsonic@latest add npm @tsonic/nodejs
 ```
 
+If the workspace is not already Node surface, set:
+
+```bash
+npx --yes tsonic@latest init --surface nodejs
+```
+
 ## Versioning
 
 This repo is versioned by runtime major:
@@ -51,32 +61,29 @@ When publishing, run: `npm publish versions/10 --access public`
 
 ## Usage
 
-### File System
+### File System (`node:fs`)
 
 ```typescript
-import { fs } from "@tsonic/nodejs/index.js";
-
-// Read file
-const content = fs.readFileSync("./package.json", "utf-8");
+import { readFileSync, writeFileSync } from "node:fs";
 
-// Write file
-fs.writeFileSync("./output.txt", "Hello from Tsonic!");
+const content = readFileSync("./package.json", "utf-8");
+writeFileSync("./output.txt", "Hello from Tsonic!");
 ```
 
-### Path Operations
+### Path Operations (`node:path`)
 
 ```typescript
-import { path } from "@tsonic/nodejs/index.js";
+import { join, extname, dirname } from "node:path";
 
-const fullPath = path.join("config", "settings.json");
-const ext = path.extname(fullPath);  // ".json"
-const dir = path.dirname(fullPath);
+const fullPath = join("config", "settings.json");
+const ext = extname(fullPath);  // ".json"
+const dir = dirname(fullPath);
 ```
 
 ### Events
 
 ```typescript
-import { EventEmitter, console } from "@tsonic/nodejs/index.js";
+import { EventEmitter } from "@tsonic/nodejs/index.js";
 
 class MyEmitter extends EventEmitter {}
 const emitter = new MyEmitter();
@@ -86,16 +93,16 @@ emitter.on("data", (chunk) => console.log(chunk));
 ### Crypto
 
 ```ts
-import { crypto } from "@tsonic/nodejs/index.js";
+import { randomUUID } from "node:crypto";
 
-const hash = crypto.createHash("sha256").update("hello").digest("hex");
-void hash;
+const id = randomUUID();
+void id;
 ```
 
 ### Process
 
 ```ts
-import { process } from "@tsonic/nodejs/index.js";
+import * as process from "node:process";
 
 const cwd = process.cwd();
 void cwd;
@@ -109,12 +116,16 @@ import { http } from "@tsonic/nodejs/nodejs.Http.js";
 
 ## Imports (important)
 
-This is an ESM package. Import from the explicit entrypoints:
+For `--surface nodejs` projects, prefer Node-style imports:
+
+- `node:fs`, `node:path`, `node:crypto`, `node:process`, ...
+- bare aliases (`fs`, `path`, `crypto`, ...) are also supported
+
+Direct ESM imports from `@tsonic/nodejs/index.js` are still supported.
 
-- `@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:http` is currently not mapped by the surface alias set; use:
 
-Node’s built-in specifiers like `node:fs` are **not** supported here.
+- `@tsonic/nodejs/nodejs.Http.js`
 
 ## Relationship to `@tsonic/js`
 

package/bindings.json

@@ -0,0 +1,204 @@
+{
+  "bindings": {
+    "node:assert": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.assert"
+    },
+    "assert": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.assert"
+    },
+    "node:buffer": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.buffer"
+    },
+    "buffer": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.buffer"
+    },
+    "node:child_process": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.child_process"
+    },
+    "child_process": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.child_process"
+    },
+    "node:crypto": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.crypto"
+    },
+    "crypto": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.crypto"
+    },
+    "node:dgram": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.dgram"
+    },
+    "dgram": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.dgram"
+    },
+    "node:dns": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.dns"
+    },
+    "dns": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.dns"
+    },
+    "node:events": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.events"
+    },
+    "events": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.events"
+    },
+    "node:fs": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.fs"
+    },
+    "fs": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.fs"
+    },
+    "node:net": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.net"
+    },
+    "net": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.net"
+    },
+    "node:os": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.os"
+    },
+    "os": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.os"
+    },
+    "node:path": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.path"
+    },
+    "path": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.path"
+    },
+    "node:process": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.process"
+    },
+    "process": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.process"
+    },
+    "node:querystring": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.querystring"
+    },
+    "querystring": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.querystring"
+    },
+    "node:readline": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.readline"
+    },
+    "readline": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.readline"
+    },
+    "node:stream": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.stream"
+    },
+    "stream": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.stream"
+    },
+    "node:timers": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.timers"
+    },
+    "timers": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.timers"
+    },
+    "node:tls": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.tls"
+    },
+    "tls": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.tls"
+    },
+    "node:url": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.url"
+    },
+    "url": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.url"
+    },
+    "node:util": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.util"
+    },
+    "util": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.util"
+    },
+    "node:zlib": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.zlib"
+    },
+    "zlib": {
+      "kind": "module",
+      "assembly": "nodejs",
+      "type": "nodejs.zlib"
+    }
+  }
+}

package/node-aliases.d.ts

@@ -0,0 +1,133 @@
+declare module "node:assert" {
+  export { assert } from "@tsonic/nodejs/index.js";
+}
+declare module "assert" {
+  export { assert } from "@tsonic/nodejs/index.js";
+}
+declare module "node:buffer" {
+  export { buffer } from "@tsonic/nodejs/index.js";
+}
+declare module "buffer" {
+  export { buffer } from "@tsonic/nodejs/index.js";
+}
+declare module "node:child_process" {
+  export { child_process } from "@tsonic/nodejs/index.js";
+}
+declare module "child_process" {
+  export { child_process } from "@tsonic/nodejs/index.js";
+}
+declare module "node:fs" {
+  export { fs } from "@tsonic/nodejs/index.js";
+  export const existsSync: typeof import("@tsonic/nodejs/index.js").fs.existsSync;
+  export const readFileSync: typeof import("@tsonic/nodejs/index.js").fs.readFileSync;
+  export const mkdirSync: typeof import("@tsonic/nodejs/index.js").fs.mkdirSync;
+}
+declare module "fs" {
+  export { fs } from "@tsonic/nodejs/index.js";
+}
+declare module "node:path" {
+  export { path } from "@tsonic/nodejs/index.js";
+  export const join: typeof import("@tsonic/nodejs/index.js").path.join;
+  export const extname: typeof import("@tsonic/nodejs/index.js").path.extname;
+  export const basename: typeof import("@tsonic/nodejs/index.js").path.basename;
+  export const dirname: typeof import("@tsonic/nodejs/index.js").path.dirname;
+  export const parse: typeof import("@tsonic/nodejs/index.js").path.parse;
+  export const resolve: typeof import("@tsonic/nodejs/index.js").path.resolve;
+}
+declare module "path" {
+  export { path } from "@tsonic/nodejs/index.js";
+}
+declare module "node:crypto" {
+  export { crypto } from "@tsonic/nodejs/index.js";
+  export const randomUUID: typeof import("@tsonic/nodejs/index.js").crypto.randomUUID;
+}
+declare module "crypto" {
+  export { crypto } from "@tsonic/nodejs/index.js";
+}
+declare module "node:dgram" {
+  export { dgram } from "@tsonic/nodejs/index.js";
+}
+declare module "dgram" {
+  export { dgram } from "@tsonic/nodejs/index.js";
+}
+declare module "node:dns" {
+  export { dns } from "@tsonic/nodejs/index.js";
+}
+declare module "dns" {
+  export { dns } from "@tsonic/nodejs/index.js";
+}
+declare module "node:events" {
+  export { events } from "@tsonic/nodejs/index.js";
+}
+declare module "events" {
+  export { events } from "@tsonic/nodejs/index.js";
+}
+declare module "node:net" {
+  export { net } from "@tsonic/nodejs/index.js";
+}
+declare module "net" {
+  export { net } from "@tsonic/nodejs/index.js";
+}
+declare module "node:os" {
+  export { os } from "@tsonic/nodejs/index.js";
+  export const homedir: typeof import("@tsonic/nodejs/index.js").os.homedir;
+  export const tmpdir: typeof import("@tsonic/nodejs/index.js").os.tmpdir;
+}
+declare module "os" {
+  export { os } from "@tsonic/nodejs/index.js";
+}
+declare module "node:process" {
+  export { process } from "@tsonic/nodejs/index.js";
+  export const cwd: typeof import("@tsonic/nodejs/index.js").process.cwd;
+}
+declare module "process" {
+  export { process } from "@tsonic/nodejs/index.js";
+}
+declare module "node:querystring" {
+  export { querystring } from "@tsonic/nodejs/index.js";
+}
+declare module "querystring" {
+  export { querystring } from "@tsonic/nodejs/index.js";
+}
+declare module "node:readline" {
+  export { readline } from "@tsonic/nodejs/index.js";
+}
+declare module "readline" {
+  export { readline } from "@tsonic/nodejs/index.js";
+}
+declare module "node:stream" {
+  export { stream } from "@tsonic/nodejs/index.js";
+}
+declare module "stream" {
+  export { stream } from "@tsonic/nodejs/index.js";
+}
+declare module "node:timers" {
+  export { timers } from "@tsonic/nodejs/index.js";
+}
+declare module "timers" {
+  export { timers } from "@tsonic/nodejs/index.js";
+}
+declare module "node:tls" {
+  export { tls } from "@tsonic/nodejs/index.js";
+}
+declare module "tls" {
+  export { tls } from "@tsonic/nodejs/index.js";
+}
+declare module "node:url" {
+  export { url } from "@tsonic/nodejs/index.js";
+}
+declare module "url" {
+  export { url } from "@tsonic/nodejs/index.js";
+}
+declare module "node:util" {
+  export { util } from "@tsonic/nodejs/index.js";
+}
+declare module "util" {
+  export { util } from "@tsonic/nodejs/index.js";
+}
+declare module "node:zlib" {
+  export { zlib } from "@tsonic/nodejs/index.js";
+}
+declare module "zlib" {
+  export { zlib } from "@tsonic/nodejs/index.js";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsonic/nodejs",
-  "version": "10.0.37",
+  "version": "10.0.39",
   "description": "TypeScript type definitions for Node.js CLR library",
   "type": "module",
   "keywords": [

package/tsonic.bindings.json

@@ -1,4 +1,10 @@
 {
+  "bindingVersion": 1,
+  "packageName": "@tsonic/nodejs",
+  "surfaceMode": "nodejs",
+  "runtimePackages": [
+    "@tsonic/nodejs"
+  ],
   "dotnet": {
     "frameworkReferences": [
       { "id": "Microsoft.AspNetCore.App", "types": "@tsonic/aspnetcore" }

package/tsonic.surface.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": 1,
+  "id": "@tsonic/nodejs",
+  "extends": ["@tsonic/js"],
+  "requiredTypeRoots": ["."],
+  "useStandardLib": false
+}