@itee/tasks 1.3.0 → 1.3.2

package/sources/tests/benchmarks/compute-benchmarks.task.mjs

@@ -1,34 +1,36 @@
-import colors       from 'ansi-colors'
-import childProcess from 'child_process'
-import log          from 'fancy-log'
-import { glob }     from 'glob'
+import childProcess                from 'node:child_process'
 import {
     basename,
     dirname,
     extname,
     join,
-    normalize,
     relative
-}                   from 'path'
+}                                  from 'node:path'
+import {
+    red,
+    yellow
+}                                  from '../../utils/colors.mjs'
 import {
     createDirectoryIfNotExist,
     createFile,
-    getTaskConfigurationFor,
-    logLoadingTask,
-    packageName,
+    getJavascriptSourceFiles,
+}                                  from '../../utils/files.mjs'
+import {
+    log,
+    logLoadingTask
+}                                  from '../../utils/loggings.mjs'
+import {
+    getUnscopedPackageName,
     packageNodeModulesDirectory,
     packageSourcesDirectory,
     packageTestsBenchmarksDirectory,
     packageTestsDirectory
-}                   from '../../_utils.mjs'
+}                                  from '../../utils/packages.mjs'
+import { getTaskConfigurationFor } from '../../utils/tasks.mjs'
+import { toCamelCase }             from '../../utils/texts.mjs'
 
 logLoadingTask( import.meta.filename )
 
-const {
-          red,
-          yellow,
-      } = colors
-
 /**
  * @description Will generate benchmarks files from source code against provided alternatives
  */
