@ng-doc/builder 15.0.0-beta.33 → 15.0.0-beta.34

package/helpers/marked.js.map

@@ -1 +1 @@
-{"version":3,"file":"marked.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/marked.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,mCAA8C;AAE9C,MAAM,WAAW,GAAW,0BAA0B,CAAC;AACvD,MAAM,cAAc,GAAW,6BAA6B,CAAC;AAE7D;;;;GAIG;AACH,SAAgB,MAAM,CAAC,QAAgB;IACtC,MAAM,QAAQ,GAAgC;QAC7C,IAAI,CAAC,IAAY,EAAE,QAA4B;YAC9C,MAAM,IAAI,GAAW,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,YAAY,CAAC;YAE9C,OAAO,8BAA8B,IAAI,WAAW,IAAI,KAAK,IAAA,iBAAU,EAAC,IAAI,CAAC,eAAe,CAAC;QAC9F,CAAC;QACD,UAAU,CAAC,KAAa;YACvB,IAAI,IAAI,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBAC9C,OAAO,kCAAkC,KAAK,CAAC,OAAO,CACrD,IAAI,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,EACjC,KAAK,CACL,sBAAsB,CAAC;aACxB;YAED,IAAI,IAAI,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBACjD,OAAO,qCAAqC,KAAK,CAAC,OAAO,CACxD,IAAI,MAAM,CAAC,IAAI,cAAc,MAAM,CAAC,EACpC,KAAK,CACL,sBAAsB,CAAC;aACxB;YAED,OAAO,sBAAsB,KAAK,sBAAsB,CAAC;QAC1D,CAAC;KACD,CAAC;IAEF,eAAY,CAAC,GAAG,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC;IAE7B,OAAO,eAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AA7BD,wBA6BC"}
+{"version":3,"file":"marked.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/marked.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,mCAA8C;AAE9C,MAAM,WAAW,GAAW,0BAA0B,CAAC;AACvD,MAAM,cAAc,GAAW,6BAA6B,CAAC;AAE7D;;;;GAIG;AACH,SAAgB,MAAM,CAAC,QAAgB;IACtC,MAAM,QAAQ,GAAgC;QAC7C,IAAI,CAAC,IAAY,EAAE,QAA4B;YAC9C,MAAM,IAAI,GAAW,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,YAAY,CAAC;YAE9C,OAAO,8BAA8B,IAAI,WAAW,IAAI,KAAK,IAAA,iBAAU,EAAC,IAAI,CAAC,eAAe,CAAC;QAC9F,CAAC;QACD,UAAU,CAAC,KAAa;YACvB,IAAI,IAAI,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBAC9C,OAAO,kCAAkC,KAAK,CAAC,OAAO,CACrD,IAAI,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,EACjC,KAAK,CACL,sBAAsB,CAAC;aACxB;YAED,IAAI,IAAI,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBACjD,OAAO,qCAAqC,KAAK,CAAC,OAAO,CACxD,IAAI,MAAM,CAAC,IAAI,cAAc,MAAM,CAAC,EACpC,KAAK,CACL,sBAAsB,CAAC;aACxB;YAED,OAAO,sBAAsB,KAAK,sBAAsB,CAAC;QAC1D,CAAC;KACD,CAAC;IAEF,eAAY,CAAC,GAAG,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC;IAE7B,OAAO,eAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAC,SAAS,EAAE,KAAK,EAAC,CAAC,CAAC;AACzD,CAAC;AA7BD,wBA6BC"}

package/helpers/repo-link.d.ts

@@ -0,0 +1,20 @@
+import { NgDocRepoConfig } from '../interfaces';
+/**
+ *
+ * @param repoConfig
+ * @param repoConfig.url
+ * @param repoConfig.mainBranch
+ * @param filePath
+ * @param scope
+ * @param lineNumber
+ */
+export declare function editFileInRepoUrl({ url, mainBranch }: NgDocRepoConfig, filePath: string, scope: string, lineNumber?: number): string;
+/**
+ *
+ * @param repoConfig
+ * @param repoConfig.url
+ * @param repoConfig.releaseBranch
+ * @param filePath
+ * @param lineNumber
+ */
+export declare function viewFileInRepoUrl({ url, releaseBranch }: NgDocRepoConfig, filePath: string, lineNumber?: number): string;

