@ng-doc/builder 15.0.0-beta.10

package/engine/.cache/libs/builder/helpers/declaration-folder-name.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.declarationFolderName = void 0;
+const ts_morph_1 = require("ts-morph");
+/**
+ *
+ * @param declaration
+ */
+function declarationFolderName(declaration) {
+    if (ts_morph_1.Node.isClassDeclaration(declaration)) {
+        return 'classes';
+    }
+    else if (ts_morph_1.Node.isInterfaceDeclaration(declaration)) {
+        return 'interfaces';
+    }
+    else if (ts_morph_1.Node.isEnumDeclaration(declaration)) {
+        return 'enums';
+    }
+    else if (ts_morph_1.Node.isFunctionDeclaration(declaration)) {
+        return 'functions';
+    }
+    else if (ts_morph_1.Node.isVariableDeclaration(declaration)) {
+        return 'variables';
+    }
+    else if (ts_morph_1.Node.isTypeAliasDeclaration(declaration)) {
+        return 'types';
+    }
+    else if (ts_morph_1.Node.isModuleDeclaration(declaration)) {
+        return 'modules';
+    }
+    else {
+        return 'unknowns';
+    }
+}
+exports.declarationFolderName = declarationFolderName;

package/engine/.cache/libs/builder/helpers/declaration-to-playground.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.declarationToPlayground = void 0;
+const typescript_1 = require("./typescript");
+/**
+ *
+ * @param declaration
+ */
+function declarationToPlayground(declaration) {
+    return declaration
+        .getProperties()
+        .filter((property) => !!property.getDecorator('Input'))
+        .reduce((properties, property) => {
+        var _a, _b, _c, _d;
+        const inputName = (_c = (_b = (_a = property
+            .getDecorator('Input')) === null || _a === void 0 ? void 0 : _a.getArguments()[0]) === null || _b === void 0 ? void 0 : _b.getText().replace(/^["']|['"]$/g, '')) !== null && _c !== void 0 ? _c : property.getName();
+        properties[inputName] = {
+            name: property.getName(),
+            type: (0, typescript_1.displayType)(property.getType()),
+            default: (_d = property.getInitializer()) === null || _d === void 0 ? void 0 : _d.getText(),
+            description: property
+                .getJsDocs()
+                .reduce((comment, doc) => `${comment}\n${doc.getCommentText()}`.trim(), ''),
+            options: property
+                .getType()
+                .getUnionTypes()
+                .map((type) => type.getText()),
+        };
+        return properties;
+    }, {});
+}
+exports.declarationToPlayground = declarationToPlayground;

package/engine/.cache/libs/builder/helpers/emit-built-output.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitBuiltOutput = void 0;
+const fs = require("fs");
+const path = require("path");
+/**
+ *
+ * @param {...any} outputs
+ */
+function emitBuiltOutput(...outputs) {
+    outputs.forEach((output) => {
+        fs.mkdirSync(path.dirname(output.filePath), { recursive: true });
+        fs.writeFileSync(output.filePath, output.content);
+    });
+}
+exports.emitBuiltOutput = emitBuiltOutput;

package/engine/.cache/libs/builder/helpers/entity-type.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRouteEntity = exports.isApiScopeEntity = exports.isApiPageEntity = exports.isApiEntity = exports.isNavigationEntity = exports.isPlaygroundEntity = exports.isCategoryEntity = exports.isDependencyEntity = exports.isPageEntity = void 0;
+const engine_1 = require("../engine");
+const navigation_entity_1 = require("../engine/entities/abstractions/navigation.entity");
+const route_entity_1 = require("../engine/entities/abstractions/route.entity");
+/**
+ *
+ * @param page
+ */
+function isPageEntity(page) {
+    return page instanceof engine_1.NgDocPageEntity;
+}
+exports.isPageEntity = isPageEntity;
+/**
+ *
+ * @param dependency
+ */
+function isDependencyEntity(dependency) {
+    return dependency instanceof engine_1.NgDocDependenciesEntity;
+}
+exports.isDependencyEntity = isDependencyEntity;
+/**
+ *
+ * @param page
+ */
+function isCategoryEntity(page) {
+    return page instanceof engine_1.NgDocCategoryEntity;
+}
+exports.isCategoryEntity = isCategoryEntity;
+/**
+ *
+ * @param page
+ */
+function isPlaygroundEntity(page) {
+    return page instanceof engine_1.NgDocPlaygroundEntity;
+}
+exports.isPlaygroundEntity = isPlaygroundEntity;
+/**
+ *
+ * @param page
+ */
+function isNavigationEntity(page) {
+    return page instanceof navigation_entity_1.NgDocNavigationEntity;
+}
+exports.isNavigationEntity = isNavigationEntity;
+/**
+ *
+ * @param page
+ */
+function isApiEntity(page) {
+    return page instanceof engine_1.NgDocApiEntity;
+}
+exports.isApiEntity = isApiEntity;
+/**
+ *
+ * @param page
+ */
+function isApiPageEntity(page) {
+    return page instanceof engine_1.NgDocApiPageEntity;
+}
+exports.isApiPageEntity = isApiPageEntity;
+/**
+ *
+ * @param page
+ */
+function isApiScopeEntity(page) {
+    return page instanceof engine_1.NgDocApiScopeEntity;
+}
+exports.isApiScopeEntity = isApiScopeEntity;
+/**
+ *
+ * @param page
+ */
+function isRouteEntity(page) {
+    return page instanceof route_entity_1.NgDocRouteEntity;
+}
+exports.isRouteEntity = isRouteEntity;

