tnp 21.0.285 → 21.0.290

package/ts-source/browser-code/project/abstract/artifacts/artifacts-manager.ts

@@ -0,0 +1,202 @@
+// @ts-nocheck
+/* ============================================================================
+ * TAON READONLY SOURCE
+ * DO NOT MODIFY THIS FILE.
+ * Changes may be overwritten.
+ * ========================================================================== */
+
+import { RegionRemover } from 'isomorphic-region-loader/browser';
+import { config, CoreModels, dotTaonFolder, dotTnpFolder, glob, GlobalStorage, LibTypeEnum, TAGS, taonPackageName, UtilsFilesFoldersSync, } from 'tnp-core/browser';
+import { Utils, UtilsTerminal, _, chalk, crossPlatformPath, fse, path, } from 'tnp-core/browser';
+import { fileName } from 'tnp-core/browser';
+import { tnpPackageName } from 'tnp-core/browser';
+import { taonActionFromParent } from 'tnp-core/browser';
+import { Helpers, HelpersTaon, UtilsTypescript } from 'tnp-helpers/browser';
+import { filterChildren } from '../../../app-utils';
+import { CURRENT_PACKAGE_VERSION } from '../../../build-info._auto-generated_';
+import { appCloudflareTsFromSrc, appElectronTsFromSrc, appTsFromSrc, binMainProject, cliTsFromSrc, containerPrefix, debugBrkSuffix, debugSuffix, distMainProject, dotAI, dotFileTemplateExt, dotVscodeMainProject, globalScssFromSrc, indexTsFromLibFromSrc, indexTsFromSrc, inspectBrkSuffix, inspectSuffix, libFromSrc, migrationsFromLib, nodeModulesMainProject, srcMainProject, startJsFromBin, startTsFromLib, TaonGeneratedFiles, taonJsonMainProject, TempalteSubprojectType, } from '../../../constants';
+import { ReleaseArtifactTaon, EnvOptions, ReleaseType } from '../../../options';
+import { EXPORT_TEMPLATE } from '../../../templates';
+import { CloudFlarePorjectsUtils } from '../cloud-flare-projects/cloud-flare-projects.utils';
+import { Project } from '../project';
+import { ArtifactsGlobalHelper } from './__helpers__/artifacts-helpers';
+import type { BaseArtifact, IArtifactProcessObj, ReleasePartialOutput, } from './base-artifact';
+import { FilesRecreator } from './npm-lib-and-cli-tool/tools/files-recreation';
+export class ArtifactManager {
+    public readonly filesRecreator: FilesRecreator;
+    static for(project: Project): ArtifactManager {
+        return (void 0);
+    }
+    private constructor(public artifact: IArtifactProcessObj, private project: Project, public globalHelper: ArtifactsGlobalHelper) {
+    }
+    async clear(options: EnvOptions): Promise<void> {
+        Helpers.taskStarted(`
+
+      Clearing artifacts temp data in ${this.project.name}
+
+      `);
+        this.project.removeFile([TaonGeneratedFiles.BUILD_INFO_MD]);
+        this.project.removeFile([TaonGeneratedFiles.BUILD_STATUS_MD]);
+        this.project.removeFolderByRelativePath(dotAI);
+        if (this.project.framework.isStandaloneProject) {
+            this.project.removeFolderByRelativePath(dotTnpFolder);
+            this.project.removeFolderByRelativePath(dotTaonFolder);
+        }
+        await this.artifact.npmLibAndCliTool.clearPartial(options);
+        await this.artifact.angularNodeApp.clearPartial(options);
+        await this.artifact.electronApp.clearPartial(options);
+        await this.artifact.mobileApp.clearPartial(options);
+        await this.artifact.docsWebapp.clearPartial(options);
+        await this.artifact.vscodePlugin.clearPartial(options);
+        if (this.project.framework.isContainer) {
+            [
+                srcMainProject,
+                ...this.filesRecreator.projectSpecificFilesForContainer(),
+                ...this.filesRecreator.projectSpecificFilesForStandalone(),
+                ...this.filesRecreator.filesTemplatesForStandalone(),
+                ...this.filesRecreator
+                    .filesTemplatesForStandalone()
+                    .map(f => f.replace(dotFileTemplateExt, '')),
+            ].forEach(f => {
+                this.project.remove(f, true);
+            });
+        }
+        Helpers.taskDone(`
+
+      Done cleaning artifacts temp data in ${this.project.name}
+
+      `);
+    }
+    async clearAllChildren(options: EnvOptions): Promise<void> {
+        for (const child of this.project.children) {
+            await child.artifactsManager.clear(options);
+        }
+    }
+    async struct(initOptions: EnvOptions): Promise<EnvOptions> {
+        return (void 0);
+    }
+    async structAllChildren(options: EnvOptions): Promise<void> {
+        for (const child of this.project.children) {
+            await child.artifactsManager.struct(options);
+        }
+    }
+    recreateCliBasicStructure(options?: {
+        skipRecreatingTsFiles?: boolean;
+    }): void {
+        return (void 0);
+    }
+    public async init(initOptions: EnvOptions): Promise<EnvOptions> {
+        return (void 0);
+    }
+    public async initAllChildren(options: EnvOptions): Promise<void> {
+        for (const child of this.project.children) {
+            await child.artifactsManager.init(options.clone({}));
+        }
+    }
+    async build(buildOptions: EnvOptions): Promise<void> {
+        if (!buildOptions.release.targetArtifact) {
+            Helpers.error(`
+
+        Please use commands:
+
+        ${config.frameworkName} build:watch:lib
+        ${config.frameworkName} build:watch:app
+        ${config.frameworkName} build:watch:electron
+        ${config.frameworkName} docs:watch
+
+        `, false, true);
+        }
+        else {
+            while (this.project.framework.frameworkVersionLessThan(CURRENT_PACKAGE_VERSION.split('.')[0] as any)) {
+                if (this.project.parent &&
+                    this.project.parent?.framework.isContainer &&
+                    this.project.parent?.taonJson.isOrganization &&
+                    this.project.taonJson.frameworkVersion !==
+                        this.project.parent.taonJson.frameworkVersion) {
+                    await this.project.taonJson.setFrameworkVersion(this.project.parent.taonJson.frameworkVersion);
+                    continue;
+                }
+                Helpers.error(`
+              Please upgrade taon framework version to at least v${CURRENT_PACKAGE_VERSION.split('.')[0]} (in taon.jsonc)
+              or install previous version of taon cli tool for ${this.project.framework.frameworkVersion}:
+
+              npm i -g ${taonPackageName}@${this.project.framework.frameworkVersion?.replace('v', '')}
+
+            `, false, true);
+                break;
+            }
+            if (buildOptions.build.watch && buildOptions.build.prod) {
+                buildOptions.build.prod = false;
+            }
+            if (buildOptions.release.lib.doNotIncludeLibFiles) {
+                buildOptions.build.prod = false;
+            }
+            if (!buildOptions.build.watch &&
+                buildOptions.build.prod &&
+                this.project.framework.isStandaloneProject) {
+                await this.project.clear();
+                this.project.warnAboutNotVerifiedWhenProdBuild(buildOptions);
+            }
+            if (!buildOptions.release.targetArtifact ||
+                buildOptions.release.targetArtifact ===
+                    ReleaseArtifactTaon.DOCS_DOCS_WEBAPP) {
+                await this.artifact.docsWebapp.buildPartial(buildOptions.clone());
+            }
+            if (!buildOptions.release.targetArtifact ||
+                buildOptions.release.targetArtifact ===
+                    ReleaseArtifactTaon.NPM_LIB_PKG_AND_CLI_TOOL) {
+                await this.artifact.npmLibAndCliTool.buildPartial(buildOptions.clone());
+            }
+            if (!buildOptions.release.targetArtifact ||
+                buildOptions.release.targetArtifact ===
+                    ReleaseArtifactTaon.ANGULAR_NODE_APP) {
+                await this.artifact.angularNodeApp.buildPartial(buildOptions.clone());
+            }
+            if (!buildOptions.release.targetArtifact ||
+                buildOptions.release.targetArtifact === ReleaseArtifactTaon.ELECTRON_APP) {
+                await this.artifact.electronApp.buildPartial(buildOptions.clone());
+            }
+            if (!buildOptions.release.targetArtifact ||
+                buildOptions.release.targetArtifact === ReleaseArtifactTaon.MOBILE_APP) {
+                await this.artifact.mobileApp.buildPartial(buildOptions.clone());
+            }
+            if (!buildOptions.release.targetArtifact ||
+                buildOptions.release.targetArtifact === ReleaseArtifactTaon.MOBILE_APP) {
+                await this.artifact.vscodePlugin.buildPartial(buildOptions.clone());
+            }
+        }
+    }
+    async buildAllChildren(buildOptions: EnvOptions, children = this.project.children): Promise<void> {
+        children = filterChildren(this.project, children, buildOptions, {
+            isForRelease: false,
+        });
+        if (!(await this.project.npmHelpers.shouldReleaseMessage({
+            releaseVersionBumpType: buildOptions.release.releaseVersionBumpType,
+            children: children as any,
+            whatToRelease: {
+                itself: false,
+                children: true,
+            },
+            skipQuestionToUser: buildOptions.isCiProcess,
+            actionType: 'build',
+        }))) {
+            return;
+        }
+        for (const child of children) {
+            GlobalStorage.set(taonActionFromParent, child.name);
+            await child.artifactsManager.build(buildOptions);
+        }
+    }
+    public async release(releaseOptions: EnvOptions, autoReleaseProcess = false): Promise<void> {
+        return (void 0);
+    }
+    async releaseAllChildren(options: EnvOptions, children = this.project.children): Promise<void> {
+        return (void 0);
+    }
+    public async tryCatchWrapper(action: () => any, actionName: 'release' | 'build' | 'init' | 'clear' | 'struct' | 'brand', project: Project = this.project): Promise<void> {
+        return (void 0);
+    }
+    private recreateAndFixCoreFiles(): void {
+        return (void 0);
+    }
+}

