@yamato-daiwa/automation 0.0.6 → 0.0.9

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",
@@ -2398,7 +2397,7 @@ class GulpStreamsBasedSourceCodeProcessor extends GulpStreamsBasedTaskExecutor_1
     initializeSourceFilesDirectoriesWhichAlwaysWillBeBeingWatchedGlobSelectors() {
         this.globSelectorsOfSourceFilesWithSupportedFilenameExtensionsInEntryPointsGroupRootDirectoryAndBelow.push(...this.associatedSourceCodeProcessingSettingsRepresentative.
             relevantEntryPointsSourceDirectoriesAbsolutePaths.
-            map((entryPointsSourceFilesDirectoryAbsolutePath) => ImprovedGlob_1.default.buildAllFilesInCurrentDirectoryButNotBelowGlobSelector({
+            map((entryPointsSourceFilesDirectoryAbsolutePath) => ImprovedGlob_1.default.buildAllFilesInCurrentDirectoryAndBelowGlobSelector({
             basicDirectoryPath: entryPointsSourceFilesDirectoryAbsolutePath,
             fileNamesExtensions: this.associatedSourceCodeProcessingSettingsRepresentative.
                 supportedEntryPointsSourceFileNameExtensionsWithoutLeadingDots
@@ -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",
@@ -4119,6 +4206,12 @@ class WebpackConfigGenerator {
             return null;
         }
         const webpackPublicPath = this.computePublicPathIfPossible(entryPointsGroupSettings);
+        const willBrowserJS_LibraryBeBuilt = entryPointsGroupSettings.distributing?.exposingOfExportsFromEntryPoints.mustExpose === true &&
+            entryPointsGroupSettings.targetRuntime.type === SupportedECMA_ScriptRuntimesTypes.browser;
+        const willNodeJS_LibraryBeBuilt = entryPointsGroupSettings.distributing?.exposingOfExportsFromEntryPoints.mustExpose === true &&
+            entryPointsGroupSettings.targetRuntime.type === SupportedECMA_ScriptRuntimesTypes.nodeJS;
+        const willPugLibraryBeBuilt = 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 +4220,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 +4244,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";
+                            }
+                        })(),
+                        ...willNodeJS_LibraryBeBuilt || willPugLibraryBeBuilt ? {
+                            name: entryPointsGroupSettings.distributing.exposingOfExportsFromEntryPoints.namespace
+                        } : null
+                    }
+                } : null,
+                ...willPugLibraryBeBuilt ? { globalObject: "globalThis" } : null
             },
+            ...willBrowserJS_LibraryBeBuilt ? { experiments: { outputModule: true } } : null,
             mode: this.masterConfigRepresentative.isDevelopmentBuildingMode ? "development" : "production",
             watch: this.masterConfigRepresentative.isDevelopmentBuildingMode,
             devtool: this.masterConfigRepresentative.isDevelopmentBuildingMode ? "eval" : false,
@@ -4348,7 +4454,6 @@ class WebpackConfigGenerator {
             return "/";
         }
         return ECMA_ScriptLogicEntryPointsGroupSettings__normalized.ID.replace(ECMA_ScriptLogicEntryPointsGroupSettings__normalized.ID, "/");
-        // Return "/";
     }
     static getWebpackEntryObjectRespectiveToSpecifiedEntryPointsGroupSettings({ ECMA_ScriptLogicEntryPointsGroupSettings__normalized, webpackContext }) {
         /* [ Reference ] https://webpack.js.org/configuration/entry-context/#entry */
@@ -4738,8 +4843,7 @@ var MarkupProcessingSettings__FromFile__RawValid;
                                     [markupProcessingLocalization.entryPointsGroups.buildingModeDependent.outputBaseDirectoryRelativePath.KEY]: {
                                         newName: "outputBaseDirectoryRelativePath",
                                         type: String,
-                                        required: true,
-                                        minimalCharactersCount: 1
+                                        required: true
                                     }
                                 }
                             }
@@ -5893,8 +5997,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",
@@ -6640,13 +6743,9 @@ class PartialsFilesMapper {
             description: `Mapping of ${sourceFilesTypeLabelForLogging} entry points and partial files relations done. ` +
                 `${mappingTimeMeasuringStopwatch.stop().seconds} seconds elapsed.`
         });
-        /* If (masterConfigRepresentative.mustDebugEntryPointsAndPartialFiles) {
-             PartialsFilesMapper.dumpIncludedFilesAndEntryPointsAccordanceMap(
-               partialFilesAndParentEntryPointsRelationsMap,
-               masterConfigRepresentative.consumingProjectRootDirectoryAbsolutePath
-             );
-           } */
-        PartialsFilesMapper.dumpIncludedFilesAndEntryPointsAccordanceMap(partialFilesAndParentEntryPointsRelationsMap, masterConfigRepresentative.consumingProjectRootDirectoryAbsolutePath);
+        if (masterConfigRepresentative.mustDebugEntryPointsAndPartialFiles) {
+            PartialsFilesMapper.dumpIncludedFilesAndEntryPointsAccordanceMap(partialFilesAndParentEntryPointsRelationsMap, masterConfigRepresentative.consumingProjectRootDirectoryAbsolutePath);
+        }
         return partialFilesAndParentEntryPointsRelationsMap;
     }
     static addAbsolutePathsOfExistingPartialsOfCurrentEntryPointOrPartialFileToQueue({ targetEntryPointOrPartialFileAbsolutePath, queueOfAbsolutePathsOfPartialFilesWhichWillBeScanned }) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yamato-daiwa/automation",
-  "version": "0.0.6",
+  "version": "0.0.9",
   "description": "The project building tool with declarative YAML configuration specializing on Pug, Stylus and TypeScript as source code languages.",
   "keywords": [
     "build",
@@ -99,5 +99,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"
   }
 }