@yamato-daiwa/automation 0.0.7 → 0.0.8

package/EntryPoint.js

@@ -73,11 +73,11 @@ const path_1 = __importDefault(__webpack_require__(/*! path */ "path"));
 const yamljs_1 = __importDefault(__webpack_require__(/*! yamljs */ "yamljs"));
 class EntryPoint {
     static interpretAndExecuteConsoleCommand(rawConsoleCommand) {
-        const parsedCommand = es_extensions_nodejs_1.ConsoleCommandsParser.parse(rawConsoleCommand, ApplicationConsoleLineInterface_1.default.specification);
+        const parsedConsoleCommand = es_extensions_nodejs_1.ConsoleCommandsParser.parse(rawConsoleCommand, ApplicationConsoleLineInterface_1.default.specification);
         if (true) {
             PoliteErrorsMessagesBuilder_1.default.setTechnicalDetailsOnlyMode();
         }
-        switch (parsedCommand.phrase) {
+        switch (parsedConsoleCommand.phrase) {
             case ApplicationConsoleLineInterface_1.default.CommandPhrases.buildProject: {
                 const consumingProjectRootDirectoryAbsolutePath = process.cwd();
                 const rawConfigFileAbsolutePath = path_1.default.resolve(consumingProjectRootDirectoryAbsolutePath, CONFIG_FILE_DEFAULT_NAME_WITH_EXTENSION_1.default);
@@ -98,8 +98,8 @@ class EntryPoint {
                 ProjectBuilder_1.default.buildProject({
                     consumingProjectRootDirectoryAbsolutePath,
                     projectBuildingConfig__fromConsole: {
-                        projectBuildingMode: parsedCommand.projectBuildingMode,
-                        selectiveExecutionID: parsedCommand.selectiveExecutionID
+                        projectBuildingMode: parsedConsoleCommand.projectBuildingMode,
+                        selectiveExecutionID: parsedConsoleCommand.selectiveExecutionID
                     },
                     rawConfigFromFile
                 });
@@ -1507,8 +1507,7 @@ var AssetsProcessingSettingsGenericProperties__FromFile__RawValid;
                                         buildingModeDependent.outputBaseDirectoryRelativePath.KEY]: {
                                         newName: "outputBaseDirectoryRelativePath",
                                         type: String,
-                                        required: true,
-                                        minimalCharactersCount: 1
+                                        required: true
                                     },
                                     [assetsProcessingSettingsGenericPropertiesLocalization.assetsGroups.buildingModeDependent.revisioning.KEY]: {
                                         newName: "revisioning",
@@ -3025,6 +3024,19 @@ const ProjectBuildingConfigFromFileDefaultLocalization = {
                     KEY: "linting",
                     disable: { KEY: "disable" }
                 },
+                distributing: {
+                    KEY: "distributing",
+                    exposingOfExportsFromEntryPoints: {
+                        KEY: "exposingOfExportsFromEntryPoints",
+                        mustExpose: { KEY: "mustExpose" },
+                        namespace: { KEY: "namespace" }
+                    },
+                    typeScriptTypesDeclarations: {
+                        KEY: "typeScriptTypesDeclarations",
+                        mustGenerate: { KEY: "mustGenerate" },
+                        fileNameWithoutExtension: { KEY: "outputRelativePath" }
+                    }
+                },
                 buildingModeDependent: {
                     KEY: "buildingModeDependent",
                     outputBaseDirectoryRelativePath: { KEY: "outputBaseDirectoryRelativePath" },
@@ -3520,6 +3532,7 @@ class ECMA_ScriptLogicProcessingRawSettingsNormalizer extends SourceCodeProcessi
         };
     }
     completeEntryPointsGroupNormalizedSettingsCommonPropertiesUntilECMA_ScriptLogicEntryPointsGroupNormalizedSettings(entryPointsGroupGenericSettings__normalized, entryPointsGroupSettings__rawValid) {
+        const distributingSettings__rawValid = entryPointsGroupSettings__rawValid.distributing;
         return {
             ...entryPointsGroupGenericSettings__normalized,
             targetRuntime: (() => {
@@ -3545,6 +3558,11 @@ class ECMA_ScriptLogicProcessingRawSettingsNormalizer extends SourceCodeProcessi
                             }
                         };
                     }
+                    case SupportedECMA_ScriptRuntimesTypes.pug: {
+                        return {
+                            type: SupportedECMA_ScriptRuntimesTypes.pug
+                        };
+                    }
                 }
             })(),
             entryPointsSourceFilesTopDirectoryOrSingleFilePathAliasForReferencingFromHTML: `${ECMA_ScriptLogicProcessingSettings__Default_1.default.filePathAliasNotation}` +
@@ -3573,7 +3591,22 @@ class ECMA_ScriptLogicProcessingRawSettingsNormalizer extends SourceCodeProcessi
                 contentHashPostfixSeparator: entryPointsGroupSettings__rawValid.buildingModeDependent[this.consumingProjectBuildingMode].
                     revisioning?.contentHashPostfixSeparator ??
                     ECMA_ScriptLogicProcessingSettings__Default_1.default.revisioning.contentHashPostfixSeparator
-            }
+            },
+            ...(0, es_extensions_1.isNotUndefined)(distributingSettings__rawValid) ? {
+                distributing: {
+                    exposingOfExportsFromEntryPoints: {
+                        mustExpose: distributingSettings__rawValid.exposingOfExportsFromEntryPoints?.mustExpose ??
+                            ECMA_ScriptLogicProcessingSettings__Default_1.default.distributing.exposingOfExportsFromEntryPoints.mustExpose,
+                        namespace: distributingSettings__rawValid.exposingOfExportsFromEntryPoints?.namespace
+                    },
+                    typeScriptTypesDeclarations: {
+                        mustGenerate: distributingSettings__rawValid.typeScriptTypesDeclarations?.mustGenerate ??
+                            ECMA_ScriptLogicProcessingSettings__Default_1.default.distributing.typeScriptTypesDeclarations.mustGenerate,
+                        fileNameWithoutExtension: distributingSettings__rawValid.typeScriptTypesDeclarations?.fileNameWithoutExtension ??
+                            ECMA_ScriptLogicProcessingSettings__Default_1.default.distributing.typeScriptTypesDeclarations.fileNameWithoutExtension
+                    }
+                }
+            } : null
         };
     }
 }
