@ng-doc/builder 15.5.1 → 15.7.0

package/helpers/create-builder-context.js

@@ -4,6 +4,7 @@ exports.createBuilderContext = void 0;
 const tslib_1 = require("tslib");
 const core_1 = require("@ng-doc/core");
 const path = tslib_1.__importStar(require("path"));
+const load_config_1 = require("./load-config");
 /**
  *
  * @param targetOptions
@@ -12,14 +13,20 @@ const path = tslib_1.__importStar(require("path"));
  * @param project
  */
 function createBuilderContext(targetOptions, options, context) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g;
     const buildPath = path.join(context.workspaceRoot, '.ng-doc', (_b = (_a = context.target) === null || _a === void 0 ? void 0 : _a.project) !== null && _b !== void 0 ? _b : 'app');
+    const projectRoot = path.join(context.workspaceRoot, path.dirname(targetOptions['main']));
+    if (Object.keys((_c = options.ngDoc) !== null && _c !== void 0 ? _c : {}).length) {
+        context.logger.warn('`ngDoc` field in `angular.json` file is deprecated and will be removed in the next major release.\n' +
+            'Please use configuration file to configure NgDoc. For more information, see https://ng-doc.com/getting-started/configuration#builder-configuration');
+    }
+    const config = { ...options.ngDoc, ...(0, load_config_1.loadConfig)(projectRoot) };
     return {
-        tsConfig: (_d = (_c = options.ngDoc) === null || _c === void 0 ? void 0 : _c.tsConfig) !== null && _d !== void 0 ? _d : String(targetOptions['tsConfig']),
-        options,
+        tsConfig: (_e = (_d = options.ngDoc) === null || _d === void 0 ? void 0 : _d.tsConfig) !== null && _e !== void 0 ? _e : String(targetOptions['tsConfig']),
+        config,
         context,
-        inlineStyleLanguage: (_e = targetOptions === null || targetOptions === void 0 ? void 0 : targetOptions['inlineStyleLanguage']) !== null && _e !== void 0 ? _e : 'CSS',
-        pagesPaths: ((_g = (_f = options.ngDoc) === null || _f === void 0 ? void 0 : _f.pages) === null || _g === void 0 ? void 0 : _g.length) ? (0, core_1.asArray)((_h = options.ngDoc) === null || _h === void 0 ? void 0 : _h.pages) : [path.dirname(options.main)],
+        inlineStyleLanguage: (_f = targetOptions === null || targetOptions === void 0 ? void 0 : targetOptions['inlineStyleLanguage']) !== null && _f !== void 0 ? _f : 'CSS',
+        pagesPaths: ((_g = config.pages) === null || _g === void 0 ? void 0 : _g.length) ? (0, core_1.asArray)(config.pages) : [path.dirname(options.main)],
         assetsPath: path.join(buildPath, 'assets'),
         buildPath,
         apiPath: path.join(buildPath, 'api'),

package/helpers/create-builder-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-builder-context.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/create-builder-context.ts"],"names":[],"mappings":";;;;AAEA,uCAAqD;AACrD,mDAA6B;AAI7B;;;;;;GAMG;AACH,SAAgB,oBAAoB,CACnC,aAA8B,EAC9B,OAAoB,EACpB,OAAuB;;IAEvB,MAAM,SAAS,GAAW,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,MAAA,MAAA,OAAO,CAAC,MAAM,0CAAE,OAAO,mCAAI,KAAK,CAAC,CAAC;IAExG,OAAO;QACN,QAAQ,EAAE,MAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,QAAQ,mCAAI,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACtE,OAAO;QACP,OAAO;QACP,mBAAmB,EAAE,MAAC,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAG,qBAAqB,CAAoB,mCAAI,KAAK;QACxF,UAAU,EAAE,CAAA,MAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,KAAK,0CAAE,MAAM,EAAC,CAAC,CAAC,IAAA,cAAO,EAAC,MAAA,OAAO,CAAC,KAAK,0CAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvG,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC1C,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;QACpC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC1C,CAAC;AACH,CAAC;AAlBD,oDAkBC"}
+{"version":3,"file":"create-builder-context.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/create-builder-context.ts"],"names":[],"mappings":";;;;AAEA,uCAAqD;AACrD,mDAA6B;AAG7B,+CAAyC;AAEzC;;;;;;GAMG;AACH,SAAgB,oBAAoB,CACnC,aAA8B,EAC9B,OAAoB,EACpB,OAAuB;;IAEvB,MAAM,SAAS,GAAW,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,MAAA,MAAA,OAAO,CAAC,MAAM,0CAAE,OAAO,mCAAI,KAAK,CAAC,CAAC;IACxG,MAAM,WAAW,GAAW,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAW,CAAC,CAAC,CAAC;IAE5G,IAAI,MAAM,CAAC,IAAI,CAAC,MAAA,OAAO,CAAC,KAAK,mCAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAC5C,OAAO,CAAC,MAAM,CAAC,IAAI,CAClB,qGAAqG;YACpG,oJAAoJ,CACrJ,CAAC;KACF;IAED,MAAM,MAAM,GAAuB,EAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,IAAA,wBAAU,EAAC,WAAW,CAAC,EAAC,CAAC;IAElF,OAAO;QACN,QAAQ,EAAE,MAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,QAAQ,mCAAI,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM;QACN,OAAO;QACP,mBAAmB,EAAE,MAAC,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAG,qBAAqB,CAAoB,mCAAI,KAAK;QACxF,UAAU,EAAE,CAAA,MAAA,MAAM,CAAC,KAAK,0CAAE,MAAM,EAAC,CAAC,CAAC,IAAA,cAAO,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvF,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC1C,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;QACpC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC1C,CAAC;AACH,CAAC;AA5BD,oDA4BC"}