package/helpers/repo-link.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewFileInRepoUrl = exports.editFileInRepoUrl = void 0;
+const slash_1 = require("./slash");
+/**
+ *
+ * @param repoConfig
+ * @param repoConfig.url
+ * @param repoConfig.mainBranch
+ * @param filePath
+ * @param scope
+ * @param lineNumber
+ */
+function editFileInRepoUrl({ url, mainBranch }, filePath, scope, lineNumber) {
+    if (url && mainBranch) {
+        const rUrl = url.replace(/\/$/, '');
+        const fPath = (0, slash_1.slash)(filePath).replace(/^\//, '');
+        return `${rUrl}/edit/${mainBranch}/${fPath}?message=docs(${scope}): describe your changes here...${lineNumber ? `#L${lineNumber}` : ''}`;
+    }
+    return filePath;
+}
+exports.editFileInRepoUrl = editFileInRepoUrl;
+/**
+ *
+ * @param repoConfig
+ * @param repoConfig.url
+ * @param repoConfig.releaseBranch
+ * @param filePath
+ * @param lineNumber
+ */
+function viewFileInRepoUrl({ url, releaseBranch }, filePath, lineNumber) {
+    if (url && releaseBranch) {
+        const rUrl = url.replace(/\/$/, '');
+        const fPath = (0, slash_1.slash)(filePath).replace(/^\//, '');
+        return `${rUrl}/blob/${releaseBranch}/${fPath}${lineNumber ? `#L${lineNumber}` : ''}`;
+    }
+    return filePath;
+}
+exports.viewFileInRepoUrl = viewFileInRepoUrl;
+//# sourceMappingURL=repo-link.js.map

package/helpers/repo-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-link.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/repo-link.ts"],"names":[],"mappings":";;;AACA,mCAA8B;AAE9B;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAChC,EAAC,GAAG,EAAE,UAAU,EAAkB,EAClC,QAAgB,EAChB,KAAa,EACb,UAAmB;IAEnB,IAAI,GAAG,IAAI,UAAU,EAAE;QACtB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,IAAA,aAAK,EAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAEjD,OAAO,GAAG,IAAI,SAAS,UAAU,IAAI,KAAK,iBAAiB,KAAK,mCAC/D,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,EAClC,EAAE,CAAC;KACH;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAhBD,8CAgBC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAChC,EAAC,GAAG,EAAE,aAAa,EAAkB,EACrC,QAAgB,EAChB,UAAmB;IAEnB,IAAI,GAAG,IAAI,aAAa,EAAE;QACzB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,IAAA,aAAK,EAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAEjD,OAAO,GAAG,IAAI,SAAS,aAAa,IAAI,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;KACtF;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAbD,8CAaC"}

package/helpers/sort-navigation-entities.d.ts

@@ -0,0 +1,6 @@
+import { NgDocNavigationEntity } from '../engine/entities/abstractions/navigation.entity';
+/**
+ *
+ * @param entities
+ */
+export declare function sortNavigationEntities<T>(entities: Array<NgDocNavigationEntity<T>>): Array<NgDocNavigationEntity<T>>;

package/helpers/sort-navigation-entities.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortNavigationEntities = void 0;
+const is_present_1 = require("@ng-doc/core/helpers/is-present");
+/**
+ *
+ * @param entities
+ */
+function sortNavigationEntities(entities) {
+    return entities.sort((a, b) => {
+        if ((0, is_present_1.isPresent)(a.order) && (0, is_present_1.isPresent)(b.order)) {
+            return a.order - b.order;
+        }
+        if ((0, is_present_1.isPresent)(a.order)) {
+            return -1;
+        }
+        if ((0, is_present_1.isPresent)(b.order)) {
+            return 1;
+        }
+        return a.title.localeCompare(b.title);
+    });
+}
+exports.sortNavigationEntities = sortNavigationEntities;
+//# sourceMappingURL=sort-navigation-entities.js.map

package/helpers/sort-navigation-entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-navigation-entities.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/sort-navigation-entities.ts"],"names":[],"mappings":";;;AAAA,gEAA0D;AAI1D;;;GAGG;AACH,SAAgB,sBAAsB,CAAI,QAAyC;IAClF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAA2B,EAAE,CAA2B,EAAE,EAAE;QACjF,IAAI,IAAA,sBAAS,EAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAA,sBAAS,EAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YAC7C,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACzB;QACD,IAAI,IAAA,sBAAS,EAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YACvB,OAAO,CAAC,CAAC,CAAC;SACV;QACD,IAAI,IAAA,sBAAS,EAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YACvB,OAAO,CAAC,CAAC;SACT;QACD,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACJ,CAAC;AAbD,wDAaC"}

package/helpers/typescript/create-project.js

@@ -27,8 +27,8 @@ function createProject(options) {
             ...options === null || options === void 0 ? void 0 : options.compilerOptions,
         },
         skipAddingFilesFromTsConfig: true,
-        skipFileDependencyResolution: true,
-        skipLoadingLibFiles: true,
+        skipFileDependencyResolution: false,
+        skipLoadingLibFiles: false,
     });
 }
 exports.createProject = createProject;