package/engine/.cache/libs/builder/helpers/extract-docs.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractParameterDocs = exports.extractSeeDocs = exports.extractDocs = void 0;
+const tsdoc_1 = require("@microsoft/tsdoc");
+const core_1 = require("@ng-doc/core");
+const ts_doc_formatter_1 = require("../engine/ts-doc-formatter");
+const marked_1 = require("./marked");
+/**
+ *
+ * @param node
+ * @param section
+ * @param customTag
+ */
+function extractDocs(node, customTag) {
+    const jsDocs = (0, core_1.asArray)(node.getJsDocs()[0]);
+    const parser = new tsdoc_1.TSDocParser(getTsDocConfiguration());
+    const docs = jsDocs.map((doc) => {
+        const context = parser.parseString(doc.getText());
+        return customTag
+            ? ts_doc_formatter_1.TsDocFormatter.renderDocNodes(context.docComment.customBlocks.filter((block) => block.blockTag.tagName === customTag))
+            : ts_doc_formatter_1.TsDocFormatter.renderDocNode(context.docComment.summarySection);
+    }).join('');
+    return (0, marked_1.marked)(docs);
+}
+exports.extractDocs = extractDocs;
+/**
+ *
+ * @param node
+ */
+function extractSeeDocs(node) {
+    const jsDocs = (0, core_1.asArray)(node.getJsDocs()[0]);
+    const parser = new tsdoc_1.TSDocParser(getTsDocConfiguration());
+    return jsDocs.map((jsDoc) => {
+        const context = parser.parseString(jsDoc.getText());
+        return context.docComment.seeBlocks
+            .map((seeBlock) => ts_doc_formatter_1.TsDocFormatter.renderDocNode(seeBlock))
+            .map(marked_1.marked);
+    }).flat();
+}
+exports.extractSeeDocs = extractSeeDocs;
+/**
+ *
+ * @param node
+ * @param paramName
+ */
+function extractParameterDocs(node, paramName) {
+    const jsDocs = (0, core_1.asArray)(node.getJsDocs()[0]);
+    const parser = new tsdoc_1.TSDocParser(getTsDocConfiguration());
+    const docs = jsDocs.map((doc) => {
+        const context = parser.parseString(doc.getText());
+        const paramBlock = context.docComment.params.tryGetBlockByName(paramName);
+        return paramBlock ? ts_doc_formatter_1.TsDocFormatter.renderDocNode(paramBlock.content) : '';
+    }).join('');
+    return (0, marked_1.marked)(docs);
+}
+exports.extractParameterDocs = extractParameterDocs;
+/**
+ *
+ */
+function getTsDocConfiguration() {
+    const customTags = [
+        new tsdoc_1.TSDocTagDefinition({ tagName: '@usageNotes', syntaxKind: tsdoc_1.TSDocTagSyntaxKind.BlockTag, allowMultiple: false })
+    ];
+    const configuration = new tsdoc_1.TSDocConfiguration();
+    customTags.forEach((tag) => configuration.addTagDefinition(tag));
+    return configuration;
+}