@@ -38,18 +40,7 @@ const computeBenchmarksTask       = async ( done ) => {
 
     // Get task configuration
     const filePathsToIgnore = await getTaskConfigurationFor( import.meta.filename )
-
-    // Get source files to process
-    const pattern     = join( packageSourcesDirectory, '**' )
-    const sourceFiles = glob.sync( pattern )
-                            .map( filePath => normalize( filePath ) )
-                            .filter( filePath => {
-                                const fileName         = basename( filePath )
-                                const isJsFile         = fileName.endsWith( '.js' )
-                                const isNotPrivateFile = !fileName.startsWith( '_' )
-                                const isNotIgnoredFile = !filePathsToIgnore.includes( fileName )
-                                return isJsFile && isNotPrivateFile && isNotIgnoredFile
-                            } )
+    const sourceFiles       = getJavascriptSourceFiles( filePathsToIgnore )
 
     const benchRootImports = []
     for ( let sourceFile of sourceFiles ) {
@@ -57,19 +48,25 @@ const computeBenchmarksTask       = async ( done ) => {
         const specificFilePath = sourceFile.replace( packageSourcesDirectory, '' )
         const specificDir      = dirname( specificFilePath )
 
-        const fileName      = basename( sourceFile, extname( sourceFile ) )
-        const benchFileName = `${ fileName }.bench.js`
-        const benchDirPath  = join( packageTestsBenchmarksDirectory, specificDir )
-        const benchFilePath = join( benchDirPath, benchFileName )
+        const fileName          = basename( sourceFile, extname( sourceFile ) )
+        const camelCaseFileName = toCamelCase( fileName )
+        const benchFileName     = `${ camelCaseFileName }.bench.js`
+        const benchDirPath      = join( packageTestsBenchmarksDirectory, specificDir )
+        const benchFilePath     = join( benchDirPath, benchFileName )
 
-        const nsName         = `${ fileName }Namespace`
+        const nsName         = `${ camelCaseFileName }Namespace`
         const importDirPath  = relative( benchDirPath, packageSourcesDirectory )
         const importFilePath = join( importDirPath, specificFilePath ).replace( /\\/g, '/' )
 
         try {
 
             const jsdocPath   = join( packageNodeModulesDirectory, '/jsdoc/jsdoc.js' )
-            const jsdocOutput = childProcess.execFileSync( 'node', [ jsdocPath, '-X', sourceFile ] ).toString()
+            const jsdocOutput = childProcess.execFileSync( 'node', [ jsdocPath, '--explain', sourceFile ] ).toString()
+
+            if ( jsdocOutput.includes( 'There are no input files to process' ) ) {
+                log( 'Error   ', red( `${ sourceFile }, no input files to process` ) )
+                continue
+            }
 
             const classNames    = []
             const usedLongnames = []
@@ -223,7 +220,7 @@ const computeBenchmarksTask       = async ( done ) => {
         `\tsuite.run()` + '\n' +
         `}` + '\n'
 
-    const benchesFilePath = join( packageTestsBenchmarksDirectory, `${ packageName }.benchmarks.js` )
+    const benchesFilePath = join( packageTestsBenchmarksDirectory, `${ getUnscopedPackageName() }.benchmarks.js` )
     createFile( benchesFilePath, benchesTemplate )
 
     done()

package/sources/tests/benchmarks/run-benchmarks-for-backend.task.mjs

@@ -1,27 +1,29 @@
-import colors         from 'ansi-colors'
-import log            from 'fancy-log'
-import { existsSync } from 'fs'
-import { basename }   from 'node:path'
-import { join }       from 'path'
+import { existsSync } from 'node:fs'
 import {
-    logLoadingTask,
-    packageName,
+    basename,
+    join
+}                     from 'node:path'
+import {
+    red,
+    yellow
+}                     from '../../utils/colors.mjs'
+import {
+    log,
+    logLoadingTask
+}                     from '../../utils/loggings.mjs'
+import {
+    getUnscopedPackageName,
     packageTestsBenchmarksDirectory
-}                     from '../../_utils.mjs'
+}                     from '../../utils/packages.mjs'
 
 logLoadingTask( import.meta.filename )
 
-const {
-          red,
-          yellow
-      } = colors
-
 /**
  * @description Will run benchmarks with node
  */
 const runBenchmarksForBackendTask       = async ( done ) => {
 
-    const benchesPath = join( packageTestsBenchmarksDirectory, `/${ packageName }.benchmarks.js` )
+    const benchesPath = join( packageTestsBenchmarksDirectory, `/${ getUnscopedPackageName() }.benchmarks.js` )
     if ( !existsSync( benchesPath ) ) {
         log( yellow( `${ benchesPath } does not exist, skip backend benchmarks...` ) )
         done()

package/{configs → sources}/tests/benchmarks/run-benchmarks-for-frontend.conf.mjs

@@ -2,17 +2,17 @@ import { jsonReporter }       from '@itee/json-reporter'
 import { playwrightLauncher } from '@web/test-runner-playwright'
 
 export default {
-    files:          [
+    files: [
         'tests/benchmarks/**/*.bench.js'
     ],
-    debug:          false,
-    nodeResolve:    true,
-    browsers:       [
+    debug:       false,
+    nodeResolve: true,
+    browsers:    [
         playwrightLauncher( { product: 'chromium' } ),
         playwrightLauncher( { product: 'webkit' } ),
         playwrightLauncher( { product: 'firefox' } ),
     ],
-    testFramework:  {
+    testFramework: {
         path:   'node_modules/@itee/benchmarks-framework/benchmarks-framework.js',
         config: {
             foo: 'bar'
@@ -29,7 +29,7 @@ export default {
           </body>
         </html>
     `,
-    reporters:      [
+    reporters: [
         jsonReporter( {
             reportProgress: true
         } )

package/sources/tests/benchmarks/run-benchmarks-for-frontend.task.mjs

@@ -1,28 +1,25 @@
-import { startTestRunner } from '@web/test-runner'
-import colors              from 'ansi-colors'
-import { basename }        from 'node:path'
-import {
-    getTaskConfigurationFor,
-    logLoadingTask
-}                          from '../../_utils.mjs'
+import { startTestRunner }         from '@web/test-runner'
+import { basename }                from 'node:path'
+import { red }                     from '../../utils/colors.mjs'
+import { logLoadingTask }          from '../../utils/loggings.mjs'
+import { getTaskConfigurationFor } from '../../utils/tasks.mjs'
 
 logLoadingTask( import.meta.filename )
 
-const { red } = colors
-
 /**
  * @description Will run benchmarks with web-test-runner
  */
-const runBenchmarksForFrontendTask       = () => {
-    return new Promise( async ( resolve, reject ) => {
-
-        const configuration = await getTaskConfigurationFor( import.meta.filename )
-        const testRunner    = await startTestRunner( {
-            config:          configuration,
-            readCliArgs:     false,
-            readFileConfig:  false,
-            autoExitProcess: false,
-        } )
+const runBenchmarksForFrontendTask       = async () => {
+
+    const configuration = await getTaskConfigurationFor( import.meta.filename )
+    const testRunner    = await startTestRunner( {
+        config:          configuration,
+        readCliArgs:     false,
+        readFileConfig:  false,
+        autoExitProcess: false,
+    } )
+
+    return new Promise( ( resolve, reject ) => {
 
         if ( !testRunner ) {
             reject( red( 'Internal test runner error.' ) )
@@ -40,6 +37,7 @@ const runBenchmarksForFrontendTask       = () => {
         } )
 
     } )
+
 }
 runBenchmarksForFrontendTask.displayName = basename( import.meta.filename, '.task.mjs' )
 runBenchmarksForFrontendTask.description = 'Will run benchmarks with web-test-runner.'

package/{configs → sources}/tests/benchmarks/run-benchmarks.conf.mjs

@@ -1,5 +1,5 @@
-import { join }                        from 'path'
-import { iteePackageSourcesDirectory } from '../../../sources/_utils.mjs'
+import { join }                        from 'node:path'
+import { iteePackageSourcesDirectory } from '../../utils/packages.mjs'
 
 export default [
     join( iteePackageSourcesDirectory, 'tests/benchmarks/run-benchmarks-for-backend.task.mjs' ),

package/sources/tests/benchmarks/run-benchmarks.task.mjs

@@ -1,9 +1,9 @@
-import { basename } from 'node:path'
+import { basename }       from 'node:path'
+import { logLoadingTask } from '../../utils/loggings.mjs'
 import {
     getTaskConfigurationFor,
-    logLoadingTask,
     serializeTasksFrom
-}                   from '../../_utils.mjs'
+}                         from '../../utils/tasks.mjs'
 
 logLoadingTask( import.meta.filename )
 

package/{configs → sources}/tests/bundlings/check-bundling-from-esm-build-import.conf.mjs

@@ -1,10 +1,12 @@
 import nodeResolve from '@rollup/plugin-node-resolve'
 import cleanup     from 'rollup-plugin-cleanup'
+import { red }     from '../../utils/colors.mjs'
+import { log }     from '../../utils/loggings.mjs'
 
 export default {
-    input:     null,
-    external:  [ '' ],
-    plugins:   [
+    input:    null,
+    external: [ '' ],
+    plugins:  [
         nodeResolve( {
             preferBuiltins: true
         } ),
@@ -12,7 +14,7 @@ export default {
             comments: 'all' // else remove __PURE__ declaration... -_-'
         } )
     ],
-    onwarn:    ( {
+    onwarn: ( {
         loc,
         frame,
         message
@@ -22,11 +24,11 @@ export default {
         if ( message.includes( 'Circular dependency' ) ) { return }
         if ( message.includes( 'Generated an empty chunk' ) ) { return }
 
-        if ( loc ) {
-            process.stderr.write( `/!\\ ${ loc.file } (${ loc.line }:${ loc.column }) ${ frame } ${ message }\n` )
-        } else {
-            process.stderr.write( `/!\\ ${ message }\n` )
-        }
+        let errorMessage = ( loc )
+                           ? `/!\\ ${ loc.file } (${ loc.line }:${ loc.column }) ${ frame } ${ message }\n`
+                           : `/!\\ ${ message }\n`
+
+        log( red( errorMessage ) )
 
     },
     treeshake: {
@@ -37,7 +39,7 @@ export default {
         tryCatchDeoptimization:           true,
         unknownGlobalSideEffects:         true
     },
-    output:    {
+    output: {
         indent: '\t',
         format: 'esm',
         file:   null

package/sources/tests/bundlings/check-bundling-from-esm-build-import.task.mjs

@@ -1,39 +1,39 @@
-import colors     from 'ansi-colors'
-import log        from 'fancy-log'
 import {
     existsSync,
     mkdirSync,
     readFileSync,
     rmSync,
     writeFileSync
-}                 from 'fs'
+}                                  from 'node:fs'
 import {
     basename,
     join,
     relative
-}                 from 'path'
-import { rollup } from 'rollup'
+}                                  from 'node:path'
+import { rollup }                  from 'rollup'
 import {
-    getTaskConfigurationFor,
-    logLoadingTask,
+    green,
+    magenta,
+    red
+}                                  from '../../utils/colors.mjs'
+import {
+    log,
+    logLoadingTask
+}                                  from '../../utils/loggings.mjs'
+import {
+    getUnscopedPackageName,
     packageBuildsDirectory,
-    packageName,
     packageTestsBundlesDirectory
-}                 from '../../_utils.mjs'
+}                                  from '../../utils/packages.mjs'
+import { getTaskConfigurationFor } from '../../utils/tasks.mjs'
 
 logLoadingTask( import.meta.filename )
 
-const {
-          red,
-          green,
-          magenta,
-      } = colors
-
 const checkBundlingFromEsmBuildImportTask       = async ( done ) => {
 
     const configuration = await getTaskConfigurationFor( import.meta.filename )
 
-    const buildFilePath = join( packageBuildsDirectory, `${ packageName }.esm.js` )
+    const buildFilePath = join( packageBuildsDirectory, `${ getUnscopedPackageName() }.esm.js` )
     if ( !existsSync( buildFilePath ) ) {
         done( red( buildFilePath + ' does not exist' ) )
     }
@@ -41,7 +41,7 @@ const checkBundlingFromEsmBuildImportTask       = async ( done ) => {
     const outputDir      = join( packageTestsBundlesDirectory, 'from_build_import' )
     const temporaryDir   = join( packageTestsBundlesDirectory, 'from_build_import', '.tmp' )
     const importDir      = relative( temporaryDir, packageBuildsDirectory )
-    const importFilePath = join( importDir, `${ packageName }.esm.js` )
+    const importFilePath = join( importDir, `${ getUnscopedPackageName() }.esm.js` )
 
     if ( existsSync( outputDir ) ) {
         log( 'Clean up', magenta( outputDir ) )

package/{configs → sources}/tests/bundlings/check-bundling-from-esm-files-direct.conf.mjs

@@ -1,15 +1,21 @@
-import nodeResolve     from '@rollup/plugin-node-resolve'
-import cleanup         from 'rollup-plugin-cleanup'
-import { packageName } from '../../../sources/index.mjs'
+import commonjs                   from '@rollup/plugin-commonjs'
+import nodeResolve                from '@rollup/plugin-node-resolve'
+import cleanup                    from 'rollup-plugin-cleanup'
+import { red }                    from '../../utils/colors.mjs'
+import { log }                    from '../../utils/loggings.mjs'
+import { getUnscopedPackageName } from '../../utils/packages.mjs'
 
 export default {
     ignoredFiles: [
-        `${ packageName }.js`
+        `${ getUnscopedPackageName() }.js`
     ],
     buildOptions: {
-        input:     null,
-        external:  [ '' ],
-        plugins:   [
+        input:    null,
+        external: [ '' ],
+        plugins:  [
+            commonjs( {
+                include: 'node_modules/**'
+            } ),
             nodeResolve( {
                 preferBuiltins: true
             } ),
@@ -17,7 +23,7 @@ export default {
                 comments: 'none'
             } )
         ],
-        onwarn:    ( {
+        onwarn: ( {
             loc,
             frame,
             message
@@ -27,11 +33,11 @@ export default {
             if ( message.includes( 'Circular dependency' ) ) { return }
             if ( message.includes( 'Generated an empty chunk' ) ) { return }
 
-            if ( loc ) {
-                process.stderr.write( `/!\\ ${ loc.file } (${ loc.line }:${ loc.column }) ${ frame } ${ message }\n` )
-            } else {
-                process.stderr.write( `/!\\ ${ message }\n` )
-            }
+            let errorMessage = ( loc )
+                               ? `/!\\ ${ loc.file } (${ loc.line }:${ loc.column }) ${ frame } ${ message }\n`
+                               : `/!\\ ${ message }\n`
+
+            log( red( errorMessage ) )
 
         },
         treeshake: {
@@ -42,7 +48,7 @@ export default {
             tryCatchDeoptimization:           true,
             unknownGlobalSideEffects:         true
         },
-        output:    {
+        output: {
             indent: '\t',
             format: 'esm',
             file:   null

package/sources/tests/bundlings/check-bundling-from-esm-files-direct.task.mjs

@@ -1,33 +1,32 @@
-import colors     from 'ansi-colors'
-import log        from 'fancy-log'
 import {
     existsSync,
     rmSync
-}                 from 'fs'
-import { glob }   from 'glob'
+}                                   from 'node:fs'
 import {
     basename,
     dirname,
     extname,
-    join,
-    normalize
-}                 from 'path'
-import { rollup } from 'rollup'
+    join
+}                                   from 'node:path'
+import { rollup }                   from 'rollup'
+import {
+    green,
+    magenta,
+    red,
+}                                   from '../../utils/colors.mjs'
+import { getJavascriptSourceFiles } from '../../utils/files.mjs'
+import {
+    log,
+    logLoadingTask
+}                                   from '../../utils/loggings.mjs'
 import {
-    getTaskConfigurationFor,
-    logLoadingTask,
     packageSourcesDirectory,
     packageTestsBundlesDirectory
-}                 from '../../_utils.mjs'
+}                                   from '../../utils/packages.mjs'
+import { getTaskConfigurationFor }  from '../../utils/tasks.mjs'
 
 logLoadingTask( import.meta.filename )
 
-const {
-          red,
-          green,
-          magenta,
-      } = colors
-
 /**
  * @description In view to detect bundling side effects this task will
  * create intermediary file for each individual export from this package
@@ -43,18 +42,7 @@ const checkBundlingFromEsmFilesDirectTask       = async ( done ) => {
     }
 
     const configuration = await getTaskConfigurationFor( import.meta.filename )
-
-    // Get source files to process
-    const pattern     = join( packageSourcesDirectory, '**' )
-    const sourceFiles = glob.sync( pattern )
-                            .map( filePath => normalize( filePath ) )
-                            .filter( filePath => {
-                                const fileName         = basename( filePath )
-                                const isJsFile         = fileName.endsWith( '.js' )
-                                const isNotPrivateFile = !fileName.startsWith( '_' )
-                                const isNotIgnoredFile = !configuration.ignoredFiles.includes( fileName )
-                                return isJsFile && isNotPrivateFile && isNotIgnoredFile
-                            } )
+    const sourceFiles   = getJavascriptSourceFiles( configuration )
 
     for ( let sourceFile of sourceFiles ) {
 

package/{configs → sources}/tests/bundlings/check-bundling-from-esm-files-import.conf.mjs

@@ -1,20 +1,22 @@
-import nodeResolve     from '@rollup/plugin-node-resolve'
-import cleanup         from 'rollup-plugin-cleanup'
-import { packageName } from '../../../sources/index.mjs'
+import nodeResolve                from '@rollup/plugin-node-resolve'
+import cleanup                    from 'rollup-plugin-cleanup'
+import { red }                    from '../../utils/colors.mjs'
+import { log }                    from '../../utils/loggings.mjs'
+import { getUnscopedPackageName } from '../../utils/packages.mjs'
 
 export default {
     ignoredFiles: [
-        `${ packageName }.js`
+        `${ getUnscopedPackageName() }.js`
     ],
     buildOptions: {
-        input:     null,
-        plugins:   [
+        input:   null,
+        plugins: [
             nodeResolve(),
             cleanup( {
                 comments: 'all' // else remove __PURE__ declaration... -_-'
             } )
         ],
-        onwarn:    ( {
+        onwarn: ( {
             loc,
             frame,
             message
@@ -24,11 +26,11 @@ export default {
             if ( message.includes( 'Circular dependency' ) ) { return }
             if ( message.includes( 'Generated an empty chunk' ) ) { return }
 
-            if ( loc ) {
-                process.stderr.write( `/!\\ ${ loc.file } (${ loc.line }:${ loc.column }) ${ frame } ${ message }\n` )
-            } else {
-                process.stderr.write( `/!\\ ${ message }\n` )
-            }
+            let errorMessage = ( loc )
+                               ? `/!\\ ${ loc.file } (${ loc.line }:${ loc.column }) ${ frame } ${ message }\n`
+                               : `/!\\ ${ message }\n`
+
+            log( red( errorMessage ) )
 
         },
         treeshake: {
@@ -39,7 +41,7 @@ export default {
             tryCatchDeoptimization:           true,
             unknownGlobalSideEffects:         true
         },
-        output:    {
+        output: {
             indent: '\t',
             format: 'esm',
             file:   null

package/sources/tests/bundlings/check-bundling-from-esm-files-import.task.mjs

@@ -1,33 +1,34 @@
-import colors     from 'ansi-colors'
-import log        from 'fancy-log'
 import {
     existsSync,
     mkdirSync,
     rmSync,
     writeFileSync
-}                 from 'fs'
-import { glob }   from 'glob'
+}                                   from 'node:fs'
 import {
     basename,
     dirname,
     join,
-    normalize,
     parse,
     relative
-}                 from 'path'
-import { rollup } from 'rollup'
+}                                   from 'node:path'
+import { rollup }                   from 'rollup'
+import {
+    green,
+    magenta,
+    red
+}                                   from '../../utils/colors.mjs'
+import { getJavascriptSourceFiles } from '../../utils/files.mjs'
+import {
+    log,
+    logLoadingTask
+}                                   from '../../utils/loggings.mjs'
 import {
-    getTaskConfigurationFor,
-    logLoadingTask,
     packageSourcesDirectory,
     packageTestsBundlesDirectory
-}                 from '../../_utils.mjs'
+}                                   from '../../utils/packages.mjs'
+import { getTaskConfigurationFor }  from '../../utils/tasks.mjs'
 
-const {
-          red,
-          green,
-          magenta,
-      } = colors
+logLoadingTask( import.meta.filename )
 
 const checkBundlingFromEsmFilesImportTask       = async ( done ) => {
 
@@ -40,18 +41,7 @@ const checkBundlingFromEsmFilesImportTask       = async ( done ) => {
     }
 
     const configuration = await getTaskConfigurationFor( import.meta.filename )
-
-    // Get source files to process
-    const pattern     = join( packageSourcesDirectory, '**' )
-    const sourceFiles = glob.sync( pattern )
-                            .map( filePath => normalize( filePath ) )
-                            .filter( filePath => {
-                                const fileName         = basename( filePath )
-                                const isJsFile         = fileName.endsWith( '.js' )
-                                const isNotPrivateFile = !fileName.startsWith( '_' )
-                                const isNotIgnoredFile = !configuration.ignoredFiles.includes( fileName )
-                                return isJsFile && isNotPrivateFile && isNotIgnoredFile
-                            } )
+    const sourceFiles   = getJavascriptSourceFiles( configuration )
 
     for ( let sourceFile of sourceFiles ) {
 
@@ -108,6 +98,4 @@ checkBundlingFromEsmFilesImportTask.displayName = basename( import.meta.filename
 checkBundlingFromEsmFilesImportTask.description = 'In view to detect bundling side effects this task will create intermediary file for each individual export from this package and then create rollup config for each of them and bundle'
 checkBundlingFromEsmFilesImportTask.flags       = null
 
-logLoadingTask( import.meta.filename )
-
 export { checkBundlingFromEsmFilesImportTask }

package/sources/tests/bundlings/check-bundling.task.mjs

@@ -1,6 +1,6 @@
 import { series }                              from 'gulp'
 import { basename }                            from 'node:path'
-import { logLoadingTask }                      from '../../_utils.mjs'
+import { logLoadingTask }                      from '../../utils/loggings.mjs'
 import { checkBundlingFromEsmBuildImportTask } from './check-bundling-from-esm-build-import.task.mjs'
 import { checkBundlingFromEsmFilesDirectTask } from './check-bundling-from-esm-files-direct.task.mjs'
 import { checkBundlingFromEsmFilesImportTask } from './check-bundling-from-esm-files-import.task.mjs'

package/sources/tests/run-tests.task.mjs

@@ -1,6 +1,6 @@
 import { series }                 from 'gulp'
 import { basename }               from 'node:path'
-import { logLoadingTask }         from '../_utils.mjs'
+import { logLoadingTask }         from '../utils/loggings.mjs'
 import { runBenchmarksTestsTask } from './benchmarks/run-benchmarks.task.mjs'
 import { runUnitTestsTask }       from './units/run-unit-tests.task.mjs'