@@ -3599,6 +3632,7 @@ var ECMA_ScriptLogicProcessingRestrictions;
         SupportedECMA_ScriptRuntimesTypes["browser"] = "BROWSER";
         SupportedECMA_ScriptRuntimesTypes["webWorker"] = "WEB_WORKER";
         SupportedECMA_ScriptRuntimesTypes["nodeJS"] = "NODEJS";
+        SupportedECMA_ScriptRuntimesTypes["pug"] = "PUG";
     })(SupportedECMA_ScriptRuntimesTypes = ECMA_ScriptLogicProcessingRestrictions.SupportedECMA_ScriptRuntimesTypes || (ECMA_ScriptLogicProcessingRestrictions.SupportedECMA_ScriptRuntimesTypes = {}));
 })(ECMA_ScriptLogicProcessingRestrictions || (ECMA_ScriptLogicProcessingRestrictions = {}));
 exports["default"] = ECMA_ScriptLogicProcessingRestrictions;
@@ -3690,6 +3724,15 @@ exports["default"] = {
     linting: {
         mustExecute: false,
         isDisabledForEntryPointGroups: false
+    },
+    distributing: {
+        exposingOfExportsFromEntryPoints: {
+            mustExpose: false
+        },
+        typeScriptTypesDeclarations: {
+            mustGenerate: false,
+            fileNameWithoutExtension: "index.d.ts"
+        }
     }
 };
 
@@ -3710,7 +3753,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 /* --- Restrictions ------------------------------------------------------------------------------------------------- */
 const ECMA_ScriptLogicProcessingRestrictions_1 = __importDefault(__webpack_require__(/*! @ECMA_ScriptProcessing/ECMA_ScriptLogicProcessingRestrictions */ "./ProjectBuilding/SourceCodeProcessing/ECMA_Script/ECMA_ScriptLogicProcessingRestrictions.ts"));
 var SupportedECMA_ScriptRuntimesTypes = ECMA_ScriptLogicProcessingRestrictions_1.default.SupportedECMA_ScriptRuntimesTypes;