package/helpers/get-component-asset.js

@@ -9,6 +9,7 @@ const ts_morph_1 = require("ts-morph");
 const component_decorator_resolver_1 = require("../resolvers/component-decorator.resolver");
 const build_assets_1 = require("./build-assets");
 const format_code_1 = require("./format-code");
+const slash_1 = require("./slash");
 /**
  *
  * @param classDeclaration
@@ -49,7 +50,7 @@ function getComponentAsset(classDeclaration, inlineStyleLang, outDir) {
                         },
                     })
                         .trim(),
-                    outputPath: path.join(outDir, `${asset.name}.html`),
+                    outputPath: (0, slash_1.slash)(path.join(outDir, `${asset.name}.html`)),
                 };
             }),
         };

package/helpers/get-component-asset.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-component-asset.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/get-component-asset.ts"],"names":[],"mappings":";;;;AACA,6CAA8C;AAC9C,uCAAqD;AACrD,mDAA6B;AAC7B,uCAA2D;AAG3D,4FAAqF;AAErF,iDAA2C;AAC3C,+CAAyC;AAEzC;;;;;GAKG;AACH,SAAgB,iBAAiB,CAChC,gBAAkC,EAClC,eAA+B,EAC/B,MAAc;;IAEd,MAAM,SAAS,GAA0B,gBAAgB,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACpF,MAAM,iBAAiB,GAAqB,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE;QACtD,MAAM,aAAa,GAAc,IAAA,yDAA0B,EAAC,iBAAiB,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAW,gBAAgB,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC;QACxE,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE/C,MAAM,MAAM,GAA0C;YACrD,oCAAoC;YACpC,GAAG,IAAA,0BAAW,EAAC,QAAQ,EAAE,eAAe,CAAC;YACzC,gDAAgD;YAChD,GAAG,CAAC,aAAa,CAAC,WAAW;gBAC5B,CAAC,CAAC,IAAA,0BAAW,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;gBAC7E,CAAC,CAAC,EAAE,CAAC;YACN,+CAA+C;YAC/C,GAAG,IAAA,cAAO,EAAC,aAAa,CAAC,SAAS,CAAC;iBACjC,GAAG,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,IAAA,0BAAW,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;iBACrF,IAAI,EAAE;SACR,CAAC;QAEF,OAAO;YACN,CAAC,MAAA,gBAAgB,CAAC,OAAO,EAAE,mCAAI,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAqC,EAAE,EAAE;gBACxF,MAAM,IAAI,GAAW,IAAA,wBAAU,EAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE1D,OAAO;oBACN,GAAG,KAAK;oBACR,IAAI;oBACJ,MAAM,EAAE,IAAI,uBAAa,EAAE;yBACzB,UAAU,CAAC,kBAAkB,EAAE;wBAC/B,OAAO,EAAE;4BACR,IAAI;4BACJ,IAAI,EAAE,KAAK,CAAC,IAAI;yBAChB;qBACD,CAAC;yBACD,IAAI,EAAE;oBACR,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,OAAO,CAAC;iBACnD,CAAC;YACH,CAAC,CAAC;SACF,CAAC;KACF;IAED,OAAO,EAAE,CAAC;AACX,CAAC;AAhDD,8CAgDC"}
+{"version":3,"file":"get-component-asset.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/get-component-asset.ts"],"names":[],"mappings":";;;;AACA,6CAA8C;AAC9C,uCAAqD;AACrD,mDAA6B;AAC7B,uCAA2D;AAG3D,4FAAqF;AAErF,iDAA2C;AAC3C,+CAAyC;AACzC,mCAA8B;AAE9B;;;;;GAKG;AACH,SAAgB,iBAAiB,CAChC,gBAAkC,EAClC,eAA+B,EAC/B,MAAc;;IAEd,MAAM,SAAS,GAA0B,gBAAgB,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACpF,MAAM,iBAAiB,GAAqB,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE;QACtD,MAAM,aAAa,GAAc,IAAA,yDAA0B,EAAC,iBAAiB,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAW,gBAAgB,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,CAAC;QACxE,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE/C,MAAM,MAAM,GAA0C;YACrD,oCAAoC;YACpC,GAAG,IAAA,0BAAW,EAAC,QAAQ,EAAE,eAAe,CAAC;YACzC,gDAAgD;YAChD,GAAG,CAAC,aAAa,CAAC,WAAW;gBAC5B,CAAC,CAAC,IAAA,0BAAW,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;gBAC7E,CAAC,CAAC,EAAE,CAAC;YACN,+CAA+C;YAC/C,GAAG,IAAA,cAAO,EAAC,aAAa,CAAC,SAAS,CAAC;iBACjC,GAAG,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,IAAA,0BAAW,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;iBACrF,IAAI,EAAE;SACR,CAAC;QAEF,OAAO;YACN,CAAC,MAAA,gBAAgB,CAAC,OAAO,EAAE,mCAAI,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAqC,EAAE,EAAE;gBACxF,MAAM,IAAI,GAAW,IAAA,wBAAU,EAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE1D,OAAO;oBACN,GAAG,KAAK;oBACR,IAAI;oBACJ,MAAM,EAAE,IAAI,uBAAa,EAAE;yBACzB,UAAU,CAAC,kBAAkB,EAAE;wBAC/B,OAAO,EAAE;4BACR,IAAI;4BACJ,IAAI,EAAE,KAAK,CAAC,IAAI;yBAChB;qBACD,CAAC;yBACD,IAAI,EAAE;oBACR,UAAU,EAAE,IAAA,aAAK,EAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC;iBAC1D,CAAC;YACH,CAAC,CAAC;SACF,CAAC;KACF;IAED,OAAO,EAAE,CAAC;AACX,CAAC;AAhDD,8CAgDC"}

package/helpers/load-config.d.ts

@@ -0,0 +1,7 @@
+import { NgDocConfiguration } from '../interfaces';
+/**
+ * Loads configuration from global configuration file
+ *
+ * @param searchFrom
+ */
+export declare function loadConfig(searchFrom: string): NgDocConfiguration;

