@nizza/devkit 0.1.0-alpha.1 → 0.1.0-alpha.11

package/dist/esm/shared/utils.mjs

@@ -0,0 +1,33 @@
+import { logger } from '@nx/devkit';
+import { randomBytes } from 'crypto';
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+
+/**
+ * Reads and parses the package.json file from the given project path.
+ *
+ * @param {string} projectPath - The path to the project.
+ * @returns {Record<string, any>} - The parsed package.json data.
+ *
+ * @example
+ * const pkgJsonData = getPkgJson('/path/to/project');
+ */ const getPkgJson = (projectPath)=>{
+    try {
+        const data = readFileSync(resolve(projectPath, './package.json'), 'utf-8');
+        return JSON.parse(data);
+    } catch (err) {
+        logger.error('Error reading or parsing package.json');
+        throw err;
+    }
+};
+/**
+ * Generates a random alphanumeric identifier of a specified length.
+ *
+ * @param {number} [length=8] - The length of the identifier to generate. Defaults to 8 if not specified.
+ * @returns {string} - A string representing a unique identifier.
+ */ function shortId(length = 8) {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    return Array.from(randomBytes(length), (b)=>chars[b % chars.length]).join('');
+}
+
+export { getPkgJson, shortId };

package/dist/esm/vite-utils/config-builder/configs/app.mjs

@@ -0,0 +1,11 @@
+const getAppConfig = (ctx)=>{
+    const { port } = ctx.projectConfig;
+    return {
+        server: {
+            port,
+            host: true
+        }
+    };
+};
+
+export { getAppConfig };

package/dist/{src/vite/config-builder/configs/base.js → esm/vite-utils/config-builder/configs/base.mjs}