package/helpers/typescript/create-project.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-project.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/typescript/create-project.ts"],"names":[],"mappings":";;;;AAAA,mDAA6B;AAC7B,uCAAmF;AAEnF,sDAAkD;AAElD;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAwB;IACrD,OAAO,IAAI,kBAAO,CAAC;QAClB,GAAG,OAAO;QACV,eAAe,EAAE;YAChB,MAAM,EAAE,qBAAU,CAAC,QAAQ;YAC3B,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,sBAAU,EAAE,uBAAuB,CAAC;YAC/D,gBAAgB,EAAE,+BAAoB,CAAC,MAAM;YAC7C,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,EAAE;YACT,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe;SAC3B;QACD,2BAA2B,EAAE,IAAI;QACjC,4BAA4B,EAAE,IAAI;QAClC,mBAAmB,EAAE,IAAI;KACzB,CAAC,CAAC;AACJ,CAAC;AAnBD,sCAmBC"}
+{"version":3,"file":"create-project.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/typescript/create-project.ts"],"names":[],"mappings":";;;;AAAA,mDAA6B;AAC7B,uCAAmF;AAEnF,sDAAkD;AAElD;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAwB;IACrD,OAAO,IAAI,kBAAO,CAAC;QAClB,GAAG,OAAO;QACV,eAAe,EAAE;YAChB,MAAM,EAAE,qBAAU,CAAC,QAAQ;YAC3B,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,sBAAU,EAAE,uBAAuB,CAAC;YAC/D,gBAAgB,EAAE,+BAAoB,CAAC,MAAM;YAC7C,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,EAAE;YACT,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe;SAC3B;QACD,2BAA2B,EAAE,IAAI;QACjC,4BAA4B,EAAE,KAAK;QACnC,mBAAmB,EAAE,KAAK;KAC1B,CAAC,CAAC;AACJ,CAAC;AAnBD,sCAmBC"}

package/interfaces/builder-context.d.ts

@@ -1,14 +1,14 @@
 import { BuilderContext } from '@angular-devkit/architect';
 import { NgDocStyleType } from '@ng-doc/core';
-import { NgDocSchema } from './schema';
+import { NgDocConfiguration } from './configuration';
 export interface NgDocBuilderContext {
     tsConfig: string;
-    options: NgDocSchema;
+    config: NgDocConfiguration;
     context: BuilderContext;
     inlineStyleLanguage: NgDocStyleType;
     pagesPaths: string[];
     assetsPath: string;
     buildPath: string;
     apiPath: string;
-    modulesPath: string;
+    guidesPath: string;
 }

package/interfaces/configuration.d.ts

@@ -0,0 +1,43 @@
+import { NgDocHeading } from '@ng-doc/core';
+import { NgDocGlobalKeyword } from './keyword-map';
+import { NgDocRepoConfig } from './repo-config';
+/**
+ * NgDoc configuration interface, that configure NgDoc library
+ */
+export interface NgDocConfiguration {
+    /**
+     * List of paths to your documentation location (e.g. "src/app")
+     */
+    pages?: string | string[];
+    /**
+     * Route prefix uses to add some additional route segment before documentation pages,
+     * you can use it e.g. to wrap documentation with additional route like "docs".
+     */
+    routePrefix?: string;
+    /**
+     * List of the global keywords, to create link to foreign websites
+     */
+    keywords?: Record<string, NgDocGlobalKeyword>;
+    /**
+     * The repository configuration.
+     * If it is defined, Ngoc will use it to display the "Suggest edits" button, and "View source" button, on each page.
+     */
+    repoConfig?: NgDocRepoConfig;
+    /**
+     * The path to the tsconfig file (NgDoc uses tsconfig of your application by default, but you can override it)
+     */
+    tsConfig?: string;
+    /**
+     * The configuration for the guides
+     */
+    guide?: NgDocGuideConfiguration;
+}
+/**
+ * The configuration for the guide page
+ */
+export interface NgDocGuideConfiguration {
+    /**
+     * Defines a list of the heading levels for which the anchor will be generated.
+     */
+    anchorHeadings?: NgDocHeading[];
+}