package/engine/.cache/libs/builder/helpers/extract-path-anchor.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPathAnchor = void 0;
+/**
+ * Extract path anchor from a given path
+ *
+ * @param {string} path - The path to extract anchor from
+ * @returns {NgDocPathAnchor} The extracted anchor
+ */
+function extractPathAnchor(path) {
+    var _a, _b;
+    const pathParts = path.split('#');
+    return {
+        path: (_a = pathParts[0]) !== null && _a !== void 0 ? _a : '',
+        anchor: (_b = pathParts[1]) !== null && _b !== void 0 ? _b : '',
+    };
+}
+exports.extractPathAnchor = extractPathAnchor;

package/engine/.cache/libs/builder/helpers/extract-selectors.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSelectors = void 0;
+const ts_morph_1 = require("ts-morph");
+const component_decorator_resolver_1 = require("../resolvers/component-decorator.resolver");
+/**
+ *
+ * @param declaration
+ */
+function extractSelectors(declaration) {
+    var _a, _b;
+    if (ts_morph_1.Node.isClassDeclaration(declaration)) {
+        const decorator = (_a = declaration.getDecorator('Component')) !== null && _a !== void 0 ? _a : declaration.getDecorator('Directive');
+        if (decorator) {
+            const expression = decorator.getArguments()[0];
+            if (ts_morph_1.Node.isObjectLiteralExpression(expression)) {
+                const selector = (_b = (0, component_decorator_resolver_1.componentDecoratorResolver)(expression).selector) !== null && _b !== void 0 ? _b : '';
+                return selector.split(',').map((s) => s.trim());
+            }
+        }
+    }
+    return [];
+}
+exports.extractSelectors = extractSelectors;

package/engine/.cache/libs/builder/helpers/find-closest-file.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findClosestFile = void 0;
+const fs = require("fs");
+const path = require("path");
+/**
+ *	Finds the closest file in the given path.
+ *
+ * @param {string} rootFolder The root folder where it needs to stop the search.
+ * @param {string} currentFolder The current folder to search in.
+ * @param {string} fileName The file name to search for.
+ * @returns {string} The path to the closest file.
+ */
+function findClosestFile(rootFolder, currentFolder, fileName) {
+    const currentPath = currentFolder;
+    const filePath = path.join(currentPath, fileName);
+    if (fs.existsSync(filePath)) {
+        return filePath;
+    }
+    const parentPath = path.dirname(currentPath);
+    if (parentPath === rootFolder) {
+        return null;
+    }
+    return findClosestFile(rootFolder, parentPath, fileName);
+}
+exports.findClosestFile = findClosestFile;

package/engine/.cache/libs/builder/helpers/format-code.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCode = void 0;
+/**
+ *	Format code with Prettier
+ *
+ * @param {string} code Code to format
+ * @param {NgDocCodeType} codeType Type of code
+ * @returns {string} Formatted code
+ */
+function formatCode(code, codeType) {
+    try {
+        return require('prettier').format(code, { parser: getPrettierParserFromCodeType(codeType) });
+    }
+    catch (e) {
+        return code;
+    }
+}
+exports.formatCode = formatCode;
+/**
+ *	Returns the parser for the given code type.
+ *
+ * @param {NgDocCodeType} codeType Code type
+ * @returns {string} Parser
+ */
+function getPrettierParserFromCodeType(codeType) {
+    switch (codeType) {
+        case 'TypeScript':
+            return 'typescript';
+        case 'HTML':
+            return 'html';
+        case 'CSS':
+        case 'LESS':
+        case 'SCSS':
+        case 'SASS':
+            return 'css';
+        default:
+            return 'typescript';
+    }
+}