@@ -1,40 +1,39 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "getBaseConfig", {
-    enumerable: true,
-    get: function() {
-        return getBaseConfig;
-    }
-});
-const _plugins = require("../plugins");
-const _shared = require("../shared");
-const _fs = require("fs");
-const _path = require("path");
+import { bundleAnalysisPlugin, basePlugins } from '../plugins.mjs';
+import { Target, ViteMode, Flag, Stage } from '../shared/types.mjs';
+import { getPlugins, when } from '../shared/utils/helpers.mjs';
+import 'minimatch';
+import '../../../shared/logger.mjs';
+import '@nx/devkit';
+import 'crypto';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import 'chalk';
+import 'mri';
+import 'vite';
+
 const getBaseConfig = (ctx)=>{
     const { commonConfig, projectConfig, viteCmd } = ctx;
     const { resolveEnvs, path } = projectConfig;
     const { stage, target, flags: cmdOverrides } = viteCmd;
-    const NODE_ENV = target === _shared.Target.BUILD ? _shared.ViteMode.PROD : _shared.ViteMode.DEV;
-    const sourcemap = cmdOverrides?.[_shared.Flag.SOURCEMAP] ?? stage !== _shared.Stage.PROD;
+    const NODE_ENV = target === Target.BUILD ? ViteMode.PROD : ViteMode.DEV;
+    const sourcemap = cmdOverrides?.[Flag.SOURCEMAP] ?? stage !== Stage.PROD;
     const envPrefix = `${commonConfig.envPrefix.toUpperCase()}_`;
     const omittedStages = resolveEnvs.local ? [
-        _shared.Stage.DEV
+        Stage.DEV
     ] : [
-        _shared.Stage.DEV,
-        _shared.Stage.LOCAL
+        Stage.DEV,
+        Stage.LOCAL
     ];
     const envPath = `environments/environment.${stage}.ts`;
     const fallbackEnvPath = `environments/environment.ts`;
     // Verify if the local Environment file is present
-    const envFilePath = (0, _fs.existsSync)((0, _path.resolve)(path, 'src', envPath)) ? envPath : fallbackEnvPath;
+    const envFilePath = existsSync(resolve(path, 'src', envPath)) ? envPath : fallbackEnvPath;
     return {
         envPrefix,
-        plugins: (0, _shared.getPlugins)(ctx, _plugins.basePlugins, _plugins.bundleAnalysisPlugin),
+        plugins: getPlugins(ctx, basePlugins, bundleAnalysisPlugin),
         resolve: {
             alias: {
-                ...(0, _shared.when)(resolveEnvs.default && !omittedStages.includes(stage), {
+                ...when(resolveEnvs.default && !omittedStages.includes(stage), {
                     '~env': envFilePath
                 })
             }
@@ -53,3 +52,5 @@ const getBaseConfig = (ctx)=>{
         }
     };
 };
+
+export { getBaseConfig };

package/dist/esm/vite-utils/config-builder/configs/index.mjs

@@ -0,0 +1,30 @@
+import { ProjectType } from '../shared/types.mjs';
+import '@nx/devkit';
+import 'path';
+import 'ramda';
+import '../../../shared/logger.mjs';
+import 'crypto';
+import 'fs';
+import 'minimatch';
+import 'chalk';
+import 'mri';
+import 'vite';
+import { getAppConfig } from './app.mjs';
+import { getBaseConfig } from './base.mjs';
+import { getLibConfig } from './lib.mjs';
+import { getScriptConfig } from './script.mjs';
+
+const getConfig = (ctx, type = null)=>{
+    switch(type){
+        case ProjectType.APP:
+            return getAppConfig(ctx);
+        case ProjectType.LIB:
+            return getLibConfig(ctx);
+        case ProjectType.SCRIPT:
+            return getScriptConfig(ctx);
+        default:
+            return getBaseConfig(ctx);
+    }
+};
+
+export { getAppConfig, getBaseConfig, getConfig, getLibConfig, getScriptConfig };

package/dist/{src/vite/config-builder/configs/lib.js → esm/vite-utils/config-builder/configs/lib.mjs}

@@ -1,34 +1,30 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "getLibConfig", {
-    enumerable: true,
-    get: function() {
-        return getLibConfig;
-    }
-});
-const _path = require("path");
-const _plugins = require("../plugins");
-const _shared = require("../shared");
+import { resolve } from 'path';
+import { dtsPlugin } from '../plugins.mjs';
+import '../shared/types.mjs';
+import { when, getPlugins } from '../shared/utils/helpers.mjs';
+import { getExternalDependencies } from '../shared/utils/projectConfig.mjs';
+import 'chalk';
+import 'mri';
+import 'vite';
+
 const getLibConfig = (ctx)=>{
     const { projectConfig, commonConfig } = ctx;
     const { externalizeLibGlob = [] } = commonConfig;
     const { name, path, externalizeLibs } = projectConfig;
-    const entry = (0, _path.resolve)(path, projectConfig.entry ?? 'src/index.ts');
+    const entry = resolve(path, projectConfig.entry ?? 'src/index.ts');
     const defaultExternals = {
         react: true,
         'react-dom': true,
         'react/jsx-runtime': true
     };
     // Get external dependencies based on glob patterns
-    const externalDeps = (0, _shared.getExternalDependencies)(path, [
+    const externalDeps = getExternalDependencies(path, [
         ...externalizeLibGlob,
         ...externalizeLibs.glob
     ]);
     const rollupExternal = [
         ...externalDeps,
-        ...Object.keys((0, _shared.when)(externalizeLibs.default, defaultExternals))
+        ...Object.keys(when(externalizeLibs.default, defaultExternals))
     ];
     const rollupGlobals = {
         react: 'React',
@@ -36,7 +32,7 @@ const getLibConfig = (ctx)=>{
         'react/jsx-runtime': 'ReactJsxRuntime'
     };
     return {
-        plugins: (0, _shared.getPlugins)(ctx, _plugins.dtsPlugin),
+        plugins: getPlugins(ctx, dtsPlugin),
         build: {
             lib: {
                 name,
@@ -49,9 +45,11 @@ const getLibConfig = (ctx)=>{
             rollupOptions: {
                 external: rollupExternal,
                 output: {
-                    globals: (0, _shared.when)(externalizeLibs.default, rollupGlobals)
+                    globals: when(externalizeLibs.default, rollupGlobals)
                 }
             }
         }
     };
 };
+
+export { getLibConfig };

package/dist/esm/vite-utils/config-builder/configs/script.mjs

@@ -0,0 +1,44 @@
+import { resolve } from 'path';
+import { injectCssByJsPlugin, injectCssIntoShadowDomPlugin } from '../plugins.mjs';
+import '../shared/types.mjs';
+import { getPlugins, chunkName } from '../shared/utils/helpers.mjs';
+import 'minimatch';
+import '../../../shared/logger.mjs';
+import '@nx/devkit';
+import 'crypto';
+import 'fs';
+import 'chalk';
+import 'mri';
+import 'vite';
+
+const getScriptConfig = (ctx)=>{
+    const { commonConfig, projectConfig } = ctx;
+    const { envPrefix } = commonConfig;
+    const { port } = projectConfig;
+    const { name, path, fileName, chunkPrefix } = projectConfig;
+    const entry = resolve(path, projectConfig.entry ?? 'src/main');
+    return {
+        plugins: getPlugins(ctx, injectCssIntoShadowDomPlugin, injectCssByJsPlugin),
+        server: {
+            port,
+            host: true
+        },
+        build: {
+            lib: {
+                name,
+                entry,
+                fileName,
+                formats: [
+                    'es'
+                ]
+            },
+            rollupOptions: {
+                output: {
+                    chunkFileNames: chunkName(`${envPrefix}-${chunkPrefix}`)
+                }
+            }
+        }
+    };
+};
+
+export { getScriptConfig };

package/dist/esm/vite-utils/config-builder/main.mjs

@@ -0,0 +1,40 @@
+import { defineConfig } from 'vite';
+import { currentLogLevel, LogLevel, logger } from '../../shared/logger.mjs';
+import { getPkgJson } from '../../shared/utils.mjs';
+import { getConfig } from './configs/index.mjs';
+import './shared/types.mjs';
+import '@nx/devkit';
+import 'path';
+import 'ramda';
+import { initializeConfig, mergeConfigs } from './shared/utils/projectConfig.mjs';
+import 'chalk';
+import 'mri';
+
+/**
+ * Builds the configuration based on common and project-specific configurations.
+ *
+ * @param {CommonProjectConfig} commonConfig - The common configuration.
+ * @returns - Returns a function that accepts a project configuration and returns the Vite configuration.
+ */ const createConfigBuilder = (commonConfig)=>(projectConfig)=>{
+        try {
+            const localPkgJson = getPkgJson(projectConfig.path);
+            const { cfg, viteCmd } = initializeConfig(commonConfig, projectConfig, localPkgJson);
+            const isDebug = currentLogLevel === LogLevel.DEBUG;
+            const { type, overrides } = cfg;
+            const ctx = {
+                viteCmd,
+                localPkgJson,
+                commonConfig,
+                projectConfig: cfg
+            };
+            const defaultConfig = mergeConfigs(getConfig(ctx), getConfig(ctx, type));
+            const config = mergeConfigs(defaultConfig, overrides);
+            if (isDebug) logger.debug('Generated config:', config);
+            return defineConfig(config);
+        } catch (err) {
+            logger.error('buildConfig unexpected error:');
+            throw err;
+        }
+    };
+
+export { createConfigBuilder };

package/dist/esm/vite-utils/config-builder/plugins.mjs

@@ -0,0 +1,87 @@
+import { viteCommonjs } from '@originjs/vite-plugin-commonjs';
+import graphql from '@rollup/plugin-graphql';
+import react from '@vitejs/plugin-react-swc';
+import { resolve } from 'path';
+import { visualizer } from 'rollup-plugin-visualizer';
+import cssInjectedByJsPlugin from 'vite-plugin-css-injected-by-js';
+import dts from 'vite-plugin-dts';
+import tsconfigPaths from 'vite-tsconfig-paths';
+import 'vite';
+import { injectCssIntoShadowDom } from '../plugins/shadow-dom-inject-css/index.mjs';
+import { Stage, Flag } from './shared/types.mjs';
+import { getNxTsConfigPaths } from './shared/utils/helpers.mjs';
+import 'minimatch';
+import '../../shared/logger.mjs';
+import '@nx/devkit';
+import 'crypto';
+import 'fs';
+import 'chalk';
+import 'mri';
+
+/**
+ * Base plugins configuration for apps and libs.
+ *
+ * Plugins configured:
+ * - vite-tsconfig-paths
+ * - @originjs/vite-plugin-commonjs
+ * - @rollup/plugin-graphql
+ * - @vitejs/plugin-react-swc
+ */ const basePlugins = {
+    generate: ()=>{
+        const projects = getNxTsConfigPaths();
+        return [
+            tsconfigPaths({
+                projects
+            }),
+            viteCommonjs(),
+            graphql(),
+            react({
+                tsDecorators: true
+            })
+        ];
+    }
+};
+/**
+ * Plugin configuration for generating type declarations using vite-plugin-dts.
+ */ const dtsPlugin = {
+    generate: ({ projectConfig })=>[
+            dts({
+                tsconfigPath: resolve(projectConfig.path, 'tsconfig.lib.json'),
+                outDir: resolve(projectConfig.path, 'dist'),
+                entryRoot: resolve(projectConfig.path, 'src')
+            })
+        ],
+    condition: ({ projectConfig, viteCmd })=>viteCmd.stage !== Stage.LOCAL && projectConfig.dts == null ? true : !!projectConfig.dts
+};
+/**
+ * Plugin configuration for bundle analysis using rollup-plugin-visualizer.
+ */ const bundleAnalysisPlugin = {
+    generate: ({ projectConfig })=>[
+            visualizer({
+                emitFile: true,
+                projectRoot: resolve(projectConfig.path, 'dist'),
+                filename: 'bundle-analysis.html'
+            })
+        ],
+    condition: ({ viteCmd })=>viteCmd.flags?.[Flag.ANALYZE] === 'true'
+};
+/**
+ * Plugin configuration for injecting CSS into JS files
+ * using vite-plugin-css-injected-by-js.
+ */ const injectCssByJsPlugin = {
+    generate: (_)=>[
+            cssInjectedByJsPlugin()
+        ],
+    condition: ({ projectConfig })=>!projectConfig.shadowDom
+};
+/**
+ * Plugin configuration for injecting CSS into Shadow Dom.
+ * using local plugin.
+ */ const injectCssIntoShadowDomPlugin = {
+    generate: (_)=>[
+            injectCssIntoShadowDom()
+        ],
+    condition: ({ projectConfig })=>projectConfig.shadowDom
+};
+
+export { basePlugins, bundleAnalysisPlugin, dtsPlugin, injectCssByJsPlugin, injectCssIntoShadowDomPlugin };

package/dist/{src/vite/config-builder/shared/types.js → esm/vite-utils/config-builder/shared/types.mjs}

@@ -1,30 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    Flag: function() {
-        return Flag;
-    },
-    ProjectType: function() {
-        return ProjectType;
-    },
-    Stage: function() {
-        return Stage;
-    },
-    Target: function() {
-        return Target;
-    },
-    ViteMode: function() {
-        return ViteMode;
-    }
-});
 var ViteMode;
 (function(ViteMode) {
     ViteMode["PROD"] = "production";
@@ -56,3 +29,5 @@ var Target;
     Target["PREVIEW"] = "preview";
     Target["SERVE"] = "serve";
 })(Target || (Target = {}));
+
+export { Flag, ProjectType, Stage, Target, ViteMode };

package/dist/{src/vite/config-builder/shared/utils/helpers.d.ts → esm/vite-utils/config-builder/shared/utils/helpers.mjs}

@@ -1,16 +1,9 @@
-import type { PreRenderedChunk } from 'rollup';
-import type { PluginOption } from 'vite';
-import type { Context, PluginConfig } from '../types';
-/**
- * Generates a short ID string.
- *
- * @param {number} length - The length of the ID to generate.
- * @returns {string} - The generated ID.
- *
- * @example
- * const id = shortId(10);  // Outputs: "Aj3_Dk7_2j"
- */
-export declare const shortId: (length: number) => string;
+import { readCachedProjectGraph } from '@nx/devkit';
+import { resolve } from 'path';
+import * as R from 'ramda';
+import '../../../../shared/logger.mjs';
+import { shortId } from '../../../../shared/utils.mjs';
+
 /**
  * Deeply merges two objects, combining their properties.
  *
@@ -22,8 +15,15 @@ export declare const shortId: (length: number) => string;
  * const obj1 = { a: 1, b: { c: 2 } };
  * const obj2 = { b: { d: 3 } };
  * const merged = deepMerge(obj1, obj2);  // Outputs: { a: 1, b: { c: 2, d: 3 } }
- */
-export declare function deepMerge(v1: Record<string, any>, v2: Record<string, any>): Record<string, any>;
+ */ function deepMerge(v1, v2) {
+    if (Array.isArray(v1) && Array.isArray(v2)) {
+        return R.uniq(R.concat(v1, v2));
+    } else if (typeof v1 === 'object' && typeof v2 === 'object' && !R.isNil(v1) && !R.isNil(v2)) {
+        return R.mergeWith(deepMerge, v1, v2);
+    } else {
+        return v2;
+    }
+}
 /**
  * Generates a name for js files.
  *
@@ -33,8 +33,11 @@ export declare function deepMerge(v1: Record<string, any>, v2: Record<string, an
  * @example
  * const generateChunkName = chunkName('prefix');
  * const name = generateChunkName({ name: 'example' });  // Outputs: "prefix-example-Aj3_Dk7_2j.js"
- */
-export declare const chunkName: (prefix?: string) => (x: PreRenderedChunk) => string;
+ */ const chunkName = (prefix)=>(x)=>{
+        const nameWithoutUnderscore = x.name.replace(/_/g, '');
+        const pre = prefix ? `${prefix}-` : '';
+        return `${pre}${nameWithoutUnderscore}-${shortId(8)}.js`;
+    };
 /**
  * Returns the given object if the condition is true, otherwise returns null.
  *
@@ -46,15 +49,15 @@ export declare const chunkName: (prefix?: string) => (x: PreRenderedChunk) => st
  * const obj = { a: 1 };
  * const result = when(true, obj);  // Outputs: { a: 1 }
  * const result2 = when(false, obj);  // Outputs: {}
- */
-export declare const when: (condition: any, obj: Record<string, any>) => Record<string, any>;
+ */ const when = (condition, obj)=>condition ? obj : {};
 /**
  * Filters and generates plugin configurations based on conditions and the provided context.
  *
  * @param {Context} ctx - The main configuration object.
  * @returns {any[]} - An array of generated plugin configurations.
- */
-export declare const getPlugins: (ctx: Context, ...pluginConfigs: PluginConfig[]) => PluginOption[];
+ */ const getPlugins = (ctx, ...pluginConfigs)=>pluginConfigs// Filters the plugins based on conditions
+    .filter((p)=>!p.condition || p.condition(ctx))// Generates the configuration of each plugin and flattens the resulting array
+    .flatMap((p)=>p.generate(ctx));
 /**
  * Gets the paths to the tsconfig files for all relevant projects.
  *
@@ -76,6 +79,12 @@ export declare const getPlugins: (ctx: Context, ...pluginConfigs: PluginConfig[]
  * console.log(tsConfigPaths);
  * // Output:
  * // ['apps/my-app/tsconfig.app.json', 'libs/my-lib/tsconfig.lib.json']
- */
-export declare const getNxTsConfigPaths: () => string[];
-//# sourceMappingURL=helpers.d.ts.map
+ */ const getNxTsConfigPaths = ()=>{
+    const isValid = (p)=>p.data.root.startsWith('apps/') || p.data.root.startsWith('libs/');
+    const getTsConfigPath = (p)=>resolve(p.data.root, `tsconfig.${p.type === 'app' ? 'app' : 'lib'}.json`);
+    const graph = readCachedProjectGraph();
+    const projects = graph.nodes;
+    return Object.values(projects).filter(isValid).map(getTsConfigPath);
+};
+
+export { chunkName, deepMerge, getNxTsConfigPaths, getPlugins, when };

package/dist/esm/vite-utils/config-builder/shared/utils/projectConfig.mjs

@@ -0,0 +1,109 @@
+import { minimatch } from 'minimatch';
+import { LogLevel, logger, setLogLevel } from '../../../../shared/logger.mjs';
+import { getPkgJson } from '../../../../shared/utils.mjs';
+import { Flag } from '../types.mjs';
+import { deepMerge } from './helpers.mjs';
+import { getViteCommand } from './viteCommand.mjs';
+
+/**
+ * Initializes the project configuration with default values.
+ *
+ * @example
+ * const config = { type: ProjectType.APP, path: '/path/to/project', viteEnv: { mode: ViteMode.DEV } };
+ * const initializedConfig = initializeConfig(config);
+ */ const initializeConfig = (ccfg, pcfg, localPkgJson)=>{
+    const { envPrefix } = ccfg;
+    const localPkgName = localPkgJson['name'];
+    const { name = localPkgName, overrides = {}, shadowDom = false, chunkPrefix = getInitials(localPkgName), resolveEnvs = {
+        default: true,
+        local: true
+    }, fileName = `${envPrefix}-${chunkPrefix}-index`, externalizeLibs = {
+        default: true,
+        glob: []
+    } } = pcfg;
+    const viteCmd = getViteCommand(pcfg.viteEnv.mode);
+    const isVerbose = Object.keys(viteCmd.flags).some((x)=>[
+            Flag.VERBOSE,
+            Flag.VERBOSE_ALIAS
+        ].includes(x));
+    const logLevel = isVerbose ? LogLevel.DEBUG : pcfg.logLevel ?? LogLevel.INFO;
+    setLogLevel(logLevel);
+    return {
+        viteCmd,
+        cfg: {
+            ...pcfg,
+            name,
+            fileName,
+            logLevel,
+            overrides,
+            chunkPrefix,
+            shadowDom,
+            resolveEnvs,
+            externalizeLibs: externalizeLibs
+        }
+    };
+};
+/**
+ * Handles merging configurations and logs any errors.
+ *
+ * @param {UserConfig} defaultConfig - The default configuration.
+ * @param {UserConfig} overrides - The overrides configuration.
+ * @returns {UserConfig} - The merged configuration.
+ */ const mergeConfigs = (defaultConfig, overrides)=>{
+    try {
+        return deepMerge(defaultConfig, overrides);
+    } catch (err) {
+        logger.error('Error merging vite configs: ', err);
+        return defaultConfig;
+    }
+};
+/**
+ * Resolves glob patterns to actual package names found in package.json dependencies.
+ * This function is used to determine which packages should be treated as external
+ * in a Rollup or Vite build configuration.
+ *
+ * @param {string} path - The base path where package.json is located.
+ * @param {string | string[]} globs - A glob pattern or an array of glob patterns to match dependencies against.
+ * @returns {string[]} An array of package names that match the given glob patterns.
+ *
+ * @example
+ * // Example of using `getExternalDependencies` to find all dependencies starting with "my-lib" and "lodash"
+ * const projectPath = '/path/to/project';
+ * const globs = ['my-lib*', 'lodash'];
+ * const externalDependencies = getExternalDependencies(projectPath, globs);
+ * console.log(externalDependencies);
+ * // Output might be: ['my-lib/utils', 'my-lib/core', 'lodash']
+ */ const getExternalDependencies = (path, globs = [])=>{
+    const pkgJson = getPkgJson(path); // Assumes getLocalPkgJson is a function that reads and parses package.json
+    const dependencies = Object.keys(pkgJson.dependencies || {});
+    const globPatterns = Array.isArray(globs) ? globs : [
+        globs
+    ];
+    return dependencies.filter((dep)=>globPatterns.some((pattern)=>minimatch(dep, pattern)));
+};
+/**
+ * Generates a string of initials based on the input string,
+ * following certain rules:
+ * 1. A word is considered as a sequence of characters
+ * separated by hyphens.
+ * 2. If the string contains '@', any characters before
+ * and including the next '/' are ignored.
+ * 3. The first character of each word is taken to form
+ * the initials.
+ *
+ * @param {string} input - The input string from which to generate the initials.
+ * @returns {string} The initials formed by taking the first character
+ * of each word, after applying the specified rules.
+ *
+ * @example
+ * getInitials("player-script"); // returns "ps"
+ * getInitials("ssv-admin"); // returns "sa"
+ * getInitials("@nizza/customize-live"); // returns "cl"
+ */ function getInitials(input) {
+    const cleanedInput = input.includes('@') ? input.split('/')[1] : input;
+    const words = cleanedInput?.split('-');
+    const initials = words?.map((word)=>word.charAt(0)).join('');
+    return initials ?? '';
+}
+
+export { getExternalDependencies, getInitials, initializeConfig, mergeConfigs };