@ng-doc/builder 15.0.0-beta.10

package/engine/.cache/libs/ui-kit/types/overlay-origin.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/overlay-position.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/overlay-relative-position.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/palette-color.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/position.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/size.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/subscribable.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/tag-size.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/types/text-color.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/engine/.cache/libs/ui-kit/utils/focus-utils.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NgDocFocusUtils = void 0;
+class NgDocFocusUtils {
+    static isNativeKeyboardFocusable(element) {
+        if (element.hasAttribute('disabled') || element.getAttribute('tabIndex') === '-1') {
+            return false;
+        }
+        if ((element instanceof HTMLElement && element.isContentEditable) || element.getAttribute('tabIndex') === '0') {
+            return true;
+        }
+        switch (element.tagName) {
+            case 'BUTTON':
+            case 'SELECT':
+            case 'TEXTAREA':
+                return true;
+            case 'VIDEO':
+            case 'AUDIO':
+                return element.hasAttribute('controls');
+            case 'INPUT':
+                return element.getAttribute('type') !== 'hidden';
+            case 'A':
+            case 'LINK':
+                return element.hasAttribute('href');
+            default:
+                return false;
+        }
+    }
+    static getClosestKeyboardFocusable(initial, root, forward = true) {
+        if (!root.ownerDocument) {
+            return null;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const svgNodeFilter = ((node) => 'ownerSVGElement' in node ? NodeFilter.FILTER_REJECT : NodeFilter.FILTER_ACCEPT);
+        const treeWalker = root.ownerDocument.createTreeWalker(root, NodeFilter.SHOW_ELEMENT, svgNodeFilter);
+        treeWalker.currentNode = initial;
+        while (forward ? treeWalker.nextNode() : treeWalker.previousNode()) {
+            if (treeWalker.currentNode instanceof HTMLElement) {
+                initial = treeWalker.currentNode;
+            }
+            if (NgDocFocusUtils.isNativeKeyboardFocusable(initial)) {
+                return initial;
+            }
+        }
+        return null;
+    }
+    static focusClosestElement(initial, root, forward = true) {
+        const focusable = NgDocFocusUtils.getClosestKeyboardFocusable(initial, root, forward);
+        if (focusable) {
+            focusable.focus();
+        }
+    }
+}
+exports.NgDocFocusUtils = NgDocFocusUtils;

package/engine/.cache/libs/ui-kit/utils/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./focus-utils"), exports);
+tslib_1.__exportStar(require("./overlay-utils"), exports);
+tslib_1.__exportStar(require("./position-utils"), exports);

package/engine/.cache/libs/ui-kit/utils/overlay-utils.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NgDocOverlayUtils = exports.NG_DOC_ARROW_MARGIN = void 0;
+const core_1 = require("@ng-doc/core");
+exports.NG_DOC_ARROW_MARGIN = 32;
+const POSITION_DESCRIPTION = {
+    'top-left': {
+        originX: 'start',
+        originY: 'top',
+        overlayX: 'start',
+        overlayY: 'bottom',
+    },
+    'top-center': {
+        originX: 'center',
+        originY: 'top',
+        overlayX: 'center',
+        overlayY: 'bottom',
+    },
+    'top-right': {
+        originX: 'end',
+        originY: 'top',
+        overlayX: 'end',
+        overlayY: 'bottom',
+    },
+    'bottom-left': {
+        originX: 'start',
+        originY: 'bottom',
+        overlayX: 'start',
+        overlayY: 'top',
+    },
+    'bottom-center': {
+        originX: 'center',
+        originY: 'bottom',
+        overlayX: 'center',
+        overlayY: 'top',
+    },
+    'bottom-right': {
+        originX: 'end',
+        originY: 'bottom',
+        overlayX: 'end',
+        overlayY: 'top',
+    },
+    'left-top': {
+        originX: 'start',
+        originY: 'top',
+        overlayX: 'end',
+        overlayY: 'top',
+    },
+    'left-center': {
+        originX: 'start',
+        originY: 'center',
+        overlayX: 'end',
+        overlayY: 'center',
+    },
+    'left-bottom': {
+        originX: 'start',
+        originY: 'bottom',
+        overlayX: 'end',
+        overlayY: 'bottom',
+    },
+    'right-top': {
+        originX: 'end',
+        originY: 'top',
+        overlayX: 'start',
+        overlayY: 'top',
+    },
+    'right-center': {
+        originX: 'end',
+        originY: 'center',
+        overlayX: 'start',
+        overlayY: 'center',
+    },
+    'right-bottom': {
+        originX: 'end',
+        originY: 'bottom',
+        overlayX: 'start',
+        overlayY: 'bottom',
+    },
+};
+class NgDocOverlayUtils {
+    static getConnectedPosition(dropdownPositions, origin, offset = 0, withPointer = false) {
+        return (0, core_1.asArray)(dropdownPositions).map((position) => {
+            const connectedPosition = NgDocOverlayUtils.toConnectedPosition(position);
+            const marginMultiplier = NgDocOverlayUtils.getMarginMultiplier(connectedPosition);
+            const marginX = !NgDocOverlayUtils.isVerticalPosition(connectedPosition)
+                ? offset * marginMultiplier
+                : 0;
+            const marginY = NgDocOverlayUtils.isVerticalPosition(connectedPosition)
+                ? offset * marginMultiplier
+                : 0;
+            connectedPosition.offsetX = connectedPosition.offsetX || 0;
+            connectedPosition.offsetY = connectedPosition.offsetY || 0;
+            connectedPosition.offsetX +=
+                (withPointer ? NgDocOverlayUtils.getOffsetX(origin, connectedPosition) : 0) + marginX;
+            connectedPosition.offsetY +=
+                (withPointer ? NgDocOverlayUtils.getOffsetY(origin, connectedPosition) : 0) + marginY;
+            return connectedPosition;
+        });
+    }
+    static toConnectedPosition(position) {
+        return typeof position === 'string' ? Object.assign({}, POSITION_DESCRIPTION[position]) : Object.assign({}, position);
+    }
+    static toConnectedPositions(positions) {
+        return positions.map(NgDocOverlayUtils.toConnectedPosition);
+    }
+    static getOffsetX(origin, position) {
+        const isVertical = NgDocOverlayUtils.isVerticalPosition(position);
+        const offsetMultiplier = NgDocOverlayUtils.getOffsetMultiplier(position);
+        const isCenter = NgDocOverlayUtils.isCenterPosition(position);
+        const width = (position.originX === 'center' && position.overlayX !== 'center') ||
+            NgDocOverlayUtils.overlayIsOutByX(position)
+            ? exports.NG_DOC_ARROW_MARGIN - 24
+            : origin.offsetWidth;
+        return (isVertical && !isCenter ? Math.max(exports.NG_DOC_ARROW_MARGIN - width, 0) : 0) * offsetMultiplier;
+    }
+    static getOffsetY(origin, position) {
+        const isVertical = NgDocOverlayUtils.isVerticalPosition(position);
+        const offsetMultiplier = NgDocOverlayUtils.getOffsetMultiplier(position);
+        const isCenter = NgDocOverlayUtils.isCenterPosition(position);
+        const height = (position.originY === 'center' && position.overlayY !== 'center') ||
+            NgDocOverlayUtils.overlayIsOutByY(position)
+            ? exports.NG_DOC_ARROW_MARGIN - 24
+            : origin.offsetHeight;
+        return (!isVertical && !isCenter ? Math.max(exports.NG_DOC_ARROW_MARGIN - height, 0) : 0) * offsetMultiplier;
+    }
+    static overlayIsOutByX(position) {
+        return ((position.originX === 'start' && position.overlayX === 'end') ||
+            (position.originX === 'end' && position.overlayX === 'start'));
+    }
+    static overlayIsOutByY(position) {
+        return ((position.originY === 'top' && position.overlayY === 'bottom') ||
+            (position.originY === 'bottom' && position.overlayY === 'top'));
+    }
+    static getOffsetMultiplier(position) {
+        return (NgDocOverlayUtils.isVerticalPosition(position) && position.overlayX === 'end') ||
+            (!NgDocOverlayUtils.isVerticalPosition(position) && position.overlayY === 'bottom')
+            ? 1
+            : -1;
+    }
+    static getMarginMultiplier(position) {
+        return ['right', 'bottom'].includes(NgDocOverlayUtils.getRelativePosition(position) || '') ? 1 : -1;
+    }
+    static isVerticalPosition(position) {
+        return ['bottom', 'top'].includes(NgDocOverlayUtils.getRelativePosition(position) || '');
+    }
+    static isCenterPosition(position) {
+        return position.overlayX === 'center' || position.overlayY === 'center';
+    }
+    static getPositionAlign(position) {
+        if (NgDocOverlayUtils.isVerticalPosition(position)) {
+            return position.overlayX === 'start' ? 'left' : position.overlayX === 'end' ? 'right' : null;
+        }
+        else {
+            return position.originY === 'top' ? 'top' : position.originY === 'bottom' ? 'bottom' : null;
+        }
+    }
+    static getRelativePosition(pos) {
+        const position = NgDocOverlayUtils.toConnectedPosition(pos);
+        if (position.originY === 'bottom' && position.overlayY === 'top') {
+            return 'bottom';
+        }
+        if (position.originY === 'top' && position.overlayY === 'bottom') {
+            return 'top';
+        }
+        if (position.originX === 'start' && position.overlayX === 'end') {
+            return 'left';
+        }
+        if (position.originX === 'end' && position.overlayX === 'start') {
+            return 'right';
+        }
+        return null;
+    }
+    static getOverlayPosition(positionPair) {
+        const existsPosition = Object.keys(POSITION_DESCRIPTION).find((key) => {
+            const positionDescription = POSITION_DESCRIPTION[key];
+            return (positionPair.originX === positionDescription.originX &&
+                positionPair.originY === positionDescription.originY &&
+                positionPair.overlayX === positionDescription.overlayX &&
+                positionPair.overlayY === positionDescription.overlayY);
+        });
+        return existsPosition ? existsPosition : positionPair;
+    }
+}
+exports.NgDocOverlayUtils = NgDocOverlayUtils;

package/engine/.cache/libs/ui-kit/utils/position-utils.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NgDocPositionUtils = void 0;
+class NgDocPositionUtils {
+    /**
+     * Getting the position of the element relative to the viewPort, this function is faster than BoundingClientRect,
+     * it also takes into account the change in the position of the element through transform
+     *
+     * @param element
+     */
+    static getElementPosition(element) {
+        let xPos = 0;
+        let yPos = 0;
+        while (element) {
+            if (element === document.body) {
+                const documentElement = document.documentElement;
+                xPos += documentElement.offsetLeft - documentElement.scrollLeft + documentElement.clientLeft;
+                yPos += documentElement.offsetTop - documentElement.scrollTop + documentElement.clientTop;
+                element = null;
+            }
+            else {
+                const elementMatrix = new DOMMatrix(element.style.transform);
+                xPos += element.offsetLeft - element.scrollLeft + element.clientLeft + elementMatrix.m41;
+                yPos += element.offsetTop - element.scrollTop + element.clientTop + elementMatrix.m42;
+                element = NgDocPositionUtils.getOffsetParent(element);
+            }
+        }
+        return { x: xPos, y: yPos };
+    }
+    /**
+     * An implementation of the element.offsetParent function, this implementation closes a bug in Firefox when it
+     * returns an offsetParent for elements with position: fixed
+     *
+     * @param element
+     */
+    static getOffsetParent(element) {
+        const computerStyles = getComputedStyle(element);
+        if (computerStyles.position === 'fixed' || computerStyles.display === 'none') {
+            return null;
+        }
+        return element.offsetParent;
+    }
+}
+exports.NgDocPositionUtils = NgDocPositionUtils;

package/engine/.cache/ng-doc.buildinfo.json

@@ -0,0 +1 @@
+{"version":"4.7.3"}

package/engine/actions/demo.action.d.ts

@@ -0,0 +1,10 @@
+import { NgDocAction } from '../../types';
+import { NgDocDemoActionOptions } from '../interfaces';
+/**
+ *	Render demo point on the page, it will be rendered by the application
+ *
+ * @param {string} componentName - The title of the component class to render
+ * @param {NgDocDemoActionOptions} options - Options for configuring the action
+ * @returns {NgDocAction} - The action output
+ */
+export declare function demoAction(componentName: string, options?: NgDocDemoActionOptions): NgDocAction;

package/engine/actions/demo.action.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.demoAction = void 0;
+/**
+ *	Render demo point on the page, it will be rendered by the application
+ *
+ * @param {string} componentName - The title of the component class to render
+ * @param {NgDocDemoActionOptions} options - Options for configuring the action
+ * @returns {NgDocAction} - The action output
+ */
+function demoAction(componentName, options) {
+    return () => {
+        var _a;
+        return {
+            output: `<ng-doc-demo componentName="${componentName}" container="${(_a = options === null || options === void 0 ? void 0 : options.container) !== null && _a !== void 0 ? _a : true}"></ng-doc-demo>`,
+        };
+    };
+}
+exports.demoAction = demoAction;
+//# sourceMappingURL=demo.action.js.map

package/engine/actions/demo.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.action.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/actions/demo.action.ts"],"names":[],"mappings":";;;AAIA;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,aAAqB,EAAE,OAAgC;IACjF,OAAO,GAAsB,EAAE;;QAC9B,OAAO;YACN,MAAM,EAAE,+BAA+B,aAAa,gBACnD,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,mCAAI,IACvB,kBAAkB;SAClB,CAAC;IACH,CAAC,CAAC;AACH,CAAC;AARD,gCAQC"}

package/engine/actions/playground.action.d.ts

@@ -0,0 +1,9 @@
+import { NgDocAction } from '../../types';
+/**
+ *	Render playground point on the page, it will be rendered by the application
+ *
+ * @param {string} playgroundId - Playground id in the config
+ * @param {string} sourcePath - Path to typescript file
+ * @returns {NgDocAction} - The action output
+ */
+export declare function playgroundAction(playgroundId: string): NgDocAction;

package/engine/actions/playground.action.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.playgroundAction = void 0;
+const core_1 = require("@ng-doc/core");
+const ts_morph_1 = require("ts-morph");
+const declaration_to_playground_1 = require("../../helpers/declaration-to-playground");
+const component_decorator_resolver_1 = require("../../resolvers/component-decorator.resolver");
+/**
+ *	Render playground point on the page, it will be rendered by the application
+ *
+ * @param {string} playgroundId - Playground id in the config
+ * @param {string} sourcePath - Path to typescript file
+ * @returns {NgDocAction} - The action output
+ */
+function playgroundAction(playgroundId) {
+    return (project, page) => {
+        var _a, _b, _c;
+        try {
+            if (!page.playground) {
+                throw new Error(`Can't find the playground file for the page ${page.route}`);
+            }
+            const declaration = page.playground.getTargetForPlayground(playgroundId);
+            if (!declaration) {
+                throw new Error(`Playground action didn't find the class declaration for the current target.`);
+            }
+            const decorator = (_a = declaration.getDecorator('Component')) !== null && _a !== void 0 ? _a : declaration.getDecorator('Directive');
+            const decoratorArgument = decorator === null || decorator === void 0 ? void 0 : decorator.getArguments()[0];
+            const selectors = ts_morph_1.Node.isObjectLiteralExpression(decoratorArgument)
+                ? (_c = (_b = (0, component_decorator_resolver_1.componentDecoratorResolver)(decoratorArgument).selector) === null || _b === void 0 ? void 0 : _b.replace(/[\n\s]/gm, '')) !== null && _c !== void 0 ? _c : ''
+                : '';
+            const playgroundData = (0, declaration_to_playground_1.declarationToPlayground)(declaration);
+            return {
+                output: `<ng-doc-playground id="${playgroundId}">
+							<div id="selectors">${selectors}</div>
+							<div id="data">${(0, core_1.escapeHtml)(JSON.stringify(playgroundData))}</div>
+						</ng-doc-playground>`,
+                dependencies: [declaration.getSourceFile().getFilePath()],
+            };
+        }
+        catch (e) {
+            page.logger.error(`Error while executing "playground" action: ${e}`);
+            return { output: `` };
+        }
+    };
+}
+exports.playgroundAction = playgroundAction;
+//# sourceMappingURL=playground.action.js.map

package/engine/actions/playground.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.action.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/actions/playground.action.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,uCAAoE;AAEpE,uFAAgF;AAEhF,+FAAwF;AAIxF;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,YAAoB;IACpD,OAAO,CAAC,OAAgB,EAAE,IAAqB,EAAqB,EAAE;;QACrE,IAAI;YACH,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;gBACrB,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;aAC7E;YAED,MAAM,WAAW,GAAiC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;YAEvG,IAAI,CAAC,WAAW,EAAE;gBACjB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;aAC/F;YAED,MAAM,SAAS,GACd,MAAA,WAAW,CAAC,YAAY,CAAC,WAAW,CAAC,mCAAI,WAAW,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YAChF,MAAM,iBAAiB,GAAqB,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YACzE,MAAM,SAAS,GAAW,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC;gBAC1E,CAAC,CAAC,MAAA,MAAA,IAAA,yDAA0B,EAAC,iBAAiB,CAAC,CAAC,QAAQ,0CAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,mCAAI,EAAE;gBACvF,CAAC,CAAC,EAAE,CAAC;YAEN,MAAM,cAAc,GAA8B,IAAA,mDAAuB,EAAC,WAAW,CAAC,CAAC;YAEvF,OAAO;gBACN,MAAM,EAAE,0BAA0B,YAAY;6BACrB,SAAS;wBACd,IAAA,iBAAU,EAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;2BACvC;gBACvB,YAAY,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC;aACzD,CAAC;SACF;QAAC,OAAO,CAAC,EAAE;YACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,EAAE,CAAC,CAAC;YAErE,OAAO,EAAC,MAAM,EAAE,EAAE,EAAC,CAAC;SACpB;IACF,CAAC,CAAC;AACH,CAAC;AAnCD,4CAmCC"}

package/engine/actions.d.ts

@@ -0,0 +1,9 @@
+import { NgDocPageEntity } from './entities/page.entity';
+import { NgDocDemoActionOptions } from './interfaces';
+export declare class NgDocActions {
+    private readonly page;
+    constructor(page: NgDocPageEntity);
+    demo(className: string, options?: NgDocDemoActionOptions): string;
+    playground(playgroundId: string): string;
+    private performAction;
+}

package/engine/actions.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NgDocActions = void 0;
+const demo_action_1 = require("./actions/demo.action");
+const playground_action_1 = require("./actions/playground.action");
+class NgDocActions {
+    constructor(page) {
+        this.page = page;
+    }
+    demo(className, options) {
+        return this.performAction((0, demo_action_1.demoAction)(className, options)).output;
+    }
+    playground(playgroundId) {
+        const output = this.performAction((0, playground_action_1.playgroundAction)(playgroundId));
+        return output.output;
+    }
+    performAction(action) {
+        var _a;
+        const output = action(this.page.sourceFile.getProject(), this.page);
+        this.page.dependencies.add(...((_a = output.dependencies) !== null && _a !== void 0 ? _a : []));
+        return output;
+    }
+}
+exports.NgDocActions = NgDocActions;
+//# sourceMappingURL=actions.js.map

package/engine/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../../libs/builder/engine/actions.ts"],"names":[],"mappings":";;;AAEA,uDAAiD;AACjD,mEAA6D;AAI7D,MAAa,YAAY;IACxB,YAA6B,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAEtD,IAAI,CAAC,SAAiB,EAAE,OAAgC;QACvD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAA,wBAAU,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAClE,CAAC;IAED,UAAU,CAAC,YAAoB;QAC9B,MAAM,MAAM,GAAsB,IAAI,CAAC,aAAa,CAAC,IAAA,oCAAgB,EAAC,YAAY,CAAC,CAAC,CAAC;QAErF,OAAO,MAAM,CAAC,MAAM,CAAC;IACtB,CAAC;IAEO,aAAa,CAAC,MAAmB;;QACxC,MAAM,MAAM,GAAsB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,MAAA,MAAM,CAAC,YAAY,mCAAI,EAAE,CAAC,CAAC,CAAC;QAE3D,OAAO,MAAM,CAAC;IACf,CAAC;CACD;AApBD,oCAoBC"}

package/engine/builder.d.ts

@@ -0,0 +1,16 @@
+import { Observable } from 'rxjs';
+import { NgDocBuilderContext } from '../interfaces';
+import { NgDocSkeletonEntity } from './entities';
+import { NgDocEntity } from './entities/abstractions/entity';
+import { NgDocEntityStore } from './entity-store';
+export declare class NgDocBuilder {
+    readonly context: NgDocBuilderContext;
+    readonly entities: NgDocEntityStore;
+    readonly skeleton: NgDocSkeletonEntity;
+    private readonly project;
+    private readonly watcher;
+    constructor(context: NgDocBuilderContext);
+    run(): Observable<void>;
+    get(id: string): NgDocEntity | undefined;
+    private collectGarbage;
+}

package/engine/builder.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NgDocBuilder = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@ng-doc/core");
+const path = tslib_1.__importStar(require("path"));
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const helpers_1 = require("../helpers");
+const operators_2 = require("../operators");
+const buffer_until_once_1 = require("../operators/buffer-until-once");
+const fork_join_or_empty_1 = require("../operators/fork-join-or-empty");
+const entities_1 = require("./entities");
+const entity_life_cycle_1 = require("./entity-life-cycle");
+const entity_store_1 = require("./entity-store");
+const build_candidates_1 = require("./functions/build-candidates");
+const variables_1 = require("./variables");
+const watcher_1 = require("./watcher");
+class NgDocBuilder {
+    constructor(context) {
+        this.context = context;
+        this.entities = new entity_store_1.NgDocEntityStore();
+        this.skeleton = new entities_1.NgDocSkeletonEntity(this, this.context);
+        this.project = (0, helpers_1.createProject)({
+            tsConfigFilePath: this.context.tsConfig,
+            compilerOptions: {
+                rootDir: this.context.context.workspaceRoot,
+                outDir: variables_1.CACHE_PATH,
+            },
+        });
+        this.watcher = new watcher_1.NgDocWatcher().watch((0, core_1.asArray)(this.context.options.ngDoc.pages)
+            .map((pagesPath) => [
+            path.join(pagesPath, variables_1.PAGE_PATTERN),
+            path.join(pagesPath, variables_1.CATEGORY_PATTERN),
+            path.join(pagesPath, variables_1.PAGE_DEPENDENCY_PATTERN),
+            path.join(pagesPath, variables_1.API_PATTERN),
+        ])
+            .flat());
+    }
+    run() {
+        console.time('Build');
+        const entities = (0, rxjs_1.merge)((0, entity_life_cycle_1.entityLifeCycle)(this, this.project, this.watcher, variables_1.PAGE_PATTERN, entities_1.NgDocPageEntity), (0, entity_life_cycle_1.entityLifeCycle)(this, this.project, this.watcher, variables_1.CATEGORY_PATTERN, entities_1.NgDocCategoryEntity), (0, entity_life_cycle_1.entityLifeCycle)(this, this.project, this.watcher, variables_1.PAGE_DEPENDENCY_PATTERN, entities_1.NgDocDependenciesEntity), (0, entity_life_cycle_1.entityLifeCycle)(this, this.project, this.watcher, variables_1.API_PATTERN, entities_1.NgDocApiEntity)).pipe((0, buffer_until_once_1.bufferUntilOnce)(this.watcher.onReady()), (0, operators_1.map)((entities) => entities.flat()));
+        return entities.pipe((0, operators_1.tap)(() => this.context.context.reportRunning()), (0, operators_1.mergeMap)((entities) => {
+            /*
+                Refresh and compile source files for all not destroyed entities
+            */
+            return (0, fork_join_or_empty_1.forkJoinOrEmpty)(entities.map((entity) => (entity.destroyed ? (0, rxjs_1.of)(null) : entity.emit()))).pipe((0, operators_1.mapTo)(entities));
+        }), (0, operators_1.switchMap)((entities) => (0, rxjs_1.from)(this.project.emit()).pipe((0, operators_1.mapTo)(entities))), (0, operators_1.mergeMap)((entities) => {
+            // Re-fetch compiled data for non destroyed entities
+            return (0, fork_join_or_empty_1.forkJoinOrEmpty)(entities.map((entity) => entity.destroyed
+                ? (0, rxjs_1.of)(entity)
+                : entity.update().pipe((0, operators_1.catchError)((e) => {
+                    this.context.context.logger.error(`\n\nNgDoc error: ${e.message}\n${e.stack}`);
+                    return (0, rxjs_1.of)(void 0);
+                }), (0, operators_1.mapTo)(entity)))).pipe((0, operators_1.switchMap)((entities) => entities.length
+                ? (0, rxjs_1.merge)(...entities.map((entity) => 
+                // Watch for dependency changes of non-destroyed entities
+                entity.destroyed
+                    ? (0, rxjs_1.of)(entity)
+                    : entity.dependencies.changes().pipe((0, operators_1.switchMap)((dependencies) => this.watcher.watch(dependencies).onChange(...dependencies)), (0, operators_1.startWith)(null), (0, operators_1.mapTo)(entity), (0, operators_1.takeUntil)(entity.onDestroy()))))
+                : (0, rxjs_1.of)(null)));
+        }), (0, operators_2.bufferDebounce)(0), (0, operators_1.map)((entities) => entities.filter(core_1.isPresent)), (0, operators_1.tap)(() => this.entities.updateKeywordMap(this.context.options.ngDoc.keywords)), 
+        // Build touched entities and their dependencies
+        (0, operators_1.mergeMap)((entities) => (0, fork_join_or_empty_1.forkJoinOrEmpty)((0, build_candidates_1.buildCandidates)(entities).map((entity) => entity.destroyed ? (0, rxjs_1.of)([]) : entity.buildArtifacts())).pipe((0, operators_1.switchMap)((output) => this.skeleton
+            .buildArtifacts()
+            .pipe((0, operators_1.map)((skeleton) => [...output.flat(), ...skeleton]))), (0, operators_1.tap)((output) => {
+            /*
+                We emit files and only after that delete destroyed ones, because otherwise
+                angular compiler can raise an error that these items are not exist
+             */
+            (0, helpers_1.emitBuiltOutput)(...output);
+            this.collectGarbage();
+        }))), (0, operators_1.mapTo)(void 0), (0, operators_1.catchError)((e) => {
+            this.context.context.logger.error(`NgDoc error: ${e.message}\n${e.stack}`);
+            return (0, rxjs_1.of)(void 0);
+        }));
+    }
+    get(id) {
+        return this.entities.get(id);
+    }
+    collectGarbage() {
+        this.entities.asArray().forEach((entity) => {
+            if (entity.destroyed) {
+                entity.removeArtifacts();
+                this.entities.delete(entity.id);
+            }
+        });
+    }
+}
+exports.NgDocBuilder = NgDocBuilder;
+//# sourceMappingURL=builder.js.map

package/engine/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../libs/builder/engine/builder.ts"],"names":[],"mappings":";;;;AAAA,uCAAgD;AAChD,mDAA6B;AAC7B,+BAAiD;AACjD,8CAAsG;AAGtG,wCAA0D;AAE1D,4CAA4C;AAC5C,sEAA+D;AAC/D,wEAAgE;AAChE,yCAMoB;AAEpB,2DAAoD;AACpD,iDAAgD;AAChD,mEAA6D;AAC7D,2CAA6G;AAC7G,uCAAuC;AAEvC,MAAa,YAAY;IAMxB,YAAqB,OAA4B;QAA5B,YAAO,GAAP,OAAO,CAAqB;QALxC,aAAQ,GAAqB,IAAI,+BAAgB,EAAE,CAAC;QACpD,aAAQ,GAAwB,IAAI,8BAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAKpF,IAAI,CAAC,OAAO,GAAG,IAAA,uBAAa,EAAC;YAC5B,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YACvC,eAAe,EAAE;gBAChB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa;gBAC3C,MAAM,EAAE,sBAAU;aAClB;SACD,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,IAAI,sBAAY,EAAE,CAAC,KAAK,CACtC,IAAA,cAAO,EAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;aACvC,GAAG,CAAC,CAAC,SAAiB,EAAE,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAY,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,4BAAgB,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mCAAuB,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAW,CAAC;SACjC,CAAC;aACD,IAAI,EAAE,CACR,CAAC;IACH,CAAC;IAED,GAAG;QACF,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,QAAQ,GAA8B,IAAA,YAAK,EAChD,IAAA,mCAAe,EAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,wBAAY,EAAE,0BAAe,CAAC,EAChF,IAAA,mCAAe,EAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,4BAAgB,EAAE,8BAAmB,CAAC,EACxF,IAAA,mCAAe,EAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,mCAAuB,EAAE,kCAAuB,CAAC,EACnG,IAAA,mCAAe,EAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,uBAAW,EAAE,yBAAc,CAAC,CAC9E,CAAC,IAAI,CACL,IAAA,mCAAe,EAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EACvC,IAAA,eAAG,EAAC,CAAC,QAAyB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CACnD,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CACnB,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,EAC/C,IAAA,oBAAQ,EAAC,CAAC,QAAuB,EAAE,EAAE;YACpC;;cAEE;YACF,OAAO,IAAA,oCAAe,EACrB,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAmB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,SAAE,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CACpF,CAAC,IAAI,CAAC,IAAA,iBAAK,EAAC,QAAQ,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC,EACF,IAAA,qBAAS,EAAC,CAAC,QAAuB,EAAE,EAAE,CAAC,IAAA,WAAI,EAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAA,iBAAK,EAAC,QAAQ,CAAC,CAAC,CAAC,EACvF,IAAA,oBAAQ,EAAC,CAAC,QAAuB,EAAE,EAAE;YACpC,oDAAoD;YACpD,OAAO,IAAA,oCAAe,EACrB,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAmB,EAAE,EAAE,CACpC,MAAM,CAAC,SAAS;gBACf,CAAC,CAAC,IAAA,SAAE,EAAC,MAAM,CAAC;gBACZ,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CACpB,IAAA,sBAAU,EAAC,CAAC,CAAQ,EAAE,EAAE;oBACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;oBAE/E,OAAO,IAAA,SAAE,EAAC,KAAK,CAAC,CAAC,CAAC;gBACnB,CAAC,CAAC,EACF,IAAA,iBAAK,EAAC,MAAM,CAAC,CACZ,CACJ,CACD,CAAC,IAAI,CACL,IAAA,qBAAS,EAAC,CAAC,QAAuB,EAAE,EAAE,CACrC,QAAQ,CAAC,MAAM;gBACd,CAAC,CAAC,IAAA,YAAK,EACL,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAmB,EAAE,EAAE;gBACvC,yDAAyD;gBACzD,MAAM,CAAC,SAAS;oBACf,CAAC,CAAC,IAAA,SAAE,EAAC,MAAM,CAAC;oBACZ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,CAClC,IAAA,qBAAS,EAAC,CAAC,YAAsB,EAAE,EAAE,CACpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,CAC1D,EACD,IAAA,qBAAS,EAAC,IAAI,CAAC,EACf,IAAA,iBAAK,EAAC,MAAM,CAAC,EACb,IAAA,qBAAS,EAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAC5B,CACJ,CACA;gBACH,CAAC,CAAC,IAAA,SAAE,EAAC,IAAI,CAAC,CACX,CACD,CAAC;QACH,CAAC,CAAC,EACF,IAAA,0BAAc,EAAC,CAAC,CAAC,EACjB,IAAA,eAAG,EAAC,CAAC,QAAmC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAS,CAAC,CAAC,EACxE,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9E,gDAAgD;QAChD,IAAA,oBAAQ,EAAC,CAAC,QAAuB,EAAE,EAAE,CACpC,IAAA,oCAAe,EACd,IAAA,kCAAe,EAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAmB,EAAE,EAAE,CACrD,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,SAAE,EAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,CACnD,CACD,CAAC,IAAI,CACL,IAAA,qBAAS,EAAC,CAAC,MAA4B,EAAE,EAAE,CAC1C,IAAI,CAAC,QAAQ;aACX,cAAc,EAAE;aAChB,IAAI,CAAC,IAAA,eAAG,EAAC,CAAC,QAA4B,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAC9E,EACD,IAAA,eAAG,EAAC,CAAC,MAA0B,EAAE,EAAE;YAClC;;;eAGG;YACH,IAAA,yBAAe,EAAC,GAAG,MAAM,CAAC,CAAC;YAC3B,IAAI,CAAC,cAAc,EAAE,CAAC;QACvB,CAAC,CAAC,CACF,CACD,EACD,IAAA,iBAAK,EAAC,KAAK,CAAC,CAAC,EACb,IAAA,sBAAU,EAAC,CAAC,CAAQ,EAAE,EAAE;YACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAE3E,OAAO,IAAA,SAAE,EAAC,KAAK,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,CAC6B,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAEO,cAAc;QACrB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,MAAmB,EAAE,EAAE;YACvD,IAAI,MAAM,CAAC,SAAS,EAAE;gBACrB,MAAM,CAAC,eAAe,EAAE,CAAC;gBACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;aAChC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AArID,oCAqIC"}