package/engine/.cache/libs/builder/helpers/generate-api-entities.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateApiEntities = void 0;
+const core_1 = require("@ng-doc/core");
+const glob = require("glob");
+const engine_1 = require("../engine");
+const is_not_excluded_path_1 = require("./is-not-excluded-path");
+const is_supported_declaration_1 = require("./is-supported-declaration");
+// one file - sourceFile.getNodesReferencingOtherSourceFiles()[0].getModuleSpecifierSourceFile().getNodesReferencingOtherSourceFiles()
+/**
+ *
+ * @param apiRootEntity
+ */
+function generateApiEntities(apiRootEntity) {
+    var _a;
+    const result = [];
+    (_a = apiRootEntity.target) === null || _a === void 0 ? void 0 : _a.scopes.forEach((scope) => {
+        const scopeEntity = new engine_1.NgDocApiScopeEntity(apiRootEntity.builder, apiRootEntity.sourceFile, apiRootEntity.context, apiRootEntity, scope);
+        result.push(scopeEntity);
+        (0, core_1.asArray)(scope.include).forEach((include) => (0, core_1.asArray)(new Set(apiRootEntity.sourceFile
+            .getProject()
+            .addSourceFilesAtPaths(glob.sync(include).filter((p) => (0, is_not_excluded_path_1.isNotExcludedPath)(p, (0, core_1.asArray)(scope.exclude))))
+            .map((sourceFile) => (0, core_1.asArray)(sourceFile.getExportedDeclarations().values()))
+            .flat(2)))
+            .filter(is_supported_declaration_1.isSupportedDeclaration)
+            .forEach((declaration) => {
+            const name = declaration.getName();
+            if (name) {
+                result.push(new engine_1.NgDocApiPageEntity(apiRootEntity.builder, declaration.getSourceFile(), apiRootEntity.context, scopeEntity, name));
+            }
+        }));
+    });
+    return result;
+}
+exports.generateApiEntities = generateApiEntities;

package/engine/.cache/libs/builder/helpers/get-entity-constructor.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntityConstructor = void 0;
+const minimatch_1 = require("minimatch");
+const engine_1 = require("../engine");
+/**
+ *
+ * @param path
+ */
+function getEntityConstructor(path) {
+    if ((0, minimatch_1.default)(path, engine_1.PAGE_PATTERN)) {
+        return engine_1.NgDocPageEntity;
+    }
+    else if ((0, minimatch_1.default)(path, engine_1.CATEGORY_PATTERN)) {
+        return engine_1.NgDocCategoryEntity;
+    }
+    else if ((0, minimatch_1.default)(path, engine_1.PAGE_DEPENDENCY_PATTERN)) {
+        return engine_1.NgDocDependenciesEntity;
+    }
+    else if ((0, minimatch_1.default)(path, engine_1.API_PATTERN)) {
+        return engine_1.NgDocApiEntity;
+    }
+    else if ((0, minimatch_1.default)(path, engine_1.PLAYGROUND_PATTERN)) {
+        return engine_1.NgDocPlaygroundEntity;
+    }
+    else {
+        throw new Error(`Unknown entity type for path: ${path}`);
+    }
+}
+exports.getEntityConstructor = getEntityConstructor;

package/engine/.cache/libs/builder/helpers/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./build-assets"), exports);
+tslib_1.__exportStar(require("./code-type-from-ext"), exports);
+tslib_1.__exportStar(require("./create-builder-context"), exports);
+tslib_1.__exportStar(require("./declaration-folder-name"), exports);
+tslib_1.__exportStar(require("./declaration-to-playground"), exports);
+tslib_1.__exportStar(require("./emit-built-output"), exports);
+tslib_1.__exportStar(require("./entity-type"), exports);
+tslib_1.__exportStar(require("./extract-docs"), exports);
+tslib_1.__exportStar(require("./extract-path-anchor"), exports);
+tslib_1.__exportStar(require("./extract-selectors"), exports);
+tslib_1.__exportStar(require("./find-closest-file"), exports);
+tslib_1.__exportStar(require("./format-code"), exports);
+tslib_1.__exportStar(require("./generate-api-entities"), exports);
+tslib_1.__exportStar(require("./get-entity-constructor"), exports);
+tslib_1.__exportStar(require("./is-not-excluded-path"), exports);
+tslib_1.__exportStar(require("./is-supported-declaration"), exports);
+tslib_1.__exportStar(require("./marked"), exports);
+tslib_1.__exportStar(require("./no-line-breaks"), exports);
+tslib_1.__exportStar(require("./presentation"), exports);
+tslib_1.__exportStar(require("./print-console"), exports);
+tslib_1.__exportStar(require("./process-snippets"), exports);
+tslib_1.__exportStar(require("./slash"), exports);
+tslib_1.__exportStar(require("./typescript"), exports);
+tslib_1.__exportStar(require("./unique-name"), exports);

package/engine/.cache/libs/builder/helpers/is-not-excluded-path.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNotExcludedPath = void 0;
+const core_1 = require("@ng-doc/core");
+const minimatch_1 = require("minimatch");
+/**
+ *
+ * @param path
+ * @param excluded
+ */
+function isNotExcludedPath(path, excluded) {
+    return (0, core_1.asArray)(excluded).every((e) => !(0, minimatch_1.default)(path, e));
+}
+exports.isNotExcludedPath = isNotExcludedPath;