package/{engine/interfaces/entity-output.js → interfaces/configuration.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=entity-output.js.map
+//# sourceMappingURL=configuration.js.map

package/interfaces/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../../libs/builder/interfaces/configuration.ts"],"names":[],"mappings":""}

package/interfaces/index.d.ts

@@ -2,8 +2,10 @@ export * from './action-output';
 export * from './asset';
 export * from './builder-context';
 export * from './built-output';
+export * from './configuration';
 export * from './keyword-map';
 export * from './page-index';
 export * from './path-anchor';
 export * from './renderer-options';
+export * from './repo-config';
 export * from './schema';

package/interfaces/index.js

@@ -5,9 +5,11 @@ tslib_1.__exportStar(require("./action-output"), exports);
 tslib_1.__exportStar(require("./asset"), exports);
 tslib_1.__exportStar(require("./builder-context"), exports);
 tslib_1.__exportStar(require("./built-output"), exports);
+tslib_1.__exportStar(require("./configuration"), exports);
 tslib_1.__exportStar(require("./keyword-map"), exports);
 tslib_1.__exportStar(require("./page-index"), exports);
 tslib_1.__exportStar(require("./path-anchor"), exports);
 tslib_1.__exportStar(require("./renderer-options"), exports);
+tslib_1.__exportStar(require("./repo-config"), exports);
 tslib_1.__exportStar(require("./schema"), exports);
 //# sourceMappingURL=index.js.map

package/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/builder/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,kDAAwB;AACxB,4DAAkC;AAClC,yDAA+B;AAC/B,wDAA8B;AAC9B,uDAA6B;AAC7B,wDAA8B;AAC9B,6DAAmC;AACnC,mDAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/builder/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,kDAAwB;AACxB,4DAAkC;AAClC,yDAA+B;AAC/B,0DAAgC;AAChC,wDAA8B;AAC9B,uDAA6B;AAC7B,wDAA8B;AAC9B,6DAAmC;AACnC,wDAA8B;AAC9B,mDAAyB"}

package/interfaces/repo-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The repository configuration interface.
+ */
+export interface NgDocRepoConfig {
+    /**
+     * The URL of the repository (e.g. "https://github.com/skoropadas/ng-doc")
+     */
+    url: string;
+    /**
+     * The develop branch name (e.g. "master"/"main")
+     */
+    mainBranch: string;
+    /**
+     * The release branch name (e.g. "release"), uses to generate correct links for the "View source" button
+     */
+    releaseBranch: string;
+}

package/{engine/interfaces/actions/demo-options.js → interfaces/repo-config.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=demo-options.js.map
+//# sourceMappingURL=repo-config.js.map

package/interfaces/repo-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-config.js","sourceRoot":"","sources":["../../../../libs/builder/interfaces/repo-config.ts"],"names":[],"mappings":""}

package/interfaces/schema.d.ts

@@ -1,29 +1,9 @@
-import { NgDocGlobalKeyword } from './keyword-map';
+import { NgDocConfiguration } from './configuration';
 export interface NgDocSchema {
     browserTarget: string;
     main: string;
-    ngDoc?: NgDocConfiguration;
-}
-/**
- * NgDoc configuration interface, that configure NgDoc library
- */
-export interface NgDocConfiguration {
     /**
-     * List of paths to your documentation location (e.g. "src/app")
+     * @deprecated Please use `ng-doc.config.js` file instead. Check our configuration guide for more details.
      */
-    pages?: string | string[];
-    /**
-     * Route prefix uses to add some additional route segment before documentation pages,
-     * you can use it e.g. to wrap documentation with additional route like "docs".
-     */
-    routePrefix?: string;
-    /**
-     * Tag for of the current target, you can use it in conjunction with the `onlyForTags` field in your pages to
-     * hide pages for certain documentation builds
-     */
-    tag?: string;
-    /**
-     * List of the global keywords, to create link to foreign websites
-     */
-    keywords?: Record<string, NgDocGlobalKeyword>;
+    ngDoc?: NgDocConfiguration;
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@ng-doc/builder",
-  "version": "15.0.0-beta.33",
+  "version": "15.0.0-beta.34",
   "type": "commonjs",
   "builders": "./builders.json",
   "schematics": "./schematics/collection.json",
   "dependencies": {
-    "@ng-doc/core": "15.0.0-beta.33",
+    "@ng-doc/core": "15.0.0-beta.34",
     "@angular-devkit/architect": ">=0.1500.0",
     "chokidar": "^3.5.3",
     "minimatch": "^5.1.0",
@@ -21,10 +21,17 @@
     "rehype": "^9.0.1",
     "rehype-format": "^3.1.0",
     "rehype-highlight": "^4.1.0",
-    "rehype-slug": "^4.0.0",
+    "hast-util-to-string": "^1.0.4",
+    "unist-util-visit": "^2.0.1",
+    "github-slugger": "^1.5.0",
+    "hast-util-heading-rank": "^1.0.1",
+    "hast-util-has-property": "^1.0.4",
     "highlight.js": "^11.5.1",
     "raw-loader": "^4.0.2",
-    "@microsoft/tsdoc": "^0.14.2"
+    "esbuild": "^0.17.8",
+    "@microsoft/tsdoc": "^0.14.2",
+    "cosmiconfig": "^8.1.0",
+    "cosmiconfig-typescript-swc-loader": "^0.0.2"
   },
   "publishConfig": {
     "access": "public"

package/schematics/page/index.js

@@ -20,7 +20,7 @@ function build(options) {
         const closestCategoryFile = options.category
             ? (0, helpers_1.findClosestFile)(options.path, engine_1.CATEGORY_NAME)
             : null;
-        const pageName = (0, strings_1.classify)(options.title);
+        const pageName = (0, strings_1.classify)(options.title + 'Page');
         const categoryConstantName = options.category && closestCategoryFile ? (0, utils_1.extractDefaultExportName)(closestCategoryFile) : null;
         const categoryImportPath = closestCategoryFile
             ? (0, path_1.relative)(path, closestCategoryFile).replace(/.ts$/, '')

package/schematics/page/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/builder/schematics/page/index.ts"],"names":[],"mappings":";;;AAAA,oEAA2E;AAC3E,2DAaoC;AACpC,+BAA8C;AAE9C,yCAA2C;AAC3C,2CAA8C;AAC9C,oCAAkD;AAGlD,MAAM,aAAa,GAAa,CAAC,2BAA2B,EAAE,iCAAiC,CAAC,CAAC;AAEjG;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,OAA6B;IAClD,OAAO,CAAC,IAAU,EAAE,EAAE;QACrB,MAAM,IAAI,GAAW,IAAA,WAAI,EAAC,OAAO,CAAC,IAAI,EAAE,IAAI,IAAA,mBAAS,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,mBAAmB,GAAkB,OAAO,CAAC,QAAQ;YAC1D,CAAC,CAAC,IAAA,yBAAe,EAAC,OAAO,CAAC,IAAI,EAAE,sBAAa,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC;QACR,MAAM,QAAQ,GAAW,IAAA,kBAAQ,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,oBAAoB,GACzB,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAAC,CAAC,CAAC,IAAA,gCAAwB,EAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,MAAM,kBAAkB,GAAkB,mBAAmB;YAC5D,CAAC,CAAC,IAAA,eAAQ,EAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACzD,CAAC,CAAC,IAAI,CAAC;QAER,OAAO,IAAA,kBAAK,EAAC;YACZ,IAAA,sBAAS,EACR,IAAA,kBAAK,EAAC,IAAA,gBAAG,EAAC,SAAS,CAAC,EAAE;gBACrB,IAAA,mBAAM,EACL,CAAC,IAAY,EAAE,EAAE,CAChB,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;oBACxD,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC,CACxC;gBACD,IAAA,2BAAc,EAAC;oBACd,GAAG,OAAO;oBACV,YAAY,EAAE,oBAAoB;oBAClC,UAAU,EAAE,kBAAkB;oBAC9B,QAAQ;oBACR,OAAO,EAAE,OAAO,CAAC,OAAO;iBACxB,CAAC;gBACF,IAAA,iBAAI,EAAC,IAAI,CAAC;gBACV,IAAA,oBAAO,EAAC,CAAC,SAAoB,EAAE,EAAE;oBAChC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;wBAChC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;qBAClD;oBACD,OAAO,SAAS,CAAC;gBAClB,CAAC,CAAC;aACF,CAAC,EACF,0BAAa,CAAC,SAAS,CACvB;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC;AAxCD,sBAwCC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/builder/schematics/page/index.ts"],"names":[],"mappings":";;;AAAA,oEAA2E;AAC3E,2DAaoC;AACpC,+BAA8C;AAE9C,yCAA2C;AAC3C,2CAA8C;AAC9C,oCAAkD;AAGlD,MAAM,aAAa,GAAa,CAAC,2BAA2B,EAAE,iCAAiC,CAAC,CAAC;AAEjG;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,OAA6B;IAClD,OAAO,CAAC,IAAU,EAAE,EAAE;QACrB,MAAM,IAAI,GAAW,IAAA,WAAI,EAAC,OAAO,CAAC,IAAI,EAAE,IAAI,IAAA,mBAAS,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,mBAAmB,GAAkB,OAAO,CAAC,QAAQ;YAC1D,CAAC,CAAC,IAAA,yBAAe,EAAC,OAAO,CAAC,IAAI,EAAE,sBAAa,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC;QACR,MAAM,QAAQ,GAAW,IAAA,kBAAQ,EAAC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QAC1D,MAAM,oBAAoB,GACzB,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAAC,CAAC,CAAC,IAAA,gCAAwB,EAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,MAAM,kBAAkB,GAAkB,mBAAmB;YAC5D,CAAC,CAAC,IAAA,eAAQ,EAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACzD,CAAC,CAAC,IAAI,CAAC;QAER,OAAO,IAAA,kBAAK,EAAC;YACZ,IAAA,sBAAS,EACR,IAAA,kBAAK,EAAC,IAAA,gBAAG,EAAC,SAAS,CAAC,EAAE;gBACrB,IAAA,mBAAM,EACL,CAAC,IAAY,EAAE,EAAE,CAChB,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;oBACxD,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC,CACxC;gBACD,IAAA,2BAAc,EAAC;oBACd,GAAG,OAAO;oBACV,YAAY,EAAE,oBAAoB;oBAClC,UAAU,EAAE,kBAAkB;oBAC9B,QAAQ;oBACR,OAAO,EAAE,OAAO,CAAC,OAAO;iBACxB,CAAC;gBACF,IAAA,iBAAI,EAAC,IAAI,CAAC;gBACV,IAAA,oBAAO,EAAC,CAAC,SAAoB,EAAE,EAAE;oBAChC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;wBAChC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;qBAClD;oBACD,OAAO,SAAS,CAAC;gBAClB,CAAC,CAAC;aACF,CAAC,EACF,0BAAa,CAAC,SAAS,CACvB;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC;AAxCD,sBAwCC"}

package/templates/api-page.module.ts.nunj

@@ -3,14 +3,22 @@ import {ChangeDetectionStrategy, Component, NgModule, Type} from "@angular/core"
 import {RouterModule} from "@angular/router";
 import {CommonModule} from '@angular/common';
 import {NgDocDemoAssets, NgDocPageModule, NgDocRootPage} from '@ng-doc/app';
+import {NgDocPageType} from '@ng-doc/core';
 import pageContent from '!!raw-loader!{{ page.builtPagePath }}';
 
 @Component({
 	template: `<ng-doc-page></ng-doc-page>`,
 	changeDetection: ChangeDetectionStrategy.OnPush,
-	providers: [{provide: NgDocRootPage, useExisting: {{ page.componentName }}}],
+	providers: [{provide: NgDocRootPage, useExisting: DynamicComponent}],
 })
-export class {{ page.componentName }} extends NgDocRootPage {
+export class DynamicComponent extends NgDocRootPage {
+	readonly pageType: NgDocPageType = 'api';
+	{%- if page.editSourceFileUrl %}
+	readonly editSourceFileUrl: string = '{{ page.editSourceFileUrl }}';
+	{%- endif %}
+	{%- if page.viewSourceFileUrl %}
+	readonly viewSourceFileUrl: string = '{{ page.viewSourceFileUrl }}';
+	{%- endif %}
 	readonly pageContent: string = pageContent;
 	readonly demo: Record<string, Type<unknown>> | undefined = undefined;
 	readonly demoAssets: NgDocDemoAssets | undefined = undefined;
@@ -21,17 +29,17 @@ export class {{ page.componentName }} extends NgDocRootPage {
 }
 
 @NgModule({
-	declarations: [{{ page.componentName }}],
+	declarations: [DynamicComponent],
 	imports: [
 		CommonModule,
 		NgDocPageModule,
 		RouterModule.forChild([{
 			path: '',
-			component: {{ page.componentName }},
+			component: DynamicComponent,
 			title: '{{ page.title }}',
 		}]),
 	],
 	exports: [RouterModule]
 })
-export class {{ page.moduleName }} {
+export class DynamicModule {
 }

package/templates/api-scope.module.ts.nunj

@@ -14,7 +14,7 @@ import {RouterModule} from "@angular/router";
 					{%- for page in scope.children %}
 					{
 						path: '{{ page.route }}',
-						loadChildren: () => import('{{ page.moduleImport }}').then(m => m.{{ page.moduleName }})
+						loadChildren: () => import('{{ page.moduleImport }}').then(m => m.DynamicModule)
 					},
 					{%- endfor %}
 				]
@@ -23,5 +23,5 @@ import {RouterModule} from "@angular/router";
 	],
 	exports: [RouterModule]
 })
-export class {{ scope.moduleName }} {
+export class DynamicModule {
 }

package/templates/api.module.ts.nunj

@@ -13,28 +13,28 @@ import apiList from './ng-doc.api-list.json';
 	}],
 	changeDetection: ChangeDetectionStrategy.OnPush,
 })
-export class {{ api.componentName }} {
+export class DynamicComponent {
 }
 
 @NgModule({
-	declarations: [{{ api.componentName }}],
+	declarations: [DynamicComponent],
 	imports: [
 		CommonModule,
 		NgDocApiListModule,
 		RouterModule.forChild([
 			{
 				path: '',
-				component: {{ api.componentName }},
+				component: DynamicComponent,
 			},
 			{%- for scope in api.children %}
 			{
 				path: '{{ scope.route }}',
-				loadChildren: () => import('{{ scope.moduleImport }}').then(m => m.{{ scope.moduleName }})
+				loadChildren: () => import('{{ scope.moduleImport }}').then(m => m.DynamicModule)
 			},
 			{%- endfor %}
 		]),
 	],
 	exports: [RouterModule]
 })
-export class {{ api.moduleName }} {
+export class DynamicModule {
 }

package/templates/category.module.ts.nunj

@@ -13,7 +13,7 @@ import {RouterModule} from "@angular/router";
 				{%- for child in category.children %}
 				{
 					path: '{{ child.route }}',
-					loadChildren: () => import('{{ child.moduleImport }}').then(m => m.{{ child.moduleName }})
+					loadChildren: () => import('{{ child.moduleImport }}').then(m => m.DynamicModule)
 				},
 				{%- endfor %}
 			]
@@ -22,5 +22,5 @@ import {RouterModule} from "@angular/router";
 	],
 	exports: [RouterModule]
 })
