Split node/browser builds with conditional exports

[samchon]

Problem

WebSocketServer, WorkerConnector, SharedWorkerServer etc. behave differently in NodeJS and browsers, but that difference lived only at runtime (is_node() branches, import2() tricks, NodeModule singletons). The package shipped a single lib/ tree, so every bundler saw ws, http, worker_threads, child_process references even when targeting the browser, and every Node consumer carried the browser polyfill paths.

Solution

The platform is now decided at build time, not runtime.

src/platform/
  IPlatform.ts         # interface of platform-dependent features (@internal)
  node/index.ts        # static import of ws / http / https / worker_threads / child_process
  browser/index.ts     # self.WebSocket / Worker / self only

Shared classes import a single alias, #platform, which tsconfig.node.json and tsconfig.browser.json resolve to different directories via paths (rewritten in the emit by the already-used ts-patch + typescript-transform-paths). One source, one set of .d.ts, two runtime trees.

"main": "lib/node/index.js",
"browser": "lib/browser/index.js",
"sideEffects": false,
"exports": {
  ".":         { "types", "browser": {...}, "react-native": {...}, "node": {...}, "require", "import" },
  "./node":    { ... },   // explicit, e.g. Electron main
  "./browser": { ... }    // explicit, e.g. Electron renderer
}

Verification

• lib/browser/index.mjs imports only tstl; no ws / http / fs / child_process / worker_threads anywhere in lib/browser/**
• lib/node/index.mjs statically imports ws and node builtins
• npm pack + consumer project: require("tgrid") → lib/node, node --conditions=browser and --conditions=react-native → lib/browser, same for ESM and the ./node / ./browser subpaths
• Consumer type-check passes under moduleResolution node, node16, and bundler
• Both builds export the identical symbol set; wrong-platform usage throws the same messages as before (WebSocketServer in browser, SharedWorkerServer in node)
• npm run test:node (17 tests) and npm run test:browser (puppeteer, 3 pages) pass
• website typedoc: 0 errors (19 pre-existing doc-link warnings, unchanged)
• npx eslint src: clean

Other changes

• import2 dependency removed; NodeModule.ts, WebSocketPolyfill.ts deleted
• NodeWorkerCompiler, FileSystem, Process* / Thread* moved to src/platform/node/, simplified from async factories to plain classes / functions
• New IWorkerChannel interface abstracts the worker-to-parent channel, so WorkerServer no longer checks self.document itself
• test/browser/tsconfig.json compiles browser-side test scripts with the browser platform into bin/browser/; dev script watches both projects with tsc --build
• test_worker_compiler previously ran the browser bundle inside a Node child process (which only worked thanks to runtime detection); it now uses a separate node-platform bundle (bundle/worker-server.node.js)
• src/typings: Object type parameters renamed to Wrapper; intentional Function / Boolean / Number / String usages get scoped eslint-disable comments. No type semantics changed.
• Version bumped to 1.3.0 — new subpaths and a changed exports shape

🤖 Generated with Claude Code

https://claude.ai/code/session_01AQaTBspPxvUiYtTCbC8Tcg