package/ts-source/browser-code/project/abstract/artifacts/base-artifact.ts

@@ -0,0 +1,94 @@
+// @ts-nocheck
+/* ============================================================================
+ * TAON READONLY SOURCE
+ * DO NOT MODIFY THIS FILE.
+ * Changes may be overwritten.
+ * ========================================================================== */
+
+import { RegionRemover } from 'isomorphic-region-loader/browser';
+import { config, extAllowedToReplace, TAGS, UtilsFilesFoldersSync, } from 'tnp-core/browser';
+import { CoreModels, _, crossPlatformPath, glob, path } from 'tnp-core/browser';
+import { fileName } from 'tnp-core/browser';
+import { Helpers, HelpersTaon, UtilsTypescript, UtilsZip, } from 'tnp-helpers/browser';
+import { binMainProject, BundledFiles, BundledDocsFolders, dotGitIgnoreMainProject, dotNpmIgnoreMainProject, dotNpmrcMainProject, dotVscodeMainProject, localReleaseMainProject, packageJsonMainProject, readmeMdMainProject, srcMainProject, suffixLatest, TaonCommands, taonJsonMainProject, tsconfigJsonBrowserMainProject, tsconfigJsonIsomorphicMainProject, tsconfigJsonMainProject, tmpCutReleaseSrcDistWebsql, tmpCutReleaseSrcDist, } from '../../../constants';
+import { ReleaseArtifactTaon, EnvOptions, ReleaseType, } from './../../../options';
+import type { Project } from './../project';
+import type { ArtifactsGlobalHelper } from './__helpers__/artifacts-helpers';
+import type { ArtifactAngularNodeApp } from './angular-node-app';
+import type { ArtifactDocsWebapp } from './docs-webapp';
+import type { ArtifactElectronApp } from './electron-app';
+import type { ArtifactMobileApp } from './mobile-app';
+import type { ArtifactNpmLibAndCliTool } from './npm-lib-and-cli-tool';
+import type { ArtifactVscodePlugin } from './vscode-plugin';
+export type IArtifactProcessObj = {
+    angularNodeApp: ArtifactAngularNodeApp;
+    npmLibAndCliTool: ArtifactNpmLibAndCliTool;
+    electronApp: ArtifactElectronApp;
+    mobileApp: ArtifactMobileApp;
+    docsWebapp: ArtifactDocsWebapp;
+    vscodePlugin: ArtifactVscodePlugin;
+};
+export interface ReleasePartialOutput {
+    releaseProjPath: string;
+    releaseType: ReleaseType;
+    projectsReposToPushAndTag?: string[];
+    projectsReposToPush?: string[];
+    resolvedNewVersion?: string;
+    deploymentFunction?: () => Promise<void>;
+}
+export interface PlatformArchType {
+    platform?: NodeJS.Platform;
+    arch?: 'arm64' | 'x64';
+}
+export abstract class BaseArtifact<BUILD_OUTPUT extends {}, RELEASE_OUTPUT extends ReleasePartialOutput> {
+    constructor(protected readonly project: Project, protected readonly currentArtifactName: ReleaseArtifactTaon) { }
+    protected readonly artifacts: IArtifactProcessObj;
+    protected readonly globalHelper: ArtifactsGlobalHelper;
+    abstract initPartial(options: EnvOptions): Promise<EnvOptions>;
+    abstract buildPartial(options: EnvOptions): Promise<BUILD_OUTPUT>;
+    abstract releasePartial(options: EnvOptions): Promise<RELEASE_OUTPUT>;
+    abstract clearPartial(options: EnvOptions): Promise<void>;
+    protected updateResolvedVersion(releaseOptions: EnvOptions): EnvOptions {
+        releaseOptions.release.resolvedNewVersion =
+            this.project.packageJson.resolvePossibleNewVersion(releaseOptions.release.releaseVersionBumpType);
+        this.project.packageJson.setVersion(releaseOptions.release.resolvedNewVersion);
+        return releaseOptions;
+    }
+    protected shouldSkipBuild(releaseOptions: EnvOptions): boolean {
+        if (_.isBoolean(releaseOptions.release.skipBuildingArtifacts)) {
+            return releaseOptions.release.skipBuildingArtifacts;
+        }
+        if (_.isArray(releaseOptions.release.skipBuildingArtifacts)) {
+            return (releaseOptions.release.skipBuildingArtifacts.includes(this.currentArtifactName) ||
+                releaseOptions.release.skipBuildingArtifacts.includes(releaseOptions.release.targetArtifact));
+        }
+        return false;
+    }
+    protected async getStaticPagesClonedProjectLocation(releaseOptions: EnvOptions): Promise<string> {
+        return (void 0);
+    }
+    protected get __allResources(): string[] {
+        return (void 0);
+    }
+    protected __restoreCuttedReleaseCodeFromSrc(buildOptions: EnvOptions) {
+    }
+    protected __cutReleaseCodeFromSrc(buildOptions: EnvOptions) {
+    }
+    protected getDistinctArchitecturePrefix(options?: boolean | PlatformArchType, includeDashEnTheEnd = false): string {
+        return (void 0);
+    }
+    async localReleaseDeploy(outputFromBuildAbsPath: string, releaseOptions: EnvOptions, options?: {
+        copyOnlyExtensions?: string[];
+        createReadme?: string;
+        distinctArchitecturePrefix?: boolean | PlatformArchType;
+    }): Promise<Pick<ReleasePartialOutput, 'releaseProjPath' | 'projectsReposToPushAndTag' | 'projectsReposToPush'>> {
+        return (void 0);
+    }
+    async staticPagesDeploy(outputFromBuildAbsPath: string, releaseOptions: EnvOptions, options?: {
+        copyOnlyExtensions?: string[];
+        createReadme?: string;
+        distinctArchitecturePrefix?: boolean | PlatformArchType;
+    }): Promise<Pick<ReleasePartialOutput, 'releaseProjPath' | 'projectsReposToPush'>> {
+        return (void 0);
+    }
+}