-/* --- Default settings ----------------------------------------------------------------------------------------------- */
+/* --- Default settings --------------------------------------------------------------------------------------------- */
 const ConsumingProjectPreDefinedBuildingModes_1 = __importDefault(__webpack_require__(/*! @ProjectBuilding/Common/Defaults/ConsumingProjectPreDefinedBuildingModes */ "./ProjectBuilding/Common/Defaults/ConsumingProjectPreDefinedBuildingModes.ts"));
 const es_extensions_1 = __webpack_require__(/*! @yamato-daiwa/es-extensions */ "@yamato-daiwa/es-extensions");
 /* eslint-disable-next-line @typescript-eslint/no-redeclare --
@@ -3822,6 +3865,51 @@ var ECMA_ScriptLogicProcessingSettings__FromFile__RawValid;
                                 }
                             }
                         },
+                        [ECMA_ScriptProcessingLocalization.entryPointsGroups.distributing.KEY]: {
+                            newName: "distributing",
+                            type: Object,
+                            required: false,
+                            properties: {
+                                [ECMA_ScriptProcessingLocalization.entryPointsGroups.distributing.exposingOfExportsFromEntryPoints.KEY]: {
+                                    newName: "exposingOfExportsFromEntryPoints",
+                                    type: Object,
+                                    required: false,
+                                    properties: {
+                                        [ECMA_ScriptProcessingLocalization.entryPointsGroups.distributing.
+                                            exposingOfExportsFromEntryPoints.mustExpose.KEY]: {
+                                            newName: "mustExpose",
+                                            type: Boolean,
+                                            required: true
+                                        },
+                                        [ECMA_ScriptProcessingLocalization.entryPointsGroups.distributing.
+                                            exposingOfExportsFromEntryPoints.namespace.KEY]: {
+                                            newName: "namespace",
+                                            type: String,
+                                            required: false
+                                        }
+                                    }
+                                },
+                                [ECMA_ScriptProcessingLocalization.entryPointsGroups.distributing.typeScriptTypesDeclarations.KEY]: {
+                                    newName: "typeScriptTypesDeclarations",
+                                    type: Object,
+                                    required: false,
+                                    properties: {
+                                        [ECMA_ScriptProcessingLocalization.entryPointsGroups.distributing.
+                                            typeScriptTypesDeclarations.mustGenerate.KEY]: {
+                                            newName: "mustGenerate",
+                                            type: Boolean,
+                                            required: false
+                                        },
+                                        [ECMA_ScriptProcessingLocalization.entryPointsGroups.distributing.
+                                            typeScriptTypesDeclarations.fileNameWithoutExtension.KEY]: {
+                                            newName: "fileNameWithoutExtension",
+                                            type: String,
+                                            required: false
+                                        }
+                                    }
+                                }
+                            }
+                        },
                         [ECMA_ScriptProcessingLocalization.entryPointsGroups.buildingModeDependent.KEY]: {
                             newName: "buildingModeDependent",
                             type: es_extensions_1.RawObjectDataProcessor.ValuesTypesIDs.associativeArrayOfUniformTypeValues,
@@ -3842,8 +3930,7 @@ var ECMA_ScriptLogicProcessingSettings__FromFile__RawValid;
                                         buildingModeDependent.outputBaseDirectoryRelativePath.KEY]: {
                                         newName: "outputBaseDirectoryRelativePath",
                                         type: String,
-                                        required: true,
-                                        minimalCharactersCount: 1
+                                        required: true
                                     },
                                     [ECMA_ScriptProcessingLocalization.entryPointsGroups.buildingModeDependent.revisioning.KEY]: {
                                         newName: "revisioning",
@@ -4069,6 +4156,7 @@ const webpack_1 = __importDefault(__webpack_require__(/*! webpack */ "webpack"))
 const vue_loader_1 = __webpack_require__(/*! vue-loader */ "vue-loader");
 const fork_ts_checker_webpack_plugin_1 = __importDefault(__webpack_require__(/*! fork-ts-checker-webpack-plugin */ "fork-ts-checker-webpack-plugin"));
 const eslint_webpack_plugin_1 = __importDefault(__webpack_require__(/*! eslint-webpack-plugin */ "eslint-webpack-plugin"));