package/helpers/load-config.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = void 0;
+const cosmiconfig_1 = require("cosmiconfig");
+const cosmiconfig_typescript_loader_1 = require("cosmiconfig-typescript-loader");
+/**
+ * Loads configuration from global configuration file
+ *
+ * @param searchFrom
+ */
+function loadConfig(searchFrom) {
+    const moduleName = 'ng-doc';
+    const explorerSync = (0, cosmiconfig_1.cosmiconfigSync)(moduleName, {
+        searchPlaces: [`${moduleName}.config.ts`],
+        loaders: {
+            '.ts': (0, cosmiconfig_typescript_loader_1.TypeScriptLoader)(),
+        },
+    });
+    const searchedFor = explorerSync.search(searchFrom);
+    return searchedFor ? searchedFor.config : {};
+}
+exports.loadConfig = loadConfig;
+//# sourceMappingURL=load-config.js.map

package/helpers/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/load-config.ts"],"names":[],"mappings":";;;AAAA,6CAAgE;AAEhE,iFAA+D;AAI/D;;;;GAIG;AACH,SAAgB,UAAU,CAAC,UAAkB;IAC5C,MAAM,UAAU,GAAW,QAAQ,CAAC;IAEpC,MAAM,YAAY,GAAuB,IAAA,6BAAe,EAAC,UAAU,EAAE;QACpE,YAAY,EAAE,CAAC,GAAG,UAAU,YAAY,CAAC;QACzC,OAAO,EAAE;YACR,KAAK,EAAE,IAAA,gDAAgB,GAAE;SACzB;KACD,CAAC,CAAC;IACH,MAAM,WAAW,GAA6B,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE9E,OAAO,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC;AAZD,gCAYC"}

