refactor: unify all packages to rootDir "." pattern (#241)

* docs: unify all packages to use rootDir "." pattern

Replace CLI vs Library distinction with unified TypeScript configuration:
- ALL packages now use rootDir "." (not "src")
- Consistent output: dist/{esm,cjs}/src/ for all packages
- Prevents configuration errors when adding bin executables
- Simplifies documentation and reduces maintenance burden

This change documents the standard pattern going forward.
Existing packages will be migrated incrementally.

Rationale: Previous two-pattern approach required updating 6+ fields
when converting library to CLI package, leading to errors. Unified
approach makes wrong configuration impossible and future-proofs all
packages for potential bin field addition.

* docs: fix CONTRIBUTING.md tsconfig example to use rootDir "."

Update quick start example to align with unified package structure.
All packages must use rootDir "." for consistency.

* fix(emulator): correct CLI bin file to use TypeScript source

- Convert bin/ya-modbus-emulator.js to .ts (TypeScript source)
- Update package.json bin to point to compiled version: ./dist/esm/bin/ya-modbus-emulator.js
- Update tsconfig.esm.json: rootDir "src" → ".", include ["src"] → ["src", "bin"]
- Update tsconfig.cjs.json: rootDir "src" → ".", include ["src"] → ["src", "bin"]
- Fix import path in bin file to use ../src/cli.js (compiled structure)

This follows the same pattern as @ya-modbus/cli package.
The bin file is now compiled with the rest of the TypeScript code,
ensuring it works correctly when the package is installed via npm.

Verified: npx ya-modbus-emulator --help works both in monorepo and when installed

* fix(emulator): complete migration to unified rootDir "." pattern

Update package.json exports to match new tsconfig structure:
- main: ./dist/cjs/src/index.js (was ./dist/cjs/index.js)
- module: ./dist/esm/src/index.js (was ./dist/esm/index.js)
- types: ./dist/esm/src/index.d.ts (was ./dist/esm/index.d.ts)
- exports: all paths updated to include /src/ subdirectory
- files: remove "bin" entry (now compiled to dist/)

This completes the emulator migration started in commit 3c1f920.
The package now follows the unified structure documented in
docs/agents/package-creation.md.

Verified: npx ya-modbus-emulator --help works correctly

* refactor(driver-types): migrate to unified rootDir "." pattern

Update TypeScript and package.json configuration:
- tsconfig: rootDir "src" → "."
- package.json: all paths updated to dist/{esm,cjs}/src/

Part of monorepo-wide migration to unified package structure.

* refactor(driver-sdk): migrate to unified rootDir "." pattern

* refactor(transport): migrate to unified rootDir "." pattern

* refactor(driver-loader): migrate to unified rootDir "." pattern

* refactor(driver-xymd1): migrate to unified rootDir "." pattern

* refactor(driver-or-we-516): migrate to unified rootDir "." pattern

* refactor(driver-ex9em): migrate to unified rootDir "." pattern

* fix(driver-loader): correct testing export path for unified structure

The testing subpath export was pointing to dist/esm/testing/ but with
rootDir "." the actual location is dist/esm/src/testing/.

Updated exports:
- ./dist/esm/testing/index.js → ./dist/esm/src/testing/index.js
- ./dist/cjs/testing/index.js → ./dist/cjs/src/testing/index.js

This fixes module resolution for consumers importing from
@ya-modbus/driver-loader/testing.

Author: groupsky

CONTRIBUTING.md

@@ -604,7 +604,7 @@ cat > packages/my-package/tsconfig.json << 'EOF'
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
     "outDir": "dist",
-    "rootDir": "src"
+    "rootDir": "."
   },
   "include": ["src"]
 }

docs/NEW-PACKAGE.md

@@ -170,12 +170,14 @@ Packages typically extend the base tsconfig:
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
     "outDir": "./dist",
