@itee/tasks 1.3.1 → 1.3.2

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,19 +1,15 @@
-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 = async () => {
+const runBenchmarksForFrontendTask       = async () => {
 
     const configuration = await getTaskConfigurationFor( import.meta.filename )
     const testRunner    = await startTestRunner( {

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'
 

package/sources/tests/units/compute-unit-tests.conf.mjs

@@ -0,0 +1,5 @@
+import { getUnscopedPackageName } from '../../utils/packages.mjs'
+
+export default [
+    `${ getUnscopedPackageName() }.js`
+]

package/sources/tests/units/compute-unit-tests.task.mjs

@@ -1,36 +1,40 @@
-import colors              from 'ansi-colors'
-import childProcess        from 'child_process'
-import log                 from 'fancy-log'
-import { glob }            from 'glob'
-import { isNotEmptyArray } from 'itee-validators'
+import { isNotEmptyArray }         from 'itee-validators'
+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 {
-    Indenter,
     createDirectoryIfNotExist,
     createFile,
+    getJavascriptSourceFiles
+}                                  from '../../utils/files.mjs'
+import {
+    log,
+    logLoadingTask
+}                                  from '../../utils/loggings.mjs'
+import {
     getPrettyPackageName,
-    getTaskConfigurationFor,
-    logLoadingTask,
-    packageName,
+    getUnscopedPackageName,
     packageNodeModulesDirectory,
     packageSourcesDirectory,
     packageTestsUnitsDirectory
-}                          from '../../_utils.mjs'
+}                                  from '../../utils/packages.mjs'
+import { getTaskConfigurationFor } from '../../utils/tasks.mjs'
+import {
+    Indenter,
+    toCamelCase
+}                                  from '../../utils/texts.mjs'
 
 logLoadingTask( import.meta.filename )
 
-const {
-          red,
-          yellow,
-      } = colors
-
 /**
  * @description Will generate unit test files from source code using type inference from comments
  */
@@ -38,20 +42,8 @@ const computeUnitTestsTask       = async ( done ) => {
 
     createDirectoryIfNotExist( packageTestsUnitsDirectory )
 
-    // 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 unitsImportMap = []
     for ( let sourceFile of sourceFiles ) {
@@ -59,20 +51,26 @@ const computeUnitTestsTask       = async ( done ) => {
         const specificFilePath = sourceFile.replace( packageSourcesDirectory, '' )
         const specificDir      = dirname( specificFilePath )
 
-        const fileName     = basename( sourceFile, extname( sourceFile ) )
-        const unitFileName = `${ fileName }.unit.mjs`
-        const unitDirPath  = join( packageTestsUnitsDirectory, specificDir )
-        const unitFilePath = join( unitDirPath, unitFileName )
+        const fileName          = basename( sourceFile, extname( sourceFile ) )
+        const camelCaseFileName = toCamelCase( fileName )
+        const unitFileName      = `${ camelCaseFileName }.unit.mjs`
+        const unitDirPath       = join( packageTestsUnitsDirectory, specificDir )
+        const unitFilePath      = join( unitDirPath, unitFileName )
 
-        const nsName         = `${ fileName }Namespace`
-        const unitName       = `${ fileName }Units`
+        const nsName         = `${ camelCaseFileName }Namespace`
+        const unitName       = `${ camelCaseFileName }Units`
         const importDirPath  = relative( unitDirPath, 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 = []
@@ -534,7 +532,7 @@ const computeUnitTestsTask       = async ( done ) => {
 
     }
 
-    const unitsFilePath = join( packageTestsUnitsDirectory, `${ packageName }.units.mjs` )
+    const unitsFilePath = join( packageTestsUnitsDirectory, `${ getUnscopedPackageName() }.units.mjs` )
     createFile( unitsFilePath, unitsTemplate )
 
     done()