package/ts-source/browser-code/project/abstract/artifacts/docs-webapp/artifact-docs-webapp.ts

@@ -0,0 +1,67 @@
+// @ts-nocheck
+/* ============================================================================
+ * TAON READONLY SOURCE
+ * DO NOT MODIFY THIS FILE.
+ * Changes may be overwritten.
+ * ========================================================================== */
+
+import { Url } from 'url';
+import { config } from 'tnp-core/browser';
+import { crossPlatformPath, path } from 'tnp-core/browser';
+import { Helpers, UtilsTypescript } from 'tnp-helpers/browser';
+import { Development, EnvOptions, ReleaseArtifactTaon, ReleaseType, } from '../../../../options';
+import type { Project } from '../../project';
+import { BaseArtifact, ReleasePartialOutput } from '../base-artifact';
+import { DocsLibraryGenrator } from './docs-library-generator';
+import { MkDocs } from './mk-docs';
+export class ArtifactDocsWebapp extends BaseArtifact<{
+    docsWebappDistOutPath: string;
+    combinedDocsHttpServerUrl: Url;
+}, ReleasePartialOutput> {
+    public mkddocs: MkDocs;
+    public docsGen: DocsLibraryGenrator;
+    constructor(protected readonly project: Project) {
+        super(project, ReleaseArtifactTaon.DOCS_DOCS_WEBAPP);
+        this.mkddocs = new MkDocs(this.project);
+        this.docsGen = new DocsLibraryGenrator(this.project);
+    }
+    async clearPartial(clearOptions: EnvOptions): Promise<void> {
+        [
+            this.project.pathFor(`.${config.frameworkName}/temp-docs-folders`),
+        ].forEach(f => {
+            Helpers.removeSymlinks(f);
+            Helpers.removeFolderIfExists(f);
+        });
+    }
+    async initPartial(initOptions: EnvOptions): Promise<EnvOptions> {
+        if (!initOptions.release.targetArtifact) {
+            initOptions.release.targetArtifact = ReleaseArtifactTaon.DOCS_DOCS_WEBAPP;
+        }
+        await this.mkddocs.initializeWatchers(initOptions);
+        await this.mkddocs.init();
+        return initOptions;
+    }
+    async buildPartial(buildOptions: EnvOptions): Promise<{
+        docsWebappDistOutPath: string;
+        combinedDocsHttpServerUrl: Url;
+    }> {
+        return (void 0);
+    }
+    async releasePartial(releaseOptions: EnvOptions): Promise<ReleasePartialOutput> {
+        return (void 0);
+    }
+    async DOCS_ARTIFACT_PORT_UNIQ_KEY(buildOptions: EnvOptions): Promise<number> {
+        const key = 'docs port for http server';
+        return await this.project.registerAndAssignPort(key, {
+            startFrom: 3950,
+        });
+    }
+    private getOutDirTempDocsPath(buildOptions: EnvOptions): string {
+        let outDirApp = `.${config.frameworkName}/${this.currentArtifactName}/` +
+            `${buildOptions.release.releaseType
+                ? buildOptions.release.releaseType
+                : Development}/` +
+            this.project.packageJson.version;
+        return this.project.pathFor(outDirApp);
+    }
+}

