@ng-doc/builder 16.3.6 → 16.4.0

package/engine/builder-operators/print-output.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printOutput = void 0;
+const operators_1 = require("rxjs/operators");
+const helpers_1 = require("../../helpers");
+/**
+ * Prints all errors and warnings existing in the store
+ *
+ * @param store - The store to print warnings and errors from
+ */
+function printOutput(store) {
+    return (source) => source.pipe((0, operators_1.tap)(() => {
+        const entitiesWithErrors = store.getAllWithErrorsOrWarnings().sort(sortEntities);
+        if (entitiesWithErrors.length > 0) {
+            (0, helpers_1.printError)(`NgDoc: ${entitiesWithErrors.length} entities with problems:`);
+            entitiesWithErrors.forEach((entity) => {
+                const printIdFunc = entity.errors.length ? helpers_1.printError : helpers_1.printWarning;
+                printIdFunc(`  ${entity.id}:`);
+                entity.warnings.forEach((error, i) => {
+                    const isLast = i === entity.warnings.length - 1 && !entity.errors.length;
+                    (0, helpers_1.printWarning)(`    ${error.message}${isLast ? '\n' : ''}`);
+                });
+                entity.errors.forEach((error, i) => {
+                    const isLast = i === entity.errors.length - 1;
+                    (0, helpers_1.printError)(`    ${error}${isLast ? '\n' : ''}`);
+                });
+            });
+        }
+    }));
+}
+exports.printOutput = printOutput;
+/**
+ * Sorts entities by errors and warnings
+ *
+ * @param a - The first entity to compare
+ * @param b - The second entity to compare
+ */
+function sortEntities(a, b) {
+    if (a.errors.length && !b.errors.length) {
+        return -1;
+    }
+    if (!a.errors.length && b.errors.length) {
+        return 1;
+    }
+    if (a.warnings.length && !b.warnings.length) {
+        return -1;
+    }
+    if (!a.warnings.length && b.warnings.length) {
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=print-output.js.map

package/engine/builder-operators/print-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-output.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/builder-operators/print-output.ts"],"names":[],"mappings":";;;AACA,8CAAmC;AAEnC,2CAAuD;AAIvD;;;;GAIG;AACH,SAAgB,WAAW,CAAI,KAAuB;IACrD,OAAO,CAAC,MAAqB,EAAE,EAAE,CAChC,MAAM,CAAC,IAAI,CACV,IAAA,eAAG,EAAC,GAAG,EAAE;QACR,MAAM,kBAAkB,GAAkB,KAAK,CAAC,0BAA0B,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEhG,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE;YAClC,IAAA,oBAAU,EAAC,UAAU,kBAAkB,CAAC,MAAM,0BAA0B,CAAC,CAAC;YAE1E,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAmB,EAAE,EAAE;gBAClD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAU,CAAC,CAAC,CAAC,sBAAY,CAAC;gBAErE,WAAW,CAAC,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;gBAE/B,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAY,EAAE,CAAS,EAAE,EAAE;oBACnD,MAAM,MAAM,GAAY,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;oBAElF,IAAA,sBAAY,EAAC,OAAO,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3D,CAAC,CAAC,CAAC;gBAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAY,EAAE,CAAS,EAAE,EAAE;oBACjD,MAAM,MAAM,GAAY,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;oBAEvD,IAAA,oBAAU,EAAC,OAAO,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjD,CAAC,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;SACH;IACF,CAAC,CAAC,CACF,CAAC;AACJ,CAAC;AA7BD,kCA6BC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,CAAc,EAAE,CAAc;IACnD,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QACxC,OAAO,CAAC,CAAC,CAAC;KACV;IAED,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QACxC,OAAO,CAAC,CAAC;KACT;IAED,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC5C,OAAO,CAAC,CAAC,CAAC;KACV;IAED,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC5C,OAAO,CAAC,CAAC;KACT;IAED,OAAO,CAAC,CAAC;AACV,CAAC"}

package/engine/builder-operators/refresh.d.ts

@@ -0,0 +1,6 @@
+import { OperatorFunction } from 'rxjs';
+import { NgDocEntity } from '../entities/abstractions/entity';
+/**
+ * Operator that runs the `emit` method of the entity.
+ */
+export declare function refresh(): OperatorFunction<NgDocEntity, NgDocEntity>;

package/engine/builder-operators/refresh.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refresh = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const helpers_1 = require("../../helpers");
+const error_handler_1 = require("../../operators/error-handler");
+/**
+ * Operator that runs the `emit` method of the entity.
+ */
+function refresh() {
+    return (source) => source.pipe((0, operators_1.switchMap)((e) => {
+        if ((0, helpers_1.isSourceFileEntity)(e) && !e.destroyed) {
+            return e.refresh().pipe((0, operators_1.map)(() => e), (0, error_handler_1.errorHandler)(e));
+        }
+        return (0, rxjs_1.of)(e);
+    }));
+}
+exports.refresh = refresh;
+//# sourceMappingURL=refresh.js.map

package/engine/builder-operators/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/builder-operators/refresh.ts"],"names":[],"mappings":";;;AAAA,+BAAsD;AACtD,8CAA8C;AAE9C,2CAAiD;AACjD,iEAA2D;AAG3D;;GAEG;AACH,SAAgB,OAAO;IACtB,OAAO,CAAC,MAA+B,EAAE,EAAE,CAC1C,MAAM,CAAC,IAAI,CACV,IAAA,qBAAS,EAAC,CAAC,CAAc,EAAE,EAAE;QAC5B,IAAI,IAAA,4BAAkB,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE;YAC1C,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CACtB,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EACZ,IAAA,4BAAY,EAAC,CAAC,CAAC,CACf,CAAC;SACF;QAED,OAAO,IAAA,SAAE,EAAC,CAAC,CAAC,CAAC;IACd,CAAC,CAAC,CACF,CAAC;AACJ,CAAC;AAdD,0BAcC"}

package/engine/builder-operators/task.d.ts

@@ -0,0 +1,25 @@
+import { OperatorFunction } from 'rxjs';
+/**
+ * Task operator that runs the provided operator on each value of the source.
+ * It also filters the values if the filter function is provided, shows the progress and handles the errors.
+ *
+ * The operator will be executed for each value that passes the filter function,
+ * and return the values in the same order as they were in the source.
+ *
+ * @param name - The name of the task (for progress).
+ * @param operator - The operator to run on each value of the source.
+ * @param filter - The filter function to filter the values of the source.
+ */
+export declare function task<T, R>(name: string, operator: OperatorFunction<T, R>, filter?: (value: T) => boolean): OperatorFunction<T[], R[]>;
+/**
+ * Task operator that runs the provided operator on the source with all the values.
+ * It also filters the values if the filter function is provided, shows the progress and handles the errors.
+ *
+ * The operator will be executed for each value that passes the filter function,
+ * and return the values in the same order as they were in the source.
+ *
+ * @param name - The name of the task (for progress).
+ * @param operator - The operator to run on the source.
+ * @param filter - The filter function to filter the values of the source.
+ */
+export declare function taskForMany<T, R>(name: string, operator: OperatorFunction<T[], R[]>, filter?: (value: T) => boolean): OperatorFunction<T[], R[]>;

package/engine/builder-operators/task.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskForMany = exports.task = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("../../operators");
+/**
+ * Task operator that runs the provided operator on each value of the source.
+ * It also filters the values if the filter function is provided, shows the progress and handles the errors.
+ *
+ * The operator will be executed for each value that passes the filter function,
+ * and return the values in the same order as they were in the source.
+ *
+ * @param name - The name of the task (for progress).
+ * @param operator - The operator to run on each value of the source.
+ * @param filter - The filter function to filter the values of the source.
+ */
+function task(name, operator, filter) {
+    return (source) => {
+        return source.pipe((0, operators_1.progress)(name), (0, rxjs_1.mergeMap)((values) => {
+            const filtered = filter ? values.filter(filter) : values;
+            return (0, operators_1.forkJoinOrEmpty)(filtered.map((v) => (0, rxjs_1.of)(v).pipe(operator)));
+        }));
+    };
+}
+exports.task = task;
+/**
+ * Task operator that runs the provided operator on the source with all the values.
+ * It also filters the values if the filter function is provided, shows the progress and handles the errors.
+ *
+ * The operator will be executed for each value that passes the filter function,
+ * and return the values in the same order as they were in the source.
+ *
+ * @param name - The name of the task (for progress).
+ * @param operator - The operator to run on the source.
+ * @param filter - The filter function to filter the values of the source.
+ */
+function taskForMany(name, operator, filter) {
+    return (source) => {
+        return source.pipe((0, operators_1.progress)(name), (0, rxjs_1.mergeMap)((values) => {
+            const filtered = filter ? values.filter(filter) : values;
+            return (0, rxjs_1.of)(filtered).pipe(operator);
+        }));
+    };
+}
+exports.taskForMany = taskForMany;
+//# sourceMappingURL=task.js.map

package/engine/builder-operators/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/builder-operators/task.ts"],"names":[],"mappings":";;;AAAA,+BAAoD;AAEpD,+CAA0D;AAE1D;;;;;;;;;;GAUG;AACH,SAAgB,IAAI,CACnB,IAAY,EACZ,QAAgC,EAChC,MAA8B;IAE9B,OAAO,CAAC,MAAM,EAAE,EAAE;QACjB,OAAO,MAAM,CAAC,IAAI,CACjB,IAAA,oBAAQ,EAAC,IAAI,CAAC,EACd,IAAA,eAAQ,EAAC,CAAC,MAAM,EAAE,EAAE;YACnB,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAEzD,OAAO,IAAA,2BAAe,EAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,SAAE,EAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CACF,CAAC;IACH,CAAC,CAAC;AACH,CAAC;AAfD,oBAeC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAC1B,IAAY,EACZ,QAAoC,EACpC,MAA8B;IAE9B,OAAO,CAAC,MAAM,EAAE,EAAE;QACjB,OAAO,MAAM,CAAC,IAAI,CACjB,IAAA,oBAAQ,EAAC,IAAI,CAAC,EACd,IAAA,eAAQ,EAAC,CAAC,MAAM,EAAE,EAAE;YACnB,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAEzD,OAAO,IAAA,SAAE,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,CACF,CAAC;IACH,CAAC,CAAC;AACH,CAAC;AAfD,kCAeC"}

package/engine/entities/abstractions/entity.d.ts

@@ -2,13 +2,15 @@ import { logging } from '@angular-devkit/core';
 import { NgDocPageIndex } from '@ng-doc/core';
 import { Observable } from 'rxjs';
 import { ObservableSet } from '../../../classes';
-import { NgDocBuilderContext, NgDocBuiltOutput } from '../../../interfaces';
-import { NgDocBuilder } from '../../builder';
+import { NgDocBuilderContext, NgDocBuildOutput } from '../../../interfaces';
+import { NgDocEntityStore } from '../../entity-store';
+import { NgDocCache } from '../cache';
 /**
  * Base entity class that all entities should extend.
  */
 export declare abstract class NgDocEntity {
-    readonly builder: NgDocBuilder;
+    readonly store: NgDocEntityStore;
+    readonly cache: NgDocCache;
     readonly context: NgDocBuilderContext;
     /**
      * The key by which the entity will be stored in the store
@@ -39,9 +41,15 @@ export declare abstract class NgDocEntity {
      * NgDoc destroys all child elements of non-physical entities when they are destroyed
      */
     readonly physical: boolean;
+    /**
+     * List of errors that were occurred during the build process
+     */
+    errors: Error[];
+    /**
+     * List of warnings that were occurred during the build process
+     */
+    warnings: Error[];
     private destroy$;
-    /** Indicates when current entity could be built */
-    protected readyToBuild: boolean;
     /**
      * Files that are watched for changes to rebuild entity or remove it
      */
@@ -58,9 +66,9 @@ export declare abstract class NgDocEntity {
      * Should return the list of the dependencies that have to be built if current entity was changed.
      */
     abstract readonly buildCandidates: NgDocEntity[];
-    constructor(builder: NgDocBuilder, context: NgDocBuilderContext);
-    /** Indicates if the current entity can be built */
-    get canBeBuilt(): boolean;
+    constructor(store: NgDocEntityStore, cache: NgDocCache, context: NgDocBuilderContext);
+    /** Indicates when current entity could be built */
+    protected get canBeBuilt(): boolean;
     /**
      * Recursively returns parents for the current entity
      *
@@ -90,7 +98,6 @@ export declare abstract class NgDocEntity {
     get hasChildren(): boolean;
     /**
      * Should return if this entity is ready to build
-     * Using for build process to skip entityStore that is not ready for build
      *
      * @type {boolean}
      */
@@ -101,18 +108,13 @@ export declare abstract class NgDocEntity {
      * Build all artifacts that need for application.
      * This is the last method in the build process, should return output that should be emitted to the file system
      */
-    protected abstract build(): Observable<NgDocBuiltOutput[]>;
-    /**
-     * Runs when the source file was updated, can be used to refresh target file etc.
-     */
-    abstract update(): Observable<void>;
+    protected abstract buildImpl(): Observable<NgDocBuildOutput[]>;
     /**
      * Method called by NgDocBuilder when one or more dependencies have changed
      */
     dependenciesChanged(): void;
     childrenGenerator(): Observable<NgDocEntity[]>;
-    buildArtifacts(): Observable<NgDocBuiltOutput[]>;
-    emit(): Observable<void>;
+    build(): Observable<NgDocBuildOutput[]>;
     removeArtifacts(): void;
     /**
      * Destroys current entity and clear all references

package/engine/entities/abstractions/entity.js

@@ -20,8 +20,9 @@ exports.NgDocEntity = (() => {
     let _potentialKeywords_initializers = [];
     let _get_cachedFilePaths_decorators;
     return _a = class NgDocEntity {
-            constructor(builder, context) {
-                this.builder = (tslib_1.__runInitializers(this, _instanceExtraInitializers), builder);
+            constructor(store, cache, context) {
+                this.store = (tslib_1.__runInitializers(this, _instanceExtraInitializers), store);
+                this.cache = cache;
                 this.context = context;
                 /** Indicates when entity was destroyed */
                 this.destroyed = false;
@@ -48,11 +49,17 @@ exports.NgDocEntity = (() => {
                  * NgDoc destroys all child elements of non-physical entities when they are destroyed
                  */
                 this.physical = true;
+                /**
+                 * List of errors that were occurred during the build process
+                 */
+                this.errors = [];
+                /**
+                 * List of warnings that were occurred during the build process
+                 */
+                this.warnings = [];
                 this.destroy$ = new rxjs_1.Subject();
-                /** Indicates when current entity could be built */
-                this.readyToBuild = false;
             }
-            /** Indicates if the current entity can be built */
+            /** Indicates when current entity could be built */
             get canBeBuilt() {
                 return true;
             }
@@ -70,7 +77,7 @@ exports.NgDocEntity = (() => {
              * Contains all children of the current entity.
              */
             get children() {
-                return this.builder.entities.asArray().filter((entity) => entity.parent === this && !entity.destroyed);
+                return this.store.asArray().filter((entity) => entity.parent === this && !entity.destroyed);
             }
             /**
              * Returns children that are ready to build or already built
@@ -96,12 +103,11 @@ exports.NgDocEntity = (() => {
             }
             /**
              * Should return if this entity is ready to build
-             * Using for build process to skip entityStore that is not ready for build
              *
              * @type {boolean}
              */
             get isReadyForBuild() {
-                return this.readyToBuild && !this.destroyed && this.canBeBuilt;
+                return !this.destroyed && !this.errors.length && this.canBeBuilt;
             }
             get logger() {
                 return this.context.context.logger;
@@ -113,26 +119,23 @@ exports.NgDocEntity = (() => {
              * Method called by NgDocBuilder when one or more dependencies have changed
              */
             dependenciesChanged() {
-                this.readyToBuild = true;
+                // Reset error and warnings, because dependency changes could fix them
+                this.warnings = [];
+                this.errors = [];
             }
             childrenGenerator() {
                 return (0, rxjs_1.of)([]);
             }
-            buildArtifacts() {
+            build() {
                 // Clear all indexes and used keywords before build
                 this.usedKeywords.clear();
                 this.potentialKeywords.clear();
                 this.indexes = [];
-                return this.build().pipe((0, operators_1.tap)(() => this.builder.cache.cache(this)), (0, operators_1.catchError)((e) => {
-                    this.logger.error(`Error during processing "${this.id}"\n${e.message}\n${e.stack}`);
-                    this.readyToBuild = false;
-                    return (0, rxjs_1.of)([]);
+                return this.buildImpl().pipe((0, operators_1.tap)({
+                    next: () => this.cache.cache(this),
+                    error: (e) => this.errors.push(e),
                 }));
             }
-            emit() {
-                // No implementation
-                return (0, rxjs_1.of)(void 0);
-            }
             removeArtifacts() {
                 // No implementation
             }
@@ -143,7 +146,6 @@ exports.NgDocEntity = (() => {
              */
             destroy() {
                 this.children.forEach((entity) => !entity.physical && entity.destroy());
-                this.readyToBuild = false;
                 this.destroyed = true;
                 this.destroy$.next();
             }

package/engine/entities/abstractions/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/entities/abstractions/entity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/entities/abstractions/entity.ts"],"names":[],"mappings":"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"}

package/engine/entities/abstractions/file.entity.d.ts

@@ -11,8 +11,18 @@ export declare abstract class NgDocFileEntity<T> extends NgDocSourceFileEntity {
      * Entity target.
      */
     target?: T;
-    update(): Observable<void>;
+    protected refreshImpl(): Observable<void>;
+    /**
+     * Runs when the source file was updated, can be used to load target file.
+     */
+    protected loadImpl(): Observable<void>;
     protected getParentFromCategory(): NgDocCategoryEntity | undefined;
+    /**
+     * Compiles the source file
+     */
+    compile(): Observable<void>;
+    load(): Observable<void>;
+    setParentDynamically(): void;
     destroy(): void;
     removeArtifacts(): void;
 }

package/engine/entities/abstractions/file.entity.js

@@ -5,6 +5,7 @@ const tslib_1 = require("tslib");
 const minimatch_1 = require("minimatch");
 const path = tslib_1.__importStar(require("path"));
 const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
 const ts_morph_1 = require("ts-morph");
 const helpers_1 = require("../../../helpers");
 const variables_1 = require("../../variables");
@@ -13,31 +14,49 @@ const source_file_entity_1 = require("./source-file.entity");
  * Entity for file end points that generate modules and components.
  */
 class NgDocFileEntity extends source_file_entity_1.NgDocSourceFileEntity {
-    update() {
-        this.readyToBuild = false;
-        try {
+    refreshImpl() {
+        return super
+            .refreshImpl()
+            .pipe((0, operators_1.tap)(() => (this.objectExpression = (0, helpers_1.getObjectExpressionFromDefault)(this.sourceFile))));
+    }
+    /**
+     * Runs when the source file was updated, can be used to load target file.
+     */
+    loadImpl() {
+        return (0, rxjs_1.defer)(() => {
             delete require.cache[require.resolve(this.pathToCompiledFile)];
             this.target = require(this.pathToCompiledFile).default;
-            this.objectExpression = (0, helpers_1.getObjectExpressionFromDefault)(this.sourceFile);
             if (!this.target || !this.objectExpression) {
-                new Error(`Failed to load ${this.sourceFile.getFilePath()}. Make sure that you have exported it as default.`);
+                new Error(`Failed to load object. Make sure that you have exported it as default.`);
             }
-        }
-        catch (e) {
-            return (0, rxjs_1.throwError)(e);
-        }
-        this.readyToBuild = true;
-        return (0, rxjs_1.of)(void 0);
+            return (0, rxjs_1.of)(void 0);
+        });
     }
     getParentFromCategory() {
         var _a, _b, _c, _d, _e, _f;
         const sourceFilePath = (_f = (_e = (_d = (_c = (_b = (_a = this.objectExpression) === null || _a === void 0 ? void 0 : _a.getProperty('category')) === null || _b === void 0 ? void 0 : _b.getChildrenOfKind(ts_morph_1.SyntaxKind.Identifier)) === null || _c === void 0 ? void 0 : _c.pop()) === null || _d === void 0 ? void 0 : _d.getDefinitions()[0]) === null || _e === void 0 ? void 0 : _e.getSourceFile()) === null || _f === void 0 ? void 0 : _f.getFilePath();
         if (sourceFilePath && (0, minimatch_1.minimatch)(sourceFilePath, variables_1.CATEGORY_PATTERN) && sourceFilePath !== this.sourceFilePath) {
-            const parent = this.builder.get(path.relative(this.context.context.workspaceRoot, sourceFilePath));
-            return (0, helpers_1.isCategoryEntity)(parent) ? parent : undefined;
+            const parent = this.store.get(path.relative(this.context.context.workspaceRoot, sourceFilePath));
+            return (0, helpers_1.isCategoryEntity)(parent) && parent.isReadyForBuild ? parent : undefined;
         }
         return undefined;
     }
+    /**
+     * Compiles the source file
+     */
+    compile() {
+        return (0, rxjs_1.from)((0, helpers_1.buildFileEntity)(this.sourceFile, this.context.tsConfig, this.context.context.workspaceRoot)).pipe((0, operators_1.map)(() => void 0), (0, operators_1.tap)({
+            error: (e) => this.errors.push(e),
+        }));
+    }
+    load() {
+        return this.loadImpl().pipe((0, operators_1.tap)({
+            error: (e) => this.errors.push(e),
+        }));
+    }
+    setParentDynamically() {
+        // No implementation
+    }
     destroy() {
         super.destroy();
     }

package/engine/entities/abstractions/file.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.entity.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/entities/abstractions/file.entity.ts"],"names":[],"mappings":";;;;AAAA,yCAAoC;AACpC,mDAA6B;AAC7B,+BAAgD;AAChD,uCAA6D;AAE7D,8CAAkF;AAClF,+CAAiD;AAGjD,6DAA2D;AAE3D;;GAEG;AACH,MAAsB,eAAmB,SAAQ,0CAAqB;IAO5D,MAAM;QACd,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAE1B,IAAI;YACH,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC;YACvD,IAAI,CAAC,gBAAgB,GAAG,IAAA,wCAA8B,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAExE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAC3C,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,mDAAmD,CAAC,CAAC;aAC9G;SACD;QAAC,OAAO,CAAU,EAAE;YACpB,OAAO,IAAA,iBAAU,EAAC,CAAC,CAAC,CAAC;SACrB;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAA,SAAE,EAAC,KAAK,CAAC,CAAC,CAAC;IACnB,CAAC;IAES,qBAAqB;;QAC9B,MAAM,cAAc,GAAuB,MAAA,MAAA,MAAA,MAAA,MAAA,MAAA,IAAI,CAAC,gBAAgB,0CAC7D,WAAW,CAAC,UAAU,CAAC,0CACvB,iBAAiB,CAAC,qBAAU,CAAC,UAAU,CAAC,0CACxC,GAAG,EAAE,0CACL,cAAc,GAAG,CAAC,CAAC,0CACnB,aAAa,EAAE,0CACf,WAAW,EAAE,CAAC;QAEjB,IAAI,cAAc,IAAI,IAAA,qBAAS,EAAC,cAAc,EAAE,4BAAgB,CAAC,IAAI,cAAc,KAAK,IAAI,CAAC,cAAc,EAAE;YAC5G,MAAM,MAAM,GAA4B,IAAI,CAAC,OAAO,CAAC,GAAG,CACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,CACjE,CAAC;YAEF,OAAO,IAAA,0BAAgB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;SACrD;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAEQ,OAAO;QACf,KAAK,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEQ,eAAe;QACvB,KAAK,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;CACD;AArDD,0CAqDC"}
+{"version":3,"file":"file.entity.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/entities/abstractions/file.entity.ts"],"names":[],"mappings":"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"}

package/engine/entities/abstractions/route.entity.d.ts

@@ -1,3 +1,6 @@
+import { NgDocBuildOutput, NgDocEntityKeyword } from '@ng-doc/builder';
+import { NgDocEntityAnchor } from '@ng-doc/core';
+import { Observable } from 'rxjs';
 import { NgDocModuleEntity } from './module.entity';
 export declare abstract class NgDocRouteEntity<T = unknown> extends NgDocModuleEntity<T> {
     /**
@@ -11,7 +14,11 @@ export declare abstract class NgDocRouteEntity<T = unknown> extends NgDocModuleE
     /**
      * Keywords that will be used to create links to the current entity on the pages
      */
-    abstract keywords: string[];
+    abstract keywords: NgDocEntityKeyword[];
+    /**
+     * The list of anchors for the current entity, that can be used to create keywords
+     */
+    anchors: NgDocEntityAnchor[];
     /**
      * Url for to the source file to the current page, that can be used to open it in repository and edit
      */
@@ -25,4 +32,5 @@ export declare abstract class NgDocRouteEntity<T = unknown> extends NgDocModuleE
      * Returns breadcrumbs for the current entity
      */
     get breadcrumbs(): string[];
+    build(): Observable<NgDocBuildOutput[]>;
 }

package/engine/entities/abstractions/route.entity.js

@@ -5,32 +5,54 @@ const tslib_1 = require("tslib");
 const core_1 = require("@ng-doc/core");
 const path = tslib_1.__importStar(require("path"));
 const helpers_1 = require("../../../helpers");
+const cache_1 = require("../cache");
 const module_entity_1 = require("./module.entity");
-class NgDocRouteEntity extends module_entity_1.NgDocModuleEntity {
-    /**
-     * Url for to the source file to the current page, that can be used to open it in repository and edit
-     */
-    get editSourceFileUrl() {
-        return undefined;
-    }
-    /**
-     * Url for to the source file to the current page, that can be used to open it in repository and view
-     */
-    get viewSourceFileUrl() {
-        return undefined;
-    }
-    get fullRoute() {
-        var _a;
-        const parentRoute = this.parent instanceof NgDocRouteEntity ? this.parent.fullRoute : (_a = this.context.config.routePrefix) !== null && _a !== void 0 ? _a : '';
-        return (0, helpers_1.slash)(path.join('/', parentRoute, this.route));
-    }
-    /**
-     * Returns breadcrumbs for the current entity
-     */
-    get breadcrumbs() {
-        var _a;
-        return (0, helpers_1.isRouteEntity)(this.parent) ? [...(0, core_1.asArray)((_a = this === null || this === void 0 ? void 0 : this.parent) === null || _a === void 0 ? void 0 : _a.breadcrumbs), this.title] : [this.title];
-    }
-}
-exports.NgDocRouteEntity = NgDocRouteEntity;
+exports.NgDocRouteEntity = (() => {
+    var _a;
+    let _instanceExtraInitializers = [];
+    let _anchors_decorators;
+    let _anchors_initializers = [];
+    return _a = class NgDocRouteEntity extends module_entity_1.NgDocModuleEntity {
+            constructor() {
+                super(...arguments);
+                /**
+                 * The list of anchors for the current entity, that can be used to create keywords
+                 */
+                this.anchors = (tslib_1.__runInitializers(this, _instanceExtraInitializers), tslib_1.__runInitializers(this, _anchors_initializers, []));
+            }
+            /**
+             * Url for to the source file to the current page, that can be used to open it in repository and edit
+             */
+            get editSourceFileUrl() {
+                return undefined;
+            }
+            /**
+             * Url for to the source file to the current page, that can be used to open it in repository and view
+             */
+            get viewSourceFileUrl() {
+                return undefined;
+            }
+            get fullRoute() {
+                var _a;
+                const parentRoute = this.parent instanceof NgDocRouteEntity ? this.parent.fullRoute : (_a = this.context.config.routePrefix) !== null && _a !== void 0 ? _a : '';
+                return (0, helpers_1.slash)(path.join('/', parentRoute, this.route));
+            }
+            /**
+             * Returns breadcrumbs for the current entity
+             */
+            get breadcrumbs() {
+                var _a;
+                return (0, helpers_1.isRouteEntity)(this.parent) ? [...(0, core_1.asArray)((_a = this === null || this === void 0 ? void 0 : this.parent) === null || _a === void 0 ? void 0 : _a.breadcrumbs), this.title] : [this.title];
+            }
+            build() {
+                this.anchors = [];
+                return super.build();
+            }
+        },
+        (() => {
+            _anchors_decorators = [(0, cache_1.CachedProperty)()];
+            tslib_1.__esDecorate(null, null, _anchors_decorators, { kind: "field", name: "anchors", static: false, private: false, access: { has: obj => "anchors" in obj, get: obj => obj.anchors, set: (obj, value) => { obj.anchors = value; } } }, _anchors_initializers, _instanceExtraInitializers);
+        })(),
+        _a;
+})();
 //# sourceMappingURL=route.entity.js.map

package/engine/entities/abstractions/route.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.entity.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/entities/abstractions/route.entity.ts"],"names":[],"mappings":";;;;AAAA,uCAAqC;AACrC,mDAA6B;AAE7B,8CAAsD;AACtD,mDAAkD;AAElD,MAAsB,gBAA8B,SAAQ,iCAAoB;IAgB/E;;OAEG;IACH,IAAI,iBAAiB;QACpB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI,iBAAiB;QACpB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,SAAS;;QACZ,MAAM,WAAW,GAChB,IAAI,CAAC,MAAM,YAAY,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,mCAAI,EAAE,CAAC;QAEzG,OAAO,IAAA,eAAK,EAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;;QACd,OAAO,IAAA,uBAAa,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAA,cAAO,EAAC,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,0CAAE,WAAW,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxG,CAAC;CACD;AA3CD,4CA2CC"}
+{"version":3,"file":"route.entity.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/entities/abstractions/route.entity.ts"],"names":[],"mappings":";;;;AACA,uCAAwD;AACxD,mDAA6B;AAG7B,8CAAsD;AACtD,oCAAwC;AACxC,mDAAkD;AAE5B,QAAA,gBAAgB;;;;;sBAAhB,gBAA8B,SAAQ,iCAAoB;;;gBAgB/E;;mBAEG;gBAEH,YAAO,wHAAwB,EAAE,GAAC;YAmCnC,CAAC;YAjCA;;eAEG;YACH,IAAI,iBAAiB;gBACpB,OAAO,SAAS,CAAC;YAClB,CAAC;YAED;;eAEG;YACH,IAAI,iBAAiB;gBACpB,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,IAAI,SAAS;;gBACZ,MAAM,WAAW,GAChB,IAAI,CAAC,MAAM,YAAY,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,mCAAI,EAAE,CAAC;gBAEzG,OAAO,IAAA,eAAK,EAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACvD,CAAC;YAED;;eAEG;YACH,IAAI,WAAW;;gBACd,OAAO,IAAA,uBAAa,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAA,cAAO,EAAC,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,0CAAE,WAAW,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxG,CAAC;YAEQ,KAAK;gBACb,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;gBAElB,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC;;;mCAnCA,IAAA,sBAAc,GAAE;YACjB,+KAAA,OAAO,6BAAP,OAAO,oEAA2B"}

package/engine/entities/abstractions/source-file.entity.d.ts

@@ -1,21 +1,19 @@
 import { Observable } from 'rxjs';
 import { SourceFile } from 'ts-morph';
 import { NgDocBuilderContext } from '../../../interfaces';
-import { NgDocBuilder } from '../../builder';
+import { NgDocEntityStore } from '../../entity-store';
+import { NgDocCache } from '../cache';
 import { NgDocEntity } from './entity';
 export declare abstract class NgDocSourceFileEntity extends NgDocEntity {
-    readonly builder: NgDocBuilder;
-    readonly sourceFile: SourceFile;
+    readonly store: NgDocEntityStore;
+    readonly cache: NgDocCache;
     readonly context: NgDocBuilderContext;
+    readonly sourceFile: SourceFile;
     /**
      * The key by which the entity will be stored in the store
      */
     readonly id: string;
-    /**
-     * Indicates whether the entity's source file can be compiled
-     */
-    readonly compilable: boolean;
-    constructor(builder: NgDocBuilder, sourceFile: SourceFile, context: NgDocBuilderContext);
+    constructor(store: NgDocEntityStore, cache: NgDocCache, context: NgDocBuilderContext, sourceFile: SourceFile);
     /**
      * Files that are watched for changes to rebuild entity or remove it
      */
@@ -32,6 +30,10 @@ export declare abstract class NgDocSourceFileEntity extends NgDocEntity {
      * Returns import paths that can be used to import the current source file
      */
     get pathToCompiledFile(): string;
-    emit(): Observable<void>;
+    /**
+     * Runs when the source file was updated, can be used refresh source file in the typescript project
+     */
+    protected refreshImpl(): Observable<void>;
+    refresh(): Observable<void>;
     destroy(): void;
 }