+const typescript_declaration_webpack_plugin_1 = __importDefault(__webpack_require__(/*! typescript-declaration-webpack-plugin */ "typescript-declaration-webpack-plugin"));
 const webpack_node_externals_1 = __importDefault(__webpack_require__(/*! webpack-node-externals */ "webpack-node-externals"));
 /* --- General utils ------------------------------------------------------------------------------------------------ */
 const path_1 = __importDefault(__webpack_require__(/*! path */ "path"));
@@ -4119,6 +4207,12 @@ class WebpackConfigGenerator {
             return null;
         }
         const webpackPublicPath = this.computePublicPathIfPossible(entryPointsGroupSettings);
+        const isBrowserJS_LibraryWillBeBuilt = entryPointsGroupSettings.distributing?.exposingOfExportsFromEntryPoints.mustExpose === true &&
+            entryPointsGroupSettings.targetRuntime.type === SupportedECMA_ScriptRuntimesTypes.browser;
+        const isNodeJS_LibraryWillBeBuilt = entryPointsGroupSettings.distributing?.exposingOfExportsFromEntryPoints.mustExpose === true &&
+            entryPointsGroupSettings.targetRuntime.type === SupportedECMA_ScriptRuntimesTypes.nodeJS;
+        const isPugLibraryWillBeBuilt = entryPointsGroupSettings.distributing?.exposingOfExportsFromEntryPoints.mustExpose === true &&
+            entryPointsGroupSettings.targetRuntime.type === SupportedECMA_ScriptRuntimesTypes.pug;
         return {
             name: entryPointsGroupSettings.ID,
             /* [ Webpack theory ] In this case, path separators must be operating system dependent, otherwise following error
@@ -4127,7 +4221,8 @@ class WebpackConfigGenerator {
             /* [ Reference ] https://webpack.js.org/configuration/target/ */
             target: (() => {
                 switch (entryPointsGroupSettings.targetRuntime.type) {
-                    case SupportedECMA_ScriptRuntimesTypes.browser: {
+                    case SupportedECMA_ScriptRuntimesTypes.browser:
+                    case SupportedECMA_ScriptRuntimesTypes.pug: {
                         return "web";
                     }
                     case SupportedECMA_ScriptRuntimesTypes.webWorker: {
@@ -4150,13 +4245,25 @@ class WebpackConfigGenerator {
                     `[name]${entryPointsGroupSettings.revisioning.contentHashPostfixSeparator}[contenthash].js` : "[name].js",
                 chunkFilename: entryPointsGroupSettings.revisioning.mustExecute ?
                     `[id]${entryPointsGroupSettings.revisioning.contentHashPostfixSeparator}[contenthash].js` :
-                    "[id][contenthash].js"
-                /* [ Reference ] https://webpack.js.org/guides/author-libraries/ */
-                /* ...isNotUndefined(entryPointsGroupSettings.entryPointsImportsSharing) ? {
-                     name: entryPointsGroupSettings.entryPointsImportsSharing.namespace,
-                     ...entryPointsGroupSettings.entryPointsImportsSharing.crossEnvironmental ? { type: "umd" } : null
-                   } : {} */
+                    "[id][contenthash].js",
+                ...entryPointsGroupSettings.distributing?.exposingOfExportsFromEntryPoints.mustExpose === true ? {
+                    library: {
+                        type: (() => {
+                            switch (entryPointsGroupSettings.targetRuntime.type) {
+                                case SupportedECMA_ScriptRuntimesTypes.browser: return "module";
+                                case SupportedECMA_ScriptRuntimesTypes.webWorker: return "module";
+                                case SupportedECMA_ScriptRuntimesTypes.nodeJS: return "commonjs";
+                                case SupportedECMA_ScriptRuntimesTypes.pug: return "umd";
+                            }
+                        })(),
+                        ...isNodeJS_LibraryWillBeBuilt || isPugLibraryWillBeBuilt ? {
+                            name: entryPointsGroupSettings.distributing.exposingOfExportsFromEntryPoints.namespace
+                        } : null
+                    }
+                } : null,
+                ...isPugLibraryWillBeBuilt ? { globalObject: "globalThis" } : null
             },
+            ...isBrowserJS_LibraryWillBeBuilt ? { experiments: { outputModule: true } } : null,
             mode: this.masterConfigRepresentative.isDevelopmentBuildingMode ? "development" : "production",
             watch: this.masterConfigRepresentative.isDevelopmentBuildingMode,
             devtool: this.masterConfigRepresentative.isDevelopmentBuildingMode ? "eval" : false,
@@ -4317,7 +4424,10 @@ class WebpackConfigGenerator {
                     extensions: ["js", "ts", "vue"],
                     failOnError: this.masterConfigRepresentative.isProductionBuildingMode,
                     failOnWarning: this.masterConfigRepresentative.isProductionBuildingMode
-                })
+                }),
+                ...(0, es_extensions_1.isNotUndefined)(entryPointsGroupSettings.distributing) &&
+                    entryPointsGroupSettings.distributing.typeScriptTypesDeclarations.mustGenerate ?
+                    [new typescript_declaration_webpack_plugin_1.default({})] : []
             ],
             optimization: {
                 minimize: this.masterConfigRepresentative.isProductionBuildingMode,
@@ -4738,8 +4848,7 @@ var MarkupProcessingSettings__FromFile__RawValid;
                                     [markupProcessingLocalization.entryPointsGroups.buildingModeDependent.outputBaseDirectoryRelativePath.KEY]: {
                                         newName: "outputBaseDirectoryRelativePath",
                                         type: String,
-                                        required: true,
-                                        minimalCharactersCount: 1
+                                        required: true
                                     }
                                 }
                             }
@@ -5893,8 +6002,7 @@ var StylesProcessingSettings__FromFile__RawValid;
                                     [stylesProcessingLocalization.entryPointsGroups.buildingModeDependent.outputBaseDirectoryRelativePath.KEY]: {
                                         newName: "outputBaseDirectoryRelativePath",
                                         type: String,
-                                        required: true,
-                                        minimalCharactersCount: 1
+                                        required: true
                                     },
                                     [stylesProcessingLocalization.entryPointsGroups.buildingModeDependent.revisioning.KEY]: {
                                         newName: "revisioning",
@@ -7263,6 +7371,16 @@ module.exports = require("node-notifier");
 
 /***/ }),
 
