@nmakarov/cli-toolkit 0.6.0 → 0.7.0

package/README.md

@@ -33,13 +33,15 @@ npm install @nmakarov/cli-toolkit
 ## Requirements
 
 - **Node.js**: v20.0.0 or higher (recommended: v24+)
-- **For Screen module**: `ink` and `react` as peer dependencies
+- **For Screen module**: `ink` and `react` as peer dependencies (ESM-only packages)
 
 ```bash
 # Install peer dependencies for interactive UIs
 npm install ink react
 ```
 
+**Note**: The Screen module has special requirements for CommonJS usage. See [CommonJS Support](#screen-module---esm-only-dependencies) for details.
+
 ## Quick Start
 
 ### Args - Parse Command Line Arguments
@@ -194,9 +196,8 @@ const client = new HttpClient({ useTestServer: 'http://localhost:5030' });
 ### Screen - Interactive Terminal UIs
 
 ```typescript
+// ESM (recommended)
 import { showListScreen } from '@nmakarov/cli-toolkit/screen';
-import { createElement as h } from 'react';
-import { Text } from 'ink';
 
 const choice = await showListScreen({
     title: "Main Menu",
@@ -212,6 +213,8 @@ const choice = await showListScreen({
 console.log(`Selected: ${choice}`);
 ```
 
+**Note**: The Screen module requires ESM dependencies (`ink` and `react`). For CommonJS usage, see [CommonJS Support](#screen-module---esm-only-dependencies) section.
+
 [📖 Full Screen Documentation](docs/SCREEN.md)
 
 ### Logger - Structured Logging
@@ -385,16 +388,50 @@ const logger = new CliToolkitLogger({ prefix: 'APP' });
 
 ## CommonJS Support
 
-All modules support both ESM and CommonJS:
+Most modules support both ESM and CommonJS:
 
 ```javascript
 // ESM (TypeScript/Modern Node)
 import { Args } from '@nmakarov/cli-toolkit/args';
+import { Params } from '@nmakarov/cli-toolkit/params';
+import { CliToolkitLogger } from '@nmakarov/cli-toolkit/logger';
 
 // CommonJS (Traditional Node.js)
 const { Args } = require('@nmakarov/cli-toolkit/args');
+const { Params } = require('@nmakarov/cli-toolkit/params');
+const { CliToolkitLogger } = require('@nmakarov/cli-toolkit/logger');
+```
+
+### Screen Module - ESM-Only Dependencies
+
+⚠️ **Important**: The `screen` module depends on `ink` and `react`, which are ESM-only packages. Due to Node.js limitations, synchronous `require()` cannot load ESM modules.
+
+**Recommended (ESM):**
+```javascript
+// Use ESM import (recommended)
+import { showScreen, showListScreen } from '@nmakarov/cli-toolkit/screen';
 ```
 
+**CommonJS Workaround:**
+If you must use CommonJS, you need to pre-load the ESM dependencies:
+
+```javascript
+// CommonJS with async pre-loading
+const screen = require('@nmakarov/cli-toolkit/screen');
+
+(async () => {
+  // Pre-load ESM dependencies before using the module
+  await screen.load();
+  
+  // Now you can use screen functions
+  const { showScreen, showListScreen } = screen;
+  
+  await showScreen({ /* ... */ });
+})();
+```
+
+See the [Screen Module Documentation](docs/SCREEN.md#commonjs-usage) for more details.
+
 ## Contributing
 
 Contributions are welcome! Please read the [development documentation](docs/README.md) for details.

package/dist/index.cjs

@@ -63,6 +63,7 @@ __export(src_exports, {
   h: () => import_react5.createElement,
   joiEdateType: () => joiEdateType,
   joiStringArrayType: () => joiStringArrayType,
+  load: () => load,
   organizeFooterMessages: () => organizeFooterMessages,
   setupContext: () => setupContext,
   showListScreen: () => showListScreen,
@@ -1793,6 +1794,22 @@ function organizeFooterMessages(messages) {
   return lines;
 }
 
+// src/screen/index.ts
+var loadPromise = null;
+async function load() {
+  if (loadPromise) return loadPromise;
+  loadPromise = Promise.all([
+    import("react"),
+    import("ink")
+  ]).then(() => {
+  });
+  return loadPromise;
+}
+if (typeof window === "undefined") {
+  load().catch(() => {
+  });
+}
+
 // src/filedatabase/index.ts
 var import_fs4 = __toESM(require("fs"), 1);
 var import_path4 = __toESM(require("path"), 1);
@@ -3292,6 +3309,7 @@ function setupContext(opts = {}) {
   h,
   joiEdateType,
   joiStringArrayType,
+  load,
   organizeFooterMessages,
   setupContext,
   showListScreen,