-export class {{ category.moduleName }} {
+export class DynamicModule {
 }

package/templates/context.ts.nunj

@@ -19,14 +19,14 @@ export const ngDocContextProvider: Provider = {
 				{%- endif %}
 				{%- if entity.navigationItems.length %}
 				children: [
-					{%- for child in entity.navigationItems %}
+					{%- for child in entity.navigationItems | sortNavigationEntities %}
 					{{ nav(child) }},
 					{%- endfor %}
 				]
 				{%- endif %}
 			}
 			{%- endmacro %}
-			{%- for entity in entities %}
+			{%- for entity in entities | sortNavigationEntities %}
 			{{ nav(entity) }},
 			{%- endfor %}
 		],

package/templates/helpers/declaration-modifiers.html.nunj

@@ -7,11 +7,13 @@
 	{% set isStatic = declaration.isStatic and declaration.isStatic() %}
 	{% set isAsync = declaration.isAsync and declaration.isAsync() %}
 	{% set isReadonly = declaration.isReadonly and declaration.isReadonly() %}
-	{% set tooltip = ["Abstract" if isAbstract, 'Static' if isStatic, 'Async' if isAsync, 'Readonly' if isReadonly] | noEmpty | join(', ') %}
+	{% set isProtected = declaration.getScope and declaration.getScope() == 'protected'  %}
+	{% set tooltip = ["Protected" if isProtected, "Abstract" if isAbstract, 'Static' if isStatic, 'Async' if isAsync, 'Readonly' if isReadonly] | noEmpty | join(', ') %}
 
 	{%- if type == 'badge' %}