+/***/ "typescript-declaration-webpack-plugin":
+/*!********************************************************!*\
+  !*** external "typescript-declaration-webpack-plugin" ***!
+  \********************************************************/
+/***/ ((module) => {
+
+module.exports = require("typescript-declaration-webpack-plugin");
+
+/***/ }),
+
 /***/ "vue-loader":
 /*!*****************************!*\
   !*** external "vue-loader" ***!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yamato-daiwa/automation",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "The project building tool with declarative YAML configuration specializing on Pug, Stylus and TypeScript as source code languages.",
   "keywords": [
     "build",
@@ -61,6 +61,7 @@
     "style-loader": "3.3.1",
     "stylus-loader": "6.2.0",
     "ts-loader": "9.3.0",
+    "typescript-declaration-webpack-plugin": "0.2.2",
     "vinyl": "2.2.1",
     "vue": "3.2.37",
     "vue-loader": "17.0.0",
@@ -99,5 +100,14 @@
     "Incremental development build": "webpack --mode development",
     "Production build": "webpack --mode production",
     "Lint": "eslint Source"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TokugawaTakeshi/Yamato-Daiwa-Automation"
+  },
+  "bugs": {
+    "url": "https://github.com/TokugawaTakeshi/Yamato-Daiwa-Automation/issues",
+    "email": "tokugawa.takesi@gmail.com"
   }
 }