package/engine/.cache/libs/builder/helpers/is-supported-declaration.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSupportedDeclaration = void 0;
+const ts_morph_1 = require("ts-morph");
+/**
+ *
+ * @param declaration
+ */
+function isSupportedDeclaration(declaration) {
+    return ts_morph_1.Node.isClassDeclaration(declaration)
+        || ts_morph_1.Node.isInterfaceDeclaration(declaration)
+        || ts_morph_1.Node.isEnumDeclaration(declaration)
+        || ts_morph_1.Node.isFunctionDeclaration(declaration)
+        || ts_morph_1.Node.isVariableDeclaration(declaration)
+        || ts_morph_1.Node.isTypeAliasDeclaration(declaration)
+        || ts_morph_1.Node.isModuleDeclaration(declaration);
+}
+exports.isSupportedDeclaration = isSupportedDeclaration;

package/engine/.cache/libs/builder/helpers/marked.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.marked = void 0;
+const core_1 = require("@ng-doc/core");
+const marked_1 = require("marked");
+const NOTE_ANCHOR = '<p><strong>Note</strong>';
+const WARNING_ANCHOR = '<p><strong>Warning</strong>';
+/**
+ *
+ * @param this
+ * @param markdown
+ */
+function marked(markdown) {
+    const renderer = {
+        code(code, language) {
+            const lang = language !== null && language !== void 0 ? language : 'typescript';
+            return `<pre><code class="language-${lang}" lang="${lang}">${(0, core_1.escapeHtml)(code)}</code></pre>`;
+        },
+        blockquote(quote) {
+            if (new RegExp(`^${NOTE_ANCHOR}`).test(quote)) {
+                return `<ng-doc-blockquote type="note">${quote.replace(new RegExp(`^${NOTE_ANCHOR}\\s*`), '<p>')}</ng-doc-blockquote>`;
+            }
+            if (new RegExp(`^${WARNING_ANCHOR}`).test(quote)) {
+                return `<ng-doc-blockquote type="warning">${quote.replace(new RegExp(`^${WARNING_ANCHOR}\\s*`), '<p>')}</ng-doc-blockquote>`;
+            }
+            return `<ng-doc-blockquote>${quote}</ng-doc-blockquote>`;
+        },
+    };
+    marked_1.marked.use({ renderer });
+    return marked_1.marked.parse(markdown);
+}
+exports.marked = marked;

package/engine/.cache/libs/builder/helpers/no-line-breaks.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noLineBreaks = void 0;
+/**
+ *
+ * @param str
+ */
+function noLineBreaks(str) {
+    return str.replace(/[\r\n]/gm, '');
+}
+exports.noLineBreaks = noLineBreaks;

package/engine/.cache/libs/builder/helpers/presentation.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.variablePresentation = exports.typeAliasPresentation = exports.methodPresentation = void 0;
+const typescript_1 = require("./typescript");
+/**
+ *
+ * @param method
+ */
+function methodPresentation(method) {
+    const parameters = method.getParameters().map(parameterPresentation).join(', ');
+    return `function ${method.getName()}(${parameters}): ${(0, typescript_1.displayType)(method.getReturnType())};`;
+}
+exports.methodPresentation = methodPresentation;
+/**
+ *
+ * @param typeAlias
+ */
+function typeAliasPresentation(typeAlias) {
+    return typeAlias.getText().replace('export', '').trim();
+}
+exports.typeAliasPresentation = typeAliasPresentation;
+/**
+ *
+ * @param variable
+ */
+function variablePresentation(variable) {
+    var _a, _b;
+    return `${(_b = (_a = variable.getVariableStatement()) === null || _a === void 0 ? void 0 : _a.getDeclarationKind()) !== null && _b !== void 0 ? _b : 'const'} ${variable.getName()}: ${(0, typescript_1.displayType)(variable.getType())};`;
+}
+exports.variablePresentation = variablePresentation;
+/**
+ *
+ * @param parameter
+ */
+function parameterPresentation(parameter) {
+    return `${parameter.getName()}${parameter.hasQuestionToken() ? '?' : ''}: ${(0, typescript_1.displayType)(parameter.getType())}${parameter.getInitializer() ? ` = ${parameter.getInitializer()}` : ''}`.trim();
+}