-		{%- if isAbstract or isStatic or isAsync or isReadonly %}
+		{%- if isAbstract or isStatic or isAsync or isReadonly or isProtected %}
 			<span class="ng-doc-badge-wrapper" ngDocTooltip="{{ tooltip }}">
+				{{ badgeMacro.render("protected") if isProtected }}
 				{{ badgeMacro.render("abstract") if isAbstract }}
 				{{ badgeMacro.render("static") if isStatic }}
 				{{ badgeMacro.render("async") if isAsync }}
@@ -20,8 +22,9 @@
 		{%- endif %}
 
 	{%- elseif type == 'modifier' %}
-		{%- if isAbstract or isStatic or isAsync or isReadonly %}
+		{%- if isAbstract or isStatic or isAsync or isReadonly or isProtected %}
 			<div class="ng-doc-modifiers-wrapper">
+				{{ modifierMacro.render("protected") if isProtected }}
 				{{ modifierMacro.render("abstract") if isAbstract }}
 				{{ modifierMacro.render("static") if isStatic }}
 				{{ modifierMacro.render("async") if isAsync }}
@@ -29,8 +32,9 @@
 			</div>
 		{%- endif %}
 	{%- else %}
-		{%- if isAbstract or isStatic or isAsync or isReadonly %}
+		{%- if isAbstract or isStatic or isAsync or isReadonly or isProtected %}
 			<span class="ng-doc-tags-wrapper">
