@itee/tasks 1.0.13 → 1.1.1

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+# [v1.1.1](https://github.com/Itee/tasks/compare/v1.1.0...v1.1.1) (2026-01-15)
+
+# [v1.1.0](https://github.com/Itee/tasks/compare/v1.0.13...v1.1.0) (2026-01-15)
+
+## ✨ New Features
+- [`f6c941a`](https://github.com/Itee/tasks/commit/f6c941a)  (builds) add default config for build task 
+
+## 🐛 Bug Fixes
+- [`231bd19`](https://github.com/Itee/tasks/commit/231bd19)  (utils) fix strict usage with complex options
+
 # [v1.0.13](https://github.com/Itee/tasks/compare/v1.0.12...v1.0.13) (2026-01-15)
 
 # [v1.0.12](https://github.com/Itee/itee-tasks/compare/v1.0.11...v1.0.12) (2026-01-14)

package/configs/builds/build.conf.mjs

@@ -1 +1,3 @@
-export default []
+import { createRollupConfigs } from '../../sources/_utils.mjs'
+
+export default createRollupConfigs()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itee/tasks",
-  "version": "1.0.13",
+  "version": "1.1.1",
   "description": "Allow to manage all commons itee gulp tasks into one place ",
   "keywords": [
     "itee",
@@ -49,8 +49,7 @@
     "tests:units:run:back": "gulp run-unit-tests-for-backend",
     "tests:units:run:front": "gulp run-unit-tests-for-frontend",
     "release": "gulp release",
-    "semantic-release": "semantic-release --dry-run --no-ci",
-    "postversion": "gulp build"
+    "semantic-release": "semantic-release --dry-run --no-ci"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",

package/sources/_utils.mjs

@@ -1,6 +1,10 @@
+import commonjs          from '@rollup/plugin-commonjs'
+import nodeResolve       from '@rollup/plugin-node-resolve'
+import terser            from '@rollup/plugin-terser'
 import colors            from 'ansi-colors'
 import childProcess      from 'child_process'
 import log               from 'fancy-log'
+import figlet            from 'figlet'
 import { glob }          from 'glob'
 import {
     parallel,
@@ -21,6 +25,7 @@ import {
     relative,
 }                        from 'node:path'
 import { fileURLToPath } from 'node:url'
+import replace           from 'rollup-plugin-re'
 
 const {
           red,
@@ -31,124 +36,13 @@ const {
           cyan
       } = colors
 
-///
-
-function createDirectoryIfNotExist( directoryPath ) {
-
-    if ( !existsSync( directoryPath ) ) {
-        log( 'Creating', green( directoryPath ) )
-        mkdirSync( directoryPath, { recursive: true } )
-    }
-
-}
-
-function getJsonFrom( path ) {
-
-    const buffer = readFileSync( path )
-    return JSON.parse( buffer.toString() )
-
-}
-
-function getTaskConfigurationPathFor( filename ) {
-
-    // Get relative path of the task between internal or user defined
-    let relativeTaskPath = filename.includes( iteePackageSourcesDirectory )
-                           ? relative( iteePackageSourcesDirectory, filename )
-                           : relative( packageTasksDirectory, filename )
-
-    // Generate all possible config file path depending on file extension and default or user defined
-    const terminalExtension = extname( relativeTaskPath )
-    const searchValue       = relativeTaskPath.includes( '.task.' ) ? `.task${ terminalExtension }` : terminalExtension
-    const replaceValues     = [
-        '.conf.json',
-        '.conf.js',
-        '.conf.mjs',
-    ]
-
-    const packageConfigurationPaths = []
-    const defaultConfigurationPaths = []
-
-    for ( const replaceValue of replaceValues ) {
-        const configurationLocation    = relativeTaskPath.replace( searchValue, replaceValue )
-        const packageConfigurationPath = join( packageTasksConfigurationsDirectory, configurationLocation )
-        const defaultConfigurationPath = join( iteePackageConfigurationsDirectory, configurationLocation )
-
-        packageConfigurationPaths.push( packageConfigurationPath )
-        defaultConfigurationPaths.push( defaultConfigurationPath )
-    }
-
-    // Take care of the configuration search order (package first then default !)
-    const configurationPaths = [ ...packageConfigurationPaths, ...defaultConfigurationPaths ]
-    let configurationPath    = undefined
-
-    // Looking for existing configuration file
-    for ( const packageConfigurationPath of configurationPaths ) {
-
-        if ( existsSync( packageConfigurationPath ) ) {
-            configurationPath = packageConfigurationPath
-            break
-        }
-
-    }
-
-    // Else throw an error
-    if ( !configurationPath ) {
-        throw new Error( `Unable to find configuration in package configuration paths ${ configurationPaths.join( ', ' ) }.` )
-    }
-
-    return configurationPath
-
-}
-
-async function getTaskConfigurationFor( filename ) {
-
-    const configurationFilePath = getTaskConfigurationPathFor( filename )
-
-    log( `Loading configuration from ${ cyan( configurationFilePath ) }` )
+/// Debugging
 
-    let configuration = null
-
-    try {
-
-        if ( extname( configurationFilePath ) === '.json' ) {
-
-            configuration = getJsonFrom( configurationFilePath )
-
-        } else {
-
-            const moduleData = await import( configurationFilePath )
-            configuration    = moduleData.default
-
-        }
-
-    } catch ( e ) {
-
-        log( red( e ) )
-
-    }
-
-    return configuration
-
-}
-
-function createFile( filePath, fileContent ) {
-
-    log( 'Creating', green( filePath ) )
-    writeFileSync( filePath, fileContent )
-
-}
-
-function getFilesFrom( globPattern, filter = ( any ) => true ) {
-
-    return glob.sync( globPattern )
-               .map( filePath => normalize( filePath ) )
-               .filter( filter )
+const isDebugging = ( process.env.RUNNER_DEBUG && process.env.RUNNER_DEBUG === '1' )
 
-}
-
-///
+/// Package paths and data
 
-function getPackageRootDirectory() {
+function _getPackageRootDirectory() {
 
     let __dirname
 
@@ -167,13 +61,13 @@ function getPackageRootDirectory() {
 
 }
 
-const iteePackageRootDirectory           = getPackageRootDirectory()
+const iteePackageRootDirectory           = _getPackageRootDirectory()
 const iteePackageJsonPath                = join( iteePackageRootDirectory, 'package.json' )
 const iteePackageConfigurationsDirectory = join( iteePackageRootDirectory, 'configs' )
 const iteePackageNodeModulesDirectory    = join( iteePackageRootDirectory, 'node_modules' )
 const iteePackageSourcesDirectory        = join( iteePackageRootDirectory, 'sources' )
 
-const packageRootDirectory                = iteePackageRootDirectory.includes( 'node_modules' ) ? join( iteePackageRootDirectory, '../../' ) : iteePackageRootDirectory
+const packageRootDirectory                = iteePackageRootDirectory.includes( 'node_modules' ) ? join( iteePackageRootDirectory, '../../../' ) : iteePackageRootDirectory
 const packageTasksDirectory               = join( packageRootDirectory, '.tasks' )
 const packageTasksConfigurationsDirectory = join( packageTasksDirectory, 'configs' )
 const packageNodeModulesDirectory         = join( packageRootDirectory, 'node_modules' )
@@ -196,6 +90,8 @@ const packageJson        = getJsonFrom( packageJsonPath )
 const packageName        = packageJson.name
 const packageVersion     = packageJson.version
 const packageDescription = packageJson.description
+const packageAuthor      = packageJson.author
+const packageLicense     = packageJson.license
 
 function getPrettyPackageName( separator = ' ' ) {
 
@@ -257,7 +153,40 @@ function getPrettyNpmVersion() {
 
 }
 
-///
+/// File system Management
+
+function createDirectoryIfNotExist( directoryPath ) {
+
+    if ( !existsSync( directoryPath ) ) {
+        log( 'Creating', green( directoryPath ) )
+        mkdirSync( directoryPath, { recursive: true } )
+    }
+
+}
+
+function getJsonFrom( path ) {
+
+    const buffer = readFileSync( path )
+    return JSON.parse( buffer.toString() )
+
+}
+
+function createFile( filePath, fileContent ) {
+
+    log( 'Creating', green( filePath ) )
+    writeFileSync( filePath, fileContent )
+
+}
+
+function getFilesFrom( globPattern, filter = ( any ) => true ) {
+
+    return glob.sync( globPattern )
+               .map( filePath => normalize( filePath ) )
+               .filter( filter )
+
+}
+
+/// Task Management
 
 async function getTasksFrom( taskFiles = [] ) {
 
@@ -310,10 +239,281 @@ async function parallelizeTasksFrom( taskFiles = [] ) {
 
 }
 
-///
+/// Task configuration management
+
+function getTaskConfigurationPathFor( filename ) {
+
+    // Get relative path of the task between internal or user defined
+    let relativeTaskPath = filename.includes( iteePackageSourcesDirectory )
+                           ? relative( iteePackageSourcesDirectory, filename )
+                           : relative( packageTasksDirectory, filename )
+
+    // Generate all possible config file path depending on file extension and default or user defined
+    const terminalExtension = extname( relativeTaskPath )
+    const searchValue       = relativeTaskPath.includes( '.task.' ) ? `.task${ terminalExtension }` : terminalExtension
+    const replaceValues     = [
+        '.conf.json',
+        '.conf.js',
+        '.conf.mjs',
+    ]
+
+    const packageConfigurationPaths = []
+    const defaultConfigurationPaths = []
+
+    for ( const replaceValue of replaceValues ) {
+        const configurationLocation    = relativeTaskPath.replace( searchValue, replaceValue )
+        const packageConfigurationPath = join( packageTasksConfigurationsDirectory, configurationLocation )
+        const defaultConfigurationPath = join( iteePackageConfigurationsDirectory, configurationLocation )
+
+        packageConfigurationPaths.push( packageConfigurationPath )
+        defaultConfigurationPaths.push( defaultConfigurationPath )
+    }
+
+    // Take care of the configuration search order (package first then default !)
+    const configurationPaths = [ ...packageConfigurationPaths, ...defaultConfigurationPaths ]
+    let configurationPath    = undefined
+
+    // Looking for existing configuration file
+    for ( const packageConfigurationPath of configurationPaths ) {
+
+        if ( existsSync( packageConfigurationPath ) ) {
+            configurationPath = packageConfigurationPath
+            break
+        }
+
+    }
+
+    // Else throw an error
+    if ( !configurationPath ) {
+        throw new Error( `Unable to find configuration in package configuration paths ${ configurationPaths.join( ', ' ) }.` )
+    }
+
+    return configurationPath
+
+}
+
+async function getTaskConfigurationFor( filename ) {
+
+    const configurationFilePath = getTaskConfigurationPathFor( filename )
+
+    log( `Loading configuration from ${ cyan( configurationFilePath ) }` )
+
+    let configuration = null
+
+    try {
+
+        if ( extname( configurationFilePath ) === '.json' ) {
+
+            configuration = getJsonFrom( configurationFilePath )
+
+        } else {
+
+            const moduleData = await import( configurationFilePath )
+            configuration    = moduleData.default
+
+        }
+
+    } catch ( e ) {
+
+        log( red( e ) )
+
+    }
+
+    return configuration
+
+}
+
+/// Build management
+
+function getPrettyFormatForBanner( format ) {
+
+    let prettyFormat = ''
+
+    switch ( format ) {
+
+        case 'cjs':
+            prettyFormat = 'CommonJs'
+            break
+
+        case 'esm':
+            prettyFormat = 'EsModule'
+            break
+
+        case 'iife':
+            prettyFormat = 'Standalone'
+            break
+
+        case 'umd':
+            prettyFormat = 'Universal'
+            break
+
+        default:
+            throw new RangeError( `Invalid switch parameter: ${ format }` )
+
+    }
+
+    return prettyFormat
+
+}
+
+function convertBannerIntoComment( banner ) {
+
+    let bannerCommented = '/**\n'
+    bannerCommented += ' * '
+    bannerCommented += banner.replaceAll( '\n', '\n * ' )
+    bannerCommented += '\n'
+    bannerCommented += ` * @desc    ${ packageDescription }\n`
+    bannerCommented += ' * @author  [Tristan Valcke]{@link https://github.com/Itee}\n'
+    bannerCommented += ' * @license [BSD-3-Clause]{@link https://opensource.org/licenses/BSD-3-Clause}\n'
+    bannerCommented += ' * \n'
+    bannerCommented += ' */'
+
+    return bannerCommented
+
+}
+
+function computeBannerFor( format ) {
+
+    const packageName    = getPrettyPackageName( '.' )
+    const packageVersion = getPrettyPackageVersion()
+    const prettyFormat   = getPrettyFormatForBanner( format )
+
+    const figText = figlet.textSync(
+        `${ packageName } ${ packageVersion } - ${ prettyFormat }`,
+        {
+            font:             'Tmplr',
+            horizontalLayout: 'default',
+            verticalLayout:   'default',
+            whitespaceBreak:  true,
+        }
+    )
+
+    return convertBannerIntoComment( figText )
+
+}
+
+function computeIntroFor( requestPackages ) {
+
+    return ''
+
+}
+
+/**
+ * Will create an appropriate configuration object for rollup, related to the given arguments.
+ *
+ * @generator
+ * @param options
+ * @return {Array.<json>} An array of rollup configuration
+ */
+function createRollupConfigs( options = undefined ) {
+
+    const _options = options ? options : {
+        input:     join( packageSourcesDirectory, `${ packageName }.js` ),
+        output:    packageBuildsDirectory,
+        formats:   [ 'esm', 'cjs', 'iife' ],
+        envs:      [ 'dev', 'prod' ],
+        treeshake: true
+    }
+
+    const {
+              input,
+              output,
+              formats,
+              envs,
+              treeshake
+          }        = _options
+    const name     = getPrettyPackageName( '.' )
+    const fileName = basename( input, '.js' )
+
+    const configs = []
+
+    for ( let formatIndex = 0, numberOfFormats = formats.length ; formatIndex < numberOfFormats ; ++formatIndex ) {
+
+        for ( let envIndex = 0, numberOfEnvs = envs.length ; envIndex < numberOfEnvs ; envIndex++ ) {
+
+            const env        = envs[ envIndex ]
+            const isProd     = ( env.includes( 'prod' ) )
+            const format     = formats[ formatIndex ]
+            const outputPath = ( isProd ) ? join( output, `${ fileName }.${ format }.min.js` ) : join( output, `${ fileName }.${ format }.js` )
+
+            configs.push( {
+                input:     input,
+                external:  ( format === 'cjs' ) ? [
+                    'fs'
+                ] : [],
+                plugins:   [
+                    replace( {
+                        defines: {
+                            IS_REMOVE_ON_BUILD:  false,
+                            IS_BACKEND_SPECIFIC: ( format === 'cjs' )
+                        }
+                    } ),
+                    commonjs( {
+                        include: 'node_modules/**'
+                    } ),
+                    nodeResolve( {
+                        preferBuiltins: true
+                    } ),
+                    isProd && terser()
+                ],
+                onwarn:    ( {
+                    loc,
+                    frame,
+                    message
+                } ) => {
+
+                    // Ignore some errors
+                    if ( message.includes( 'Circular dependency' ) ) { return }
+                    if ( message.includes( 'plugin uglify is deprecated' ) ) { return }
+
+                    if ( loc ) {
+                        process.stderr.write( `/!\\ ${ loc.file } (${ loc.line }:${ loc.column }) ${ frame } ${ message }\n` )
+                    } else {
+                        process.stderr.write( `/!\\ ${ message }\n` )
+                    }
+
+                },
+                treeshake: treeshake,
+                output:    {
+                    // core options
+                    file:    outputPath,
+                    format:  format,
+                    name:    name,
+                    globals: {},
+
+                    // advanced options
+                    paths:     {},
+                    banner:    ( isProd ) ? '' : computeBannerFor( format ),
+                    footer:    '',
+                    intro:     ( !isProd && format === 'iife' ) ? computeIntroFor() : '',
+                    outro:     '',
+                    sourcemap: !isProd,
+                    interop:   'auto',
+
+                    // danger zone
+                    exports: 'auto',
+                    amd:     {},
+                    indent:  '\t',
+                    strict:  true
+                }
+            } )
+
+        }
+
+    }
+
+    return configs
+
+}
+
+/// Log Management
 
 function logLoadingTask( filename ) {
 
+    if ( !isDebugging ) {
+        return
+    }
+
     const taskPath = relative( packageRootDirectory, filename )
     const taskName = basename( filename, '.task.mjs' )
 
@@ -365,13 +565,6 @@ class Indenter {
 ///
 
 export {
-    createDirectoryIfNotExist,
-    getJsonFrom,
-    getTaskConfigurationPathFor,
-    getTaskConfigurationFor,
-    createFile,
-    getFilesFrom,
-
     iteePackageRootDirectory,
     iteePackageJsonPath,
     iteePackageConfigurationsDirectory,
@@ -394,18 +587,37 @@ export {
     packageDocsDirectory,
     packageTutorialsDirectory,
     packageJsonPath,
+
     packageJson,
     packageName,
     packageVersion,
     packageDescription,
+    packageAuthor,
+    packageLicense,
     getPrettyPackageName,
     getPrettyPackageVersion,
     getPrettyNodeVersion,
     getPrettyNpmVersion,
 
+
+    createDirectoryIfNotExist,
+    getJsonFrom,
+    createFile,
+    getFilesFrom,
+
     getTasksFrom,
     serializeTasksFrom,
     parallelizeTasksFrom,
+
+    getTaskConfigurationPathFor,
+    getTaskConfigurationFor,
+
+    getPrettyFormatForBanner,
+    convertBannerIntoComment,
+    computeBannerFor,
+    computeIntroFor,
+    createRollupConfigs,
+
     logLoadingTask,
 
     IndenterFactory as Indenter

package/sources/builds/build.task.mjs

@@ -1,11 +1,11 @@
-import colors     from 'ansi-colors'
-import log        from 'fancy-log'
+import colors       from 'ansi-colors'
+import log          from 'fancy-log'
 import { basename } from 'node:path'
-import { rollup } from 'rollup'
+import { rollup }   from 'rollup'
 import {
     getTaskConfigurationFor,
     logLoadingTask
-}                 from '../_utils.mjs'
+}                   from '../_utils.mjs'
 
 logLoadingTask( import.meta.filename )