[HOT FIX | TICKET-PR] DEV.build: Windows OS - User's dev and build npm scripts, and internal tsc command fail

README.md

@@ -74,18 +74,27 @@
 
 #### 3. Update your project's package.json
 
-- **Add dev and build scripts:** In your web project's `package.json` file, add the `dev` and `build` scripts:
+- **Add dev and build scripts:** In your web project's `package.json` file, add the `dev` and `build` scripts.
 
-  ````
-  "scripts": {
-    "dev": "npx @build-in-blocks/dev.build@1.0.4 dev:build",
-    "build": "npx @build-in-blocks/dev.build@1.0.4 prod:build"
-    // your other npm scripts in your project goes here as usual
-  },
-  ````
+  - For `macOS` and `linux`, use:
+
+    ````
+    "scripts": {
+      "dev": "blocks.pkg.dev.build dev:build",
+      "build": "blocks.pkg.dev.build prod:build"
+      // your other npm scripts in your project goes here as usual
+    },
+    ````
+
+  - For `windows OS`, use:
 
-  > [!IMPORTANT]  
-  > About `@build-in-blocks/dev.build@[VERSION_NUMBER_HERE]` in the scripts: Make sure the version number used your in your `dev` and `build` scripts is the same as the version of the `@build-in-blocks/dev.build` package in your `package.json` file's `devDependencies`.
+    ````
+    "scripts": {
+      "dev": "blocks.pkg.dev.build.cmd dev:build",
+      "build": "blocks.pkg.dev.build.cmd prod:build"
+      // your other npm scripts in your project goes here as usual
+    },
+    ````
 
 - **You need this too:** Add these in the your web project's `package.json` file too:
 

bin/pkg.internal.cli.js

@@ -4,7 +4,7 @@
 
 import { blocksTerminalLogger } from '../config.root/blocks.packages.js';
 //-
-import { require, __dirname, internalPkgJSON } from '../config.root/root.js';
+import { require, __dirname, internalPkgJSON, isWindowsOS, windowsCmdextension } from '../config.root/root.js';
 //-
 import { renameRootTypeFileInBuildOutputFolder } from './helper/rename-root-type.js';
 //-
@@ -92,8 +92,8 @@
 
   spawnChildProcess.on('exit', (code) => {
     if (code === 0 && isProd) {
       console.log('============================================\n');
       console.log('[PROD] Bundling complete.\n[PROD] Generating type definitions...');
       try {
         // --------------------------------------------------------------
         // Execute the ENGINE'S internal tsc relative to the user project
@@ -101,7 +101,8 @@
         // Run tsc to generate .d.ts files into the 'build' folder
         // Using the user app's local tsc
         // -------------------------------------------------------
-        execSync(`${tscPath} --emitDeclarationOnly`, {
+        const tscPathForRelevantOS = isWindowsOS ? `tsc${windowsCmdextension}` : tscPath; // This check makes it compatible with Windows OS (in production)
+        execSync(`${tscPathForRelevantOS} --emitDeclarationOnly`, {
           stdio: 'inherit',
           env: {
             ...process.env,
@@ -111,7 +112,7 @@
         //-
         renameRootTypeFileInBuildOutputFolder();
         //-
         console.log('[PROD] Types (.d.ts files) generated successfully.');
       } catch (e) {
         blocksTerminalLogger({
           internalPackage: {
@@ -121,7 +122,7 @@
           originalErrorMessage: e,
         });
       }
       console.log('');
     }
     process.exit(code || 0);
   });

config.root/root.js

@@ -11,6 +11,9 @@ const __dirname = path.dirname(__filename);
 const internalProjectRoot = path.join(__dirname, '../', 'package.json');
 const internalPkgJSON = JSON.parse(fs.readFileSync(internalProjectRoot, 'utf-8'));
 
+const isWindowsOS = process.platform === 'win32';
+const windowsCmdextension = '.cmd';
+
 export {
   //-------------------------------
   // Export global access variables
@@ -21,4 +24,7 @@ export {
   //-
   internalProjectRoot,
   internalPkgJSON,
+  //-
+  isWindowsOS,
+  windowsCmdextension,
 };

docs.release/README.md

@@ -11,26 +11,10 @@
 
 #
 
-#### This library
-
-- In the **root README**, always remember to change `@build-in-blocks/dev.build@[VERSION_NUMBER]` for the npm scripts part of the docs too, as you bump up the `package.json` version.
-
-#
-
 #### Connected user apps
 
 - The "user app" built with this library requires you to build/generate a new bundle for consumption - Don't forget to run the `build` script command before publishing.
 
-- Before release (of your "user app" - e.g. dom.autoquery in this case), you always have to check that npx is referencing the correct/updated version in the scripts section of the package.json e.g. @1.0.0 in this case.
-
-    ````
-    "scripts": {
-        "dev": "npx @build-in-blocks/dev.build@1.0.0 dev:build",
-        "build": "npx @build-in-blocks/dev.build@1.0.0 prod:build"
-        // your other npm scripts in your project goes here as usual
-    },
-    ````
-
 #
 
 #### Build in blocks libraries in general

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@build-in-blocks/dev.build",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Production and development bundler build setup for your typescript web-related projects.",
   "type": "module",
   "bin": {