+				{{ tagMacro.render("protected") if isProtected }}
 				{{ tagMacro.render("abstract") if isAbstract }}
 				{{ tagMacro.render("static") if isStatic }}
 				{{ tagMacro.render("async") if isAsync }}

package/templates/page.module.ts.nunj

@@ -3,9 +3,11 @@ import {Component, NgModule, Type, ChangeDetectionStrategy} from '@angular/core'
 import {RouterModule} from '@angular/router';
 import {CommonModule} from '@angular/common';
 import {NgDocPageModule, NgDocRootPage, NgDocDemoAssets} from '@ng-doc/app';
+import {NgDocDependencies, NgDocPageType} from '@ng-doc/core';
 import pageContent from '!!raw-loader!{{ page.builtPagePath }}';
 {%- if page.pageDependencies %}
 // noinspection ES6UnusedImports
+import {PlaygroundsModule} from './playgrounds';
 import pageDependencies from '{{ page.pageDependencies.importPath }}';
 {%- endif %}
 {%- if page.componentsAssets %}
@@ -17,14 +19,24 @@ import demoAssets from '{{ page.componentsAssets }}';
 @Component({
 	template: `<ng-doc-page></ng-doc-page>`,
 	changeDetection: ChangeDetectionStrategy.OnPush,
-	providers: [{provide: NgDocRootPage, useExisting: {{ page.componentName }}}],
+	providers: [{provide: NgDocRootPage, useExisting: DynamicComponent}],
 })