-    "rootDir": "./src"
+    "rootDir": "."
   },
   "include": ["src"]
 }
 ```
 
+**IMPORTANT:** Always use `rootDir: "."` (not `"src"`). This ensures consistent output structure across all packages and prevents configuration errors when adding bin executables later.
+
 ### Engine Requirements
 
 All packages MUST specify the Node.js engine requirement:

docs/agents/package-creation.md

@@ -30,24 +30,29 @@ See: packages/driver-xymd1/tsconfig.cjs.json for CJS build config
 
 CRITICAL: Add references to BOTH tsconfig files for each dependency.
 
-### Package Types: CLI vs Library
+### TypeScript Configuration
 
-**Library packages** (drivers, transport, etc.):
+ALL packages MUST use consistent tsconfig structure:
 
-- Use `rootDir: "src"` in tsconfig
-- Output: `dist/esm/index.js` and `dist/cjs/index.js`
-- Exports point to `dist/{esm,cjs}/index.js`
+**tsconfig.esm.json and tsconfig.cjs.json:**
 
-**CLI packages** (cli, device-profiler, mqtt-bridge):
+- Use `rootDir: "."` (NEVER use `rootDir: "src"`)
+- Include `["src"]` for library packages
+- Include `["src", "bin"]` for packages with CLI executables
+- Output: `dist/esm/src/` and `dist/cjs/src/` for all packages
 
-- Use `rootDir: "."` in tsconfig
-- Include both `src` and `bin` directories
-- Output: `dist/esm/src/` and `dist/esm/bin/`
-- Exports point to `dist/{esm,cjs}/src/index.js`
-- Bin field points to `dist/esm/bin/*.js`
+**package.json structure:**
 
-See: packages/cli/tsconfig.esm.json for CLI package structure
-See: packages/driver-xymd1/tsconfig.esm.json for library package structure
+- `main`: `"./dist/cjs/src/index.js"`
+- `module`: `"./dist/esm/src/index.js"`
+- `types`: `"./dist/esm/src/index.d.ts"`
+- `exports["."]` points to `dist/{esm,cjs}/src/index.js`
+- `bin` (if present): `"./dist/esm/bin/<name>.js"`
+
+CRITICAL: Using `rootDir: "."` for all packages ensures consistent output structure and prevents configuration errors when adding bin executables.
+
+See: packages/cli for reference package with bin executable
+See: packages/driver-xymd1 for reference library package
 
 ### CommonJS Module Interop
 

packages/driver-ex9em/package.json

@@ -15,8 +15,8 @@
   "author": "Geno Roupsky <185580+groupsky@users.noreply.github.com>",
   "license": "GPL-3.0-or-later",
   "type": "module",
-  "main": "./dist/cjs/index.js",
-  "types": "./dist/esm/index.d.ts",
+  "main": "./dist/cjs/src/index.js",
+  "types": "./dist/esm/src/index.d.ts",
   "files": [
     "dist",
     "README.md",
@@ -54,16 +54,16 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "module": "./dist/esm/index.js",
+  "module": "./dist/esm/src/index.js",
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/esm/index.d.ts",
-        "default": "./dist/esm/index.js"
+        "types": "./dist/esm/src/index.d.ts",
+        "default": "./dist/esm/src/index.js"
       },
       "require": {
-        "types": "./dist/cjs/index.d.ts",
-        "default": "./dist/cjs/index.js"
+        "types": "./dist/cjs/src/index.d.ts",
+        "default": "./dist/cjs/src/index.js"
       }
     }
   }

packages/driver-ex9em/tsconfig.cjs.json

@@ -2,7 +2,7 @@
   "extends": "../../tsconfig.cjs.json",
   "compilerOptions": {
     "outDir": "dist/cjs",
-    "rootDir": "src"
+    "rootDir": "."
   },
   "include": ["src"],
   "references": [

packages/driver-ex9em/tsconfig.esm.json

@@ -2,7 +2,7 @@
   "extends": "../../tsconfig.esm.json",
   "compilerOptions": {
     "outDir": "dist/esm",
-    "rootDir": "src"
+    "rootDir": "."
   },
   "include": ["src"],
   "references": [

packages/driver-loader/package.json

@@ -10,28 +10,28 @@
   ],
   "author": "Geno Roupsky <185580+groupsky@users.noreply.github.com>",
   "license": "GPL-3.0-or-later",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/esm/index.d.ts",
+  "main": "./dist/cjs/src/index.js",
+  "module": "./dist/esm/src/index.js",
+  "types": "./dist/esm/src/index.d.ts",
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/esm/index.d.ts",
-        "default": "./dist/esm/index.js"
+        "types": "./dist/esm/src/index.d.ts",
+        "default": "./dist/esm/src/index.js"
       },
       "require": {
-        "types": "./dist/cjs/index.d.ts",
-        "default": "./dist/cjs/index.js"
+        "types": "./dist/cjs/src/index.d.ts",
+        "default": "./dist/cjs/src/index.js"
       }
     },
     "./testing": {
       "import": {
-        "types": "./dist/esm/testing/index.d.ts",
-        "default": "./dist/esm/testing/index.js"
+        "types": "./dist/esm/src/testing/index.d.ts",
+        "default": "./dist/esm/src/testing/index.js"
       },
       "require": {
-        "types": "./dist/cjs/testing/index.d.ts",
-        "default": "./dist/cjs/testing/index.js"
+        "types": "./dist/cjs/src/testing/index.d.ts",
+        "default": "./dist/cjs/src/testing/index.js"
       }
     }
   },

packages/driver-loader/tsconfig.cjs.json

@@ -2,7 +2,7 @@
   "extends": "../../tsconfig.cjs.json",
   "compilerOptions": {
     "outDir": "dist/cjs",
-    "rootDir": "src"
+    "rootDir": "."
   },
   "include": ["src"],
   "references": [{ "path": "../driver-types/tsconfig.cjs.json" }]

packages/driver-loader/tsconfig.esm.json

@@ -2,7 +2,7 @@
   "extends": "../../tsconfig.esm.json",
   "compilerOptions": {
     "outDir": "dist/esm",
-    "rootDir": "src"
+    "rootDir": "."
   },
   "include": ["src"],
   "references": [{ "path": "../driver-types/tsconfig.esm.json" }]

packages/driver-or-we-516/package.json

@@ -15,8 +15,8 @@
   "author": "Geno Roupsky <185580+groupsky@users.noreply.github.com>",
   "license": "GPL-3.0-or-later",
   "type": "module",
-  "main": "./dist/cjs/index.js",
-  "types": "./dist/esm/index.d.ts",
+  "main": "./dist/cjs/src/index.js",
+  "types": "./dist/esm/src/index.d.ts",
   "files": [
     "dist",
     "README.md",
@@ -54,16 +54,16 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "module": "./dist/esm/index.js",
+  "module": "./dist/esm/src/index.js",
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/esm/index.d.ts",
-        "default": "./dist/esm/index.js"
+        "types": "./dist/esm/src/index.d.ts",
+        "default": "./dist/esm/src/index.js"
       },
       "require": {
-        "types": "./dist/cjs/index.d.ts",
-        "default": "./dist/cjs/index.js"
+        "types": "./dist/cjs/src/index.d.ts",
+        "default": "./dist/cjs/src/index.js"
       }
     }
   }