package/ts-source/browser-code/project/abstract/artifacts/docs-webapp/docs-library-generator.ts

@@ -0,0 +1,181 @@
+// @ts-nocheck
+/* ============================================================================
+ * TAON READONLY SOURCE
+ * DO NOT MODIFY THIS FILE.
+ * Changes may be overwritten.
+ * ========================================================================== */
+
+import { RenameRule } from 'magic-renamer/browser';
+import type { DocsHeading, IndexData } from 'taon/browser';
+import { UtilsFilesFoldersSync, path, _, UtilsMdDocs, fse, crossPlatformPath, config, tnpPackageName, UtilsStringRegex, chalk, TAGS, taonCutNextLineCut, taonSkipCut, taonPackageName, Utils, } from 'tnp-core/browser';
+import { BaseFeatureForProject, Helpers } from 'tnp-helpers/browser';
+import { replaceAssetsLinksForApp, } from '../../../../app-utils';
+import { allDocsIndexDataFileTs, appFromSrc, assetsFor, assetsFromNgProj, assetsFromNpmPackage, assetsFromSrc, assetsFromTempSrc, baseHrefDocsGen, docsMainProject, docsRoutes, generatedDocsFromMd, libFromSrc, sharedFromAssets, sourceLinkInNodeModules, srcMainProject, TaonGeneratedFiles, THIS_IS_GENERATED_STRING, } from '../../../../constants';
+import { EnvOptions } from '../../../../options';
+import { Project } from '../../project';
+import { UtilsMdToHtml } from './utils-md-to-html';
+export class DocsLibraryGenrator extends BaseFeatureForProject<Project> {
+    buildOptions: EnvOptions;
+    private get temporaryMdDocsFolderAbsPath(): string {
+        return this.project.pathFor(`.${config.frameworkName}/tmp-temp-docs`);
+    }
+    private get sharedMdDocsAssetsFolderAbsPath(): string {
+        return this.project.pathFor([
+            srcMainProject,
+            assetsFromSrc,
+            sharedFromAssets,
+            generatedDocsFromMd,
+        ]);
+    }
+    private get allMdFilesAbsPathsFromTemporaryPath(): string[] {
+        return (void 0);
+    }
+    private get allMdFilesAbsPaths(): string[] {
+        return (void 0);
+    }
+    public removeTempFolders(): void {
+        return (void 0);
+    }
+    public async start(buildOptions: EnvOptions, force = false): Promise<void> {
+        return (void 0);
+    }
+    protected getUnifiedNameFromPackage(packageName: string): string {
+        const [org, name] = packageName.split('/');
+        return packageName.startsWith('@')
+            ? `${_.upperFirst(_.camelCase(org))}__${_.upperFirst(_.camelCase(name))}`
+            : _.upperFirst(_.camelCase(packageName));
+    }
+    protected getRoutesNameFromPackage(packageName: string): string {
+        const routesName = this.getUnifiedNameFromPackage(packageName) + 'DocsRoutes';
+        return routesName;
+    }
+    protected getRoutesNameFromFilePath(relativeFilePath: string): string {
+        const routesName = _.upperFirst(_.camelCase(relativeFilePath)) + 'Routes';
+        return routesName;
+    }
+    protected getComponentNameFromPackage(packageName: string): string {
+        const ComponentNameFromPackage = this.getUnifiedNameFromPackage(packageName) + 'Component';
+        return ComponentNameFromPackage;
+    }
+    protected getComponentNameFromFilePath(relativeFilePath: string): string {
+        const ComponentNameFromFilePath = _.upperFirst(_.camelCase(relativeFilePath)) + 'Component';
+        return ComponentNameFromFilePath;
+    }
+    public analyzeAndGetWhatDocsPackagesRequired(packageName: string, alreadyAnalyzed: string[] = []): string[] {
+        const project = this.getProjectFromPackage(packageName);
+        if (!project) {
+            return alreadyAnalyzed;
+        }
+        const allMdFiles = project.artifactsManager.artifact.docsWebapp.docsGen.allMdFilesAbsPaths;
+        const newPackages = [] as string[];
+        if (!alreadyAnalyzed.includes(packageName)) {
+            alreadyAnalyzed.push(packageName);
+        }
+        for (const mdFileAbsPAth of allMdFiles) {
+            const content = UtilsFilesFoldersSync.readFile(mdFileAbsPAth) || '';
+            const links = UtilsMdDocs.getRenderImports(content);
+            for (const link of links) {
+                if (!link.isLocal &&
+                    link.packageName &&
+                    !alreadyAnalyzed.includes(link.packageName)) {
+                    alreadyAnalyzed.push(link.packageName);
+                    newPackages.push(link.packageName);
+                }
+            }
+        }
+        for (const packageName of newPackages) {
+            this.analyzeAndGetWhatDocsPackagesRequired(packageName, alreadyAnalyzed);
+        }
+        return alreadyAnalyzed;
+    }
+    protected getProjectFromPackage(packageName: string): Project {
+        return (void 0);
+    }
+    private handleReplaceAssets({ proj, mdFileAbsPath, relativePath, packageName, content, }: {
+        proj: Project;
+        mdFileAbsPath: string;
+        relativePath: string;
+        packageName: string;
+        content: string;
+    }): string {
+        return (void 0);
+    }
+    private handleReplaceLinks({ proj, mdFileAbsPath, relativePath, packageName, content, }: {
+        proj: Project;
+        mdFileAbsPath: string;
+        relativePath: string;
+        packageName: string;
+        content: string;
+    }): string {
+        return (void 0);
+    }
+    protected copyAllMdFilesToTemporaryPath(packages: string[]): void {
+        return (void 0);
+    }
+    protected recreateMdFilesComponents(): void {
+        return (void 0);
+    }
+    protected recreateMainRoutesWithAllLinks(): void {
+        return (void 0);
+    }
+    protected recreateIndexingFile(): void {
+        return (void 0);
+    }
+    private tempateForAngularComponent({ absPath, relativePath, headings, codeblocks, }: {
+        absPath: string;
+        relativePath: string;
+        headings: DocsHeading[];
+        codeblocks: UtilsMdToHtml.CodeBlock[];
+    }): string {
+        return (void 0);
+    }
+    protected getTemplateForDefaultRoutes(relativePath: string): string {
+        return `
+//#${'reg' + 'ion'} imports
+import { Routes } from '@angular/router';
+import { ${this.getComponentNameFromFilePath(relativePath)} } from './${path.basename(relativePath).replace('.md', '.component')}';
+//#${'end' + 'reg' + 'ion'}
+
+${'exp' + 'ort'} const ${this.getRoutesNameFromFilePath(relativePath)}: Routes = [
+  {
+    path: '',
+    component: ${this.getComponentNameFromFilePath(relativePath)},
+  },
+];
+
+    `;
+    }
+    protected getLazyRouteTemplateForRelativePath(relativePath: string): string {
+        const RoutesForRelativePathComponentName = this.getRoutesNameFromFilePath(relativePath.replace('.routes.ts', '.md'));
+        return `
+   {
+      path: '${relativePath.replace('.routes.ts', '.md')}',
+      loadChildren: () =>
+        import('./${relativePath.replace('.ts', '')}').then(
+          m => m.${RoutesForRelativePathComponentName},
+        ),
+    }
+
+  `;
+    }
+    protected getMainRoutesFileForRelativePaths(relativePaths: string[]): string {
+        const RoutesForComponentName = this.getRoutesNameFromPackage(this.project.nameForNpmPackage);
+        const lazyRoutes = relativePaths
+            .reduce((a, packageName) => {
+            return a.concat(this.getLazyRouteTemplateForRelativePath(packageName));
+        }, [] as string[])
+            .join(',\n');
+        return `
+${'imp' + 'ort'}  { Routes } from '@angular/router';
+${'exp' + 'ort'}  const ${RoutesForComponentName}: Routes = [
+// {
+//   path: '', // skipping default route for now
+//   component: ComponentHere,
+// },
+${lazyRoutes}
+];
+
+${'exp' + 'ort'} default ${RoutesForComponentName};
+    `;
+    }
+}

package/ts-source/browser-code/project/abstract/artifacts/docs-webapp/index.ts

@@ -0,0 +1,8 @@
+// @ts-nocheck
+/* ============================================================================
+ * TAON READONLY SOURCE
+ * DO NOT MODIFY THIS FILE.
+ * Changes may be overwritten.
+ * ========================================================================== */
+
+export * from './artifact-docs-webapp';