-export class {{ page.componentName }} extends NgDocRootPage {
+export class DynamicComponent extends NgDocRootPage {
+	readonly pageType: NgDocPageType = 'guide';
 	readonly pageContent: string = pageContent;
+
+	{%- if page.editSourceFileUrl %}
+	readonly editSourceFileUrl: string = '{{ page.editSourceFileUrl }}';
+	{%- endif %}
+
+	{%- if page.viewSourceFileUrl %}
+	readonly viewSourceFileUrl: string = '{{ page.viewSourceFileUrl }}';
+	{%- endif %}
+
 	{%- if page.pageDependencies %}
-	readonly demo: Record<string, Type<unknown>> | undefined = pageDependencies.demo;
-	readonly module: Type<unknown> | undefined = pageDependencies.module;
+	readonly dependencies?: NgDocDependencies = pageDependencies;
 	{%- endif %}
+
 	{%- if page.componentsAssets %}
 	readonly demoAssets: NgDocDemoAssets = demoAssets;
 	{%- endif %}
@@ -35,21 +47,22 @@ export class {{ page.componentName }} extends NgDocRootPage {
 }
 
 @NgModule({
-	declarations: [{{ page.componentName }}],
+	declarations: [DynamicComponent],
 	imports: [
 		CommonModule,
 		NgDocPageModule,
 		{%- if page.pageDependencies %}
 		pageDependencies.module,
+		PlaygroundsModule,
 		{%- endif %}
 		RouterModule.forChild([{
 			path: '',
-			component: {{ page.componentName }},
+			component: DynamicComponent,
 			title: '{{ page.title }}',
 		}]),
 	],
 	exports: [RouterModule]
 })
-export class {{ page.moduleName }} {
+export class DynamicModule {
 }