package/engine/.cache/libs/builder/helpers/print-console.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printWarning = void 0;
+const chalk_1 = require("chalk");
+/**
+ *
+ * @param text
+ */
+function printWarning(text) {
+    text && console.log(`\n${chalk_1.default.blue('NgDoc:')} ${chalk_1.default.yellow(text)}`);
+}
+exports.printWarning = printWarning;

package/engine/.cache/libs/builder/helpers/process-snippets.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processSnippets = void 0;
+const escape_regexp_1 = require("@ng-doc/core/helpers/escape-regexp");
+const HTMLSnippetStart = /^.*(<!--\s*NgDocHTMLSnippetStart(\(.+\))?\s*-->).*$/gm;
+const StylesSnippetStart = /^.*(\/\*\s*NgDocStyleSnippetStart(\(.+\))?\s*\*\/).*$/gm;
+const TypeScriptSnippetStart = /^.*(\/\*\s*NgDocCodeSnippetStart(\(.+\))?\s*\*\/).*$/gm;
+const HTMLSnippetEnd = (group = '', escape = true) => new RegExp(`^.*(<!--\\s*NgDocHTMLSnippetEnd(\\(${escape ? (0, escape_regexp_1.escapeRegexp)(group) : group}\\))?\\s*-->).*$`, 'gm');
+const StylesSnippetEnd = (group = '', escape = true) => new RegExp(`^.*(\\/\\*\\s*NgDocStyleSnippetEnd(\\(${escape ? (0, escape_regexp_1.escapeRegexp)(group) : group}\\))?\\s*\\*\\/).*$`, 'gm');
+const TypeScriptSnippetEnd = (group = '', escape = true) => new RegExp(`^.*(\\/\\*\\s*NgDocCodeSnippetEnd(\\(${escape ? (0, escape_regexp_1.escapeRegexp)(group) : group}\\))?\\s*\\*\\/).*$`, 'gm');
+/**
+ *	Finds and return all the snippets in the given string.
+ *
+ * @param {string} content - Content
+ * @returns {NgDocSnippet[]} - Array of snippets
+ */
+function processSnippets(content) {
+    return [
+        ...findSnippet(content, 'HTML', HTMLSnippetStart, HTMLSnippetEnd),
+        ...findSnippet(content, 'styles', StylesSnippetStart, StylesSnippetEnd),
+        ...findSnippet(content, 'TypeScript', TypeScriptSnippetStart, TypeScriptSnippetEnd),
+    ];
+}
+exports.processSnippets = processSnippets;
+/**
+ *
+ * @param content
+ * @param type
+ * @param snippetStart
+ * @param snippetEnd
+ */
+function findSnippet(content, type, snippetStart, snippetEnd) {
+    const snippets = [];
+    const startRegexp = new RegExp(snippetStart);
+    let matchStart;
+    // eslint-disable-next-line no-cond-assign
+    while ((matchStart = startRegexp.exec(content))) {
+        const group = matchStart[2] ? matchStart[2].slice(1, matchStart[2].length - 1) : '';
+        const matchEnd = snippetEnd(group).exec(content);
+        if (matchEnd) {
+            const snippetCode = content.slice(matchStart.index + matchStart[0].length, matchEnd.index).trim();
+            if (snippetCode) {
+                snippets.push({
+                    content: removeSnippetsInCode(snippetCode),
+                    name: group,
+                    type,
+                });
+            }
+        }
+    }
+    return snippets;
+}
+/**
+ *
+ * @param code
+ */
+function removeSnippetsInCode(code) {
+    return code
+        .replace(HTMLSnippetStart, '')
+        .replace(StylesSnippetStart, '')
+        .replace(TypeScriptSnippetStart, '')
+        .replace(HTMLSnippetEnd('.*', false), '')
+        .replace(StylesSnippetEnd('.*', false), '')
+        .replace(TypeScriptSnippetEnd('.*', false), '');
+}

package/engine/.cache/libs/builder/helpers/slash.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slash = void 0;
+/**
+ *
+ * @param path
+ */
+function slash(path) {
+    const isExtendedLengthPath = /^\\\\\?\\/.test(path);
+    const hasNonAscii = /[^\u0000-\u0080]+/.test(path); // eslint-disable-line no-control-regex
+    if (isExtendedLengthPath || hasNonAscii) {
+        return path;
+    }
+    return path.replace(/\\/g, '/');
+}
+exports.slash = slash;