package/helpers/marked.js

@@ -27,7 +27,7 @@ function marked(markdown) {
         },
     };
     marked_1.marked.use({ renderer });
-    return marked_1.marked.parse(markdown);
+    return marked_1.marked.parse(markdown, { headerIds: false });
 }
 exports.marked = marked;
 //# sourceMappingURL=marked.js.map

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.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.viewFileInRepoUrl = exports.editFileInRepoUrl = void 0;
+const slash_1 = require("./slash");
 /**
  *
  * @param repoConfig
@@ -13,7 +14,7 @@ exports.viewFileInRepoUrl = exports.editFileInRepoUrl = void 0;
 function editFileInRepoUrl({ url, mainBranch }, filePath, scope, lineNumber) {
     if (url && mainBranch) {
         const rUrl = url.replace(/\/$/, '');
-        const fPath = filePath.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;
@@ -30,8 +31,8 @@ exports.editFileInRepoUrl = editFileInRepoUrl;
 function viewFileInRepoUrl({ url, releaseBranch }, filePath, lineNumber) {
     if (url && releaseBranch) {
         const rUrl = url.replace(/\/$/, '');
-        const fPath = filePath.replace(/^\//, '');
-        return `${url}/blob/${releaseBranch}/${fPath}${lineNumber ? `#L${lineNumber}` : ''}`;
+        const fPath = (0, slash_1.slash)(filePath).replace(/^\//, '');
+        return `${rUrl}/blob/${releaseBranch}/${fPath}${lineNumber ? `#L${lineNumber}` : ''}`;
     }
     return filePath;
 }

package/helpers/repo-link.js.map

@@ -1 +1 @@
-{"version":3,"file":"repo-link.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/repo-link.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;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,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAE1C,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,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAE1C,OAAO,GAAG,GAAG,SAAS,aAAa,IAAI,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;KACrF;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAbD,8CAaC"}
+{"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/interfaces/builder-context.d.ts

@@ -1,9 +1,9 @@
 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[];

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/interfaces/configuration.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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,6 +2,7 @@ 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';

package/interfaces/index.js

@@ -5,6 +5,7 @@ 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);

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,wDAA8B;AAC9B,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/schema.d.ts

@@ -1,39 +1,9 @@
-import { NgDocGlobalKeyword } from './keyword-map';
-import { NgDocRepoConfig } from './repo-config';
+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")
-     */
-    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".
+     * @deprecated Please use `ng-doc.config.js` file instead. Check our configuration guide for more details.
      */
-    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>;
-    /**
-     * 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 you application by default, but you can override it)
-     */
-    tsConfig?: string;
+    ngDoc?: NgDocConfiguration;
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@ng-doc/builder",
-  "version": "15.5.1",
+  "version": "15.7.0",
   "type": "commonjs",
   "builders": "./builders.json",
   "schematics": "./schematics/collection.json",
   "dependencies": {
-    "@ng-doc/core": "15.5.1",
+    "@ng-doc/core": "15.7.0",
     "@angular-devkit/architect": ">=0.1500.0",
     "chokidar": "^3.5.3",
     "minimatch": "^5.1.0",
@@ -21,11 +21,15 @@
     "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",
+    "github-slugger": "^1.5.0",
+    "hast-util-heading-rank": "^1.0.1",
     "highlight.js": "^11.5.1",
     "raw-loader": "^4.0.2",
     "esbuild": "^0.17.8",
-    "@microsoft/tsdoc": "^0.14.2"
+    "@microsoft/tsdoc": "^0.14.2",
+    "cosmiconfig": "^8.1.0",
+    "cosmiconfig-typescript-loader": "^4.3.0"
   },
   "publishConfig": {
     "access": "public"

package/engine/entities/abstractions/import.cjs

@@ -1,9 +0,0 @@
-/**
- *
- * @param path
- */
-function importModule(path) {
-	return import(path)
-}
-
-module.exports = {importModule};