@ng-doc/builder 17.6.16 → 18.0.0-beta.1

package/engine/builders/helpers/create-declaration-tab-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-declaration-tab-metadata.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/create-declaration-tab-metadata.ts"],"names":[],"mappings":";;AAkBA,oEAoBC;;AAtCD,wDAAwB;AAUxB;;;;;;;GAOG;AACH,SAAgB,4BAA4B,CAC1C,KAAsC,EACtC,GAAyB;IAEzB,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnD,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,MAAM;QACN,KAAK,EAAE;YACL,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;YACpC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB;QACD,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;QACrC,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;AACJ,CAAC"}

package/engine/builders/helpers/create-entry-metadata.d.ts

@@ -0,0 +1,10 @@
+import { SourceFile } from 'ts-morph';
+import { NgDocBuilderContext } from '../../../interfaces';
+import { EntryMetadata, FileEntry } from '../interfaces';
+/**
+ *
+ * @param context
+ * @param entry
+ * @param sourceFile
+ */
+export declare function createEntryMetadata<T extends FileEntry>(context: NgDocBuilderContext, entry: T, sourceFile: SourceFile): EntryMetadata<T>;

package/engine/builders/helpers/create-entry-metadata.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEntryMetadata = createEntryMetadata;
+const tslib_1 = require("tslib");
+const core_1 = require("@ng-doc/core");
+const minimatch_1 = require("minimatch");
+const path_1 = tslib_1.__importDefault(require("path"));
+const rxjs_1 = require("rxjs");
+const helpers_1 = require("../../../helpers");
+const variables_1 = require("../../variables");
+const get_category_source_file_1 = require("./get-category-source-file");
+const get_entry_out_dir_1 = require("./get-entry-out-dir");
+const get_entry_route_1 = require("./get-entry-route");
+const get_variable_statement_from_object_literal_expression_1 = require("./get-variable-statement-from-object-literal-expression");
+/**
+ *
+ * @param context
+ * @param entry
+ * @param sourceFile
+ */
+function createEntryMetadata(context, entry, sourceFile) {
+    const entryPath = sourceFile.getFilePath();
+    const dir = sourceFile.getDirectoryPath();
+    const dirName = path_1.default.basename(dir);
+    const route = (0, get_entry_route_1.getEntryRoute)(entry, entryPath);
+    const categorySourceFile = entry.category && (0, get_category_source_file_1.getCategorySourceFile)(sourceFile);
+    const outDir = (0, get_entry_out_dir_1.getEntryOutDir)(context, entry, entryPath);
+    const isCategory = (0, minimatch_1.minimatch)(entryPath, variables_1.CATEGORY_PATTERN);
+    return {
+        dir,
+        dirName,
+        route,
+        outDir,
+        outPath: path_1.default.join(outDir, 'page.ts'),
+        sourceFile,
+        objectExpression: () => {
+            const objectExpression = (0, helpers_1.getObjectExpressionFromDefault)(sourceFile);
+            if (!objectExpression) {
+                throw new Error(`No object expression found in ${entryPath}, make sure the file has a default export.`);
+            }
+            return objectExpression;
+        },
+        path: entryPath,
+        title: entry.title,
+        keywordTitle: entry.title,
+        order: entry.order,
+        nestedRoutes: !isCategory,
+        jsDocMetadata: function () {
+            const statement = (0, get_variable_statement_from_object_literal_expression_1.getVariableStatementFromObjectLiteralExpression)(this.objectExpression());
+            const description = (0, helpers_1.getJsDocDescription)(statement);
+            const tags = (0, helpers_1.getAllJsDocTags)(statement);
+            return {
+                description,
+                tags,
+            };
+        },
+        absoluteRoute: function () {
+            return (0, helpers_1.posix)(path_1.default.join(...(0, core_1.asArray)(this.parent?.absoluteRoute() ?? context.config.routePrefix, this.route)));
+        },
+        breadcrumbs: function () {
+            return (0, core_1.asArray)(this.parent?.breadcrumbs(), this.entry.title);
+        },
+        refresh: async function () { },
+        selfDestroy: rxjs_1.NEVER,
+        // @ts-expect-error - This is a valid assignment
+        parent: entry.category && categorySourceFile
+            ? createEntryMetadata(context, entry.category, categorySourceFile)
+            : undefined,
+        entry,
+    };
+}
+//# sourceMappingURL=create-entry-metadata.js.map

package/engine/builders/helpers/create-entry-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-entry-metadata.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/create-entry-metadata.ts"],"names":[],"mappings":";;AA0BA,kDAiEC;;AA3FD,uCAAsD;AACtD,yCAAsC;AACtC,wDAAwB;AACxB,+BAA6B;AAG7B,8CAK0B;AAE1B,+CAAmD;AAEnD,yEAAmE;AACnE,2DAAqD;AACrD,uDAAkD;AAClD,mIAA0H;AAE1H;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,OAA4B,EAC5B,KAAQ,EACR,UAAsB;IAEtB,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,UAAU,CAAC,gBAAgB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,cAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAA,+BAAa,EAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,kBAAkB,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAA,gDAAqB,EAAC,UAAU,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,IAAA,kCAAc,EAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAA,qBAAS,EAAC,SAAS,EAAE,4BAAgB,CAAC,CAAC;IAE1D,OAAO;QACL,GAAG;QACH,OAAO;QACP,KAAK;QACL,MAAM;QACN,OAAO,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;QACrC,UAAU;QACV,gBAAgB,EAAE,GAAG,EAAE;YACrB,MAAM,gBAAgB,GAAG,IAAA,wCAA8B,EAAC,UAAU,CAAC,CAAC;YAEpE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,iCAAiC,SAAS,4CAA4C,CACvF,CAAC;YACJ,CAAC;YAED,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QACD,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,KAAK;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,CAAC,UAAU;QACzB,aAAa,EAAE;YACb,MAAM,SAAS,GAAG,IAAA,uGAA+C,EAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC3F,MAAM,WAAW,GAAG,IAAA,6BAAmB,EAAC,SAAS,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,IAAA,yBAAe,EAAC,SAAS,CAAC,CAAC;YAExC,OAAO;gBACL,WAAW;gBACX,IAAI;aACL,CAAC;QACJ,CAAC;QACD,aAAa,EAAE;YACb,OAAO,IAAA,eAAK,EACV,cAAI,CAAC,IAAI,CACP,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CACnF,CACF,CAAC;QACJ,CAAC;QACD,WAAW,EAAE;YACX,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,KAAK,eAA6B,CAAC;QAC5C,WAAW,EAAE,YAAK;QAClB,gDAAgD;QAChD,MAAM,EACJ,KAAK,CAAC,QAAQ,IAAI,kBAAkB;YAClC,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,kBAAkB,CAAC;YAClE,CAAC,CAAC,SAAS;QACf,KAAK;KACN,CAAC;AACJ,CAAC"}

package/engine/builders/helpers/create-import-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates a relative import path from the current directory to the destination path.
+ * @param {string} currentDir - The current directory path.
+ * @param {string} destinationPath - The destination path.
+ * @returns {string} The relative import path from the current directory to the destination path.
+ */
+export declare function createImportPath(currentDir: string, destinationPath: string): string;

package/engine/builders/helpers/create-import-path.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createImportPath = createImportPath;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const helpers_1 = require("../../../helpers");
+/**
+ * Creates a relative import path from the current directory to the destination path.
+ * @param {string} currentDir - The current directory path.
+ * @param {string} destinationPath - The destination path.
+ * @returns {string} The relative import path from the current directory to the destination path.
+ */
+function createImportPath(currentDir, destinationPath) {
+    // Use the posix function from the helpers module to ensure the path is in POSIX format.
+    // Then, use the relative method from the path module to get the relative path from the current directory to the destination path.
+    // Finally, remove the .ts extension from the path.
+    return (0, helpers_1.posix)(path_1.default.relative(currentDir, destinationPath)).replace(/\.ts$/, '');
+}
+//# sourceMappingURL=create-import-path.js.map

package/engine/builders/helpers/create-import-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-import-path.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/create-import-path.ts"],"names":[],"mappings":";;AAUA,4CAKC;;AAfD,wDAAwB;AAExB,8CAAyC;AAEzC;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,UAAkB,EAAE,eAAuB;IAC1E,wFAAwF;IACxF,kIAAkI;IAClI,mDAAmD;IACnD,OAAO,IAAA,eAAK,EAAC,cAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/engine/builders/helpers/create-markdown-metadata.d.ts

@@ -0,0 +1,8 @@
+import { NgDocPage } from '@ng-doc/core';
+import { EntryMetadata, MarkdownEntry } from '../interfaces';
+/**
+ *
+ * @param parent
+ * @param mdFile
+ */
+export declare function createMarkdownMetadata(parent: EntryMetadata<NgDocPage>, mdFile: string): EntryMetadata<MarkdownEntry>;

package/engine/builders/helpers/create-markdown-metadata.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMarkdownMetadata = createMarkdownMetadata;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const markdown_front_matter_1 = require("./markdown-front-matter");
+/**
+ *
+ * @param parent
+ * @param mdFile
+ */
+function createMarkdownMetadata(parent, mdFile) {
+    const mdPath = path_1.default.join(parent.dir, mdFile);
+    const dir = path_1.default.dirname(mdPath);
+    const dirName = path_1.default.basename(dir);
+    const { data } = (0, markdown_front_matter_1.markdownFrontMatter)(mdPath);
+    const outDir = path_1.default.join(parent.outDir, data.route ?? 'index');
+    return {
+        ...parent,
+        entry: data,
+        path: mdPath,
+        dir,
+        dirName,
+        parent,
+        title: data.title ?? parent.title,
+        keywordTitle: data.route ? parent.title + (data.title ? ` - ${data.title}` : '') : parent.title,
+        route: data.route ?? '',
+        outDir,
+        outPath: path_1.default.join(outDir, 'page.ts'),
+    };
+}
+//# sourceMappingURL=create-markdown-metadata.js.map

package/engine/builders/helpers/create-markdown-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-markdown-metadata.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/create-markdown-metadata.ts"],"names":[],"mappings":";;AAWA,wDAuBC;;AAjCD,wDAAwB;AAGxB,mEAA8D;AAE9D;;;;GAIG;AACH,SAAgB,sBAAsB,CACpC,MAAgC,EAChC,MAAc;IAEd,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,cAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,2CAAmB,EAAgB,MAAM,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC;IAE/D,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,MAAM;QACZ,GAAG;QACH,OAAO;QACP,MAAM;QACN,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;QACjC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK;QAC/F,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,MAAM;QACN,OAAO,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/engine/builders/helpers/get-category-source-file.d.ts

@@ -0,0 +1,7 @@
+import { SourceFile } from 'ts-morph';
+/**
+ * Retrieves the source file for a given category.
+ * @param {SourceFile} sourceFile - The source file to retrieve the category from.
+ * @returns {SourceFile | undefined} The source file for the category, or undefined if it could not be found.
+ */
+export declare function getCategorySourceFile(sourceFile: SourceFile): SourceFile | undefined;

package/engine/builders/helpers/get-category-source-file.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCategorySourceFile = getCategorySourceFile;
+const ts_morph_1 = require("ts-morph");
+const helpers_1 = require("../../../helpers");
+/**
+ * Retrieves the source file for a given category.
+ * @param {SourceFile} sourceFile - The source file to retrieve the category from.
+ * @returns {SourceFile | undefined} The source file for the category, or undefined if it could not be found.
+ */
+function getCategorySourceFile(sourceFile) {
+    const objectExpression = (0, helpers_1.getObjectExpressionFromDefault)(sourceFile);
+    if (objectExpression) {
+        const categoryProperty = objectExpression.getProperty('category');
+        if (ts_morph_1.Node.isPropertyAssignment(categoryProperty)) {
+            const initializer = categoryProperty.getInitializer();
+            if (initializer) {
+                const categorySourceFile = initializer
+                    .getSymbol()
+                    ?.getAliasedSymbol()
+                    ?.getValueDeclaration()
+                    ?.getSourceFile();
+                if (categorySourceFile) {
+                    return categorySourceFile;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=get-category-source-file.js.map

package/engine/builders/helpers/get-category-source-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-category-source-file.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-category-source-file.ts"],"names":[],"mappings":";;AASA,sDAwBC;AAjCD,uCAA4C;AAE5C,8CAAkE;AAElE;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,UAAsB;IAC1D,MAAM,gBAAgB,GAAG,IAAA,wCAA8B,EAAC,UAAU,CAAC,CAAC;IAEpE,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAElE,IAAI,eAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAChD,MAAM,WAAW,GAAG,gBAAgB,CAAC,cAAc,EAAE,CAAC;YAEtD,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,kBAAkB,GAAG,WAAW;qBACnC,SAAS,EAAE;oBACZ,EAAE,gBAAgB,EAAE;oBACpB,EAAE,mBAAmB,EAAE;oBACvB,EAAE,aAAa,EAAE,CAAC;gBAEpB,IAAI,kBAAkB,EAAE,CAAC;oBACvB,OAAO,kBAAkB,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/engine/builders/helpers/get-entry-out-dir.d.ts

@@ -0,0 +1,9 @@
+import { NgDocBuilderContext } from '../../../interfaces';
+import { Entry } from '../interfaces';
+/**
+ *
+ * @param context
+ * @param entry
+ * @param filePath
+ */
+export declare function getEntryOutDir(context: NgDocBuilderContext, entry: Entry, filePath: string): string;

package/engine/builders/helpers/get-entry-out-dir.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntryOutDir = getEntryOutDir;
+const tslib_1 = require("tslib");
+const core_1 = require("@ng-doc/core");
+const path_1 = tslib_1.__importDefault(require("path"));
+const interfaces_1 = require("../interfaces");
+/**
+ *
+ * @param context
+ * @param entry
+ * @param filePath
+ */
+function getEntryOutDir(context, entry, filePath) {
+    const dir = path_1.default.dirname(filePath);
+    if ((0, interfaces_1.isPageEntry)(entry, filePath)) {
+        const relativePath = path_1.default.relative(context.docsPath, dir);
+        return path_1.default.join(context.outGuidesDir, relativePath);
+    }
+    if ((0, interfaces_1.isApiEntry)(entry, filePath)) {
+        return path_1.default.join(...(0, core_1.asArray)(context.outApiDir, entry.route));
+    }
+    return context.outDir;
+}
+//# sourceMappingURL=get-entry-out-dir.js.map

package/engine/builders/helpers/get-entry-out-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entry-out-dir.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-entry-out-dir.ts"],"names":[],"mappings":";;AAYA,wCAkBC;;AA9BD,uCAAuC;AACvC,wDAAwB;AAGxB,8CAA+D;AAE/D;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,OAA4B,EAC5B,KAAY,EACZ,QAAgB;IAEhB,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,IAAA,wBAAW,EAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE1D,OAAO,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,IAAA,uBAAU,EAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO,cAAI,CAAC,IAAI,CAAC,GAAG,IAAA,cAAO,EAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}

package/engine/builders/helpers/get-entry-relative-path.d.ts

@@ -0,0 +1,6 @@
+/**
+ *
+ * @param pagePaths
+ * @param entryPath
+ */
+export declare function getEntryRelativePath(pagePaths: string[], entryPath: string): string;

package/engine/builders/helpers/get-entry-relative-path.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntryRelativePath = getEntryRelativePath;
+/**
+ *
+ * @param pagePaths
+ * @param entryPath
+ */
+function getEntryRelativePath(pagePaths, entryPath) {
+    const pagePath = pagePaths.find((pagePath) => pagePath === entryPath);
+    if (!pagePath) {
+        throw new Error(`Entry path "${entryPath}" is not found in page paths`);
+    }
+    return pagePath;
+}
+//# sourceMappingURL=get-entry-relative-path.js.map

package/engine/builders/helpers/get-entry-relative-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entry-relative-path.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-entry-relative-path.ts"],"names":[],"mappings":";;AAKA,oDAQC;AAbD;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,SAAmB,EAAE,SAAiB;IACzE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAEtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,eAAe,SAAS,8BAA8B,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/engine/builders/helpers/get-entry-route.d.ts

@@ -0,0 +1,7 @@
+import { Entry } from '../interfaces';
+/**
+ *
+ * @param entry
+ * @param filePath
+ */
+export declare function getEntryRoute(entry: Entry, filePath: string): string;

package/engine/builders/helpers/get-entry-route.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntryRoute = getEntryRoute;
+const tslib_1 = require("tslib");
+const core_1 = require("@ng-doc/core");
+const path_1 = tslib_1.__importDefault(require("path"));
+const interfaces_1 = require("../interfaces");
+/**
+ *
+ * @param entry
+ * @param filePath
+ */
+function getEntryRoute(entry, filePath) {
+    const dirName = path_1.default.basename(path_1.default.dirname(filePath));
+    if ((0, interfaces_1.isPageEntry)(entry, filePath)) {
+        return ((0, core_1.isRoute)(entry?.route) ? entry?.route.path : entry?.route) ?? dirName;
+    }
+    if ((0, interfaces_1.isApiEntry)(entry, filePath)) {
+        return entry.route ?? 'api';
+    }
+    return dirName;
+}
+//# sourceMappingURL=get-entry-route.js.map

package/engine/builders/helpers/get-entry-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entry-route.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-entry-route.ts"],"names":[],"mappings":";;AAUA,sCAYC;;AAtBD,uCAAuC;AACvC,wDAAwB;AAExB,8CAA+D;AAE/D;;;;GAIG;AACH,SAAgB,aAAa,CAAC,KAAY,EAAE,QAAgB;IAC1D,MAAM,OAAO,GAAG,cAAI,CAAC,QAAQ,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,IAAI,IAAA,wBAAW,EAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,IAAA,cAAO,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC;IAC/E,CAAC;IAED,IAAI,IAAA,uBAAU,EAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;IAC9B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/engine/builders/helpers/get-playground-metadata.d.ts

@@ -0,0 +1,9 @@
+import { NgDocPage } from '@ng-doc/core';
+import { ObjectLiteralExpression } from 'ts-morph';
+import { NgDocPlaygroundMetadata } from '../../../interfaces';
+/**
+ *
+ * @param page
+ * @param objectExpression
+ */
+export declare function getPlaygroundMetadata(page: NgDocPage, objectExpression: ObjectLiteralExpression): Record<string, NgDocPlaygroundMetadata>;

package/engine/builders/helpers/get-playground-metadata.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlaygroundMetadata = getPlaygroundMetadata;
+const helpers_1 = require("../../../helpers");
+/**
+ *
+ * @param page
+ * @param objectExpression
+ */
+function getPlaygroundMetadata(page, objectExpression) {
+    const expression = (0, helpers_1.getPlaygroundsExpression)(objectExpression);
+    if (expression) {
+        return (0, helpers_1.getPlaygroundsIds)(expression).reduce((metadata, id) => {
+            if (expression) {
+                const playground = (0, helpers_1.getPlaygroundById)(expression, id);
+                if (playground) {
+                    metadata[id] = (0, helpers_1.buildPlaygroundMetadata)(id, playground, controlsToProperties(page.playgrounds?.[id]?.controls ?? {}));
+                }
+            }
+            return metadata;
+        }, {});
+    }
+    return {};
+}
+/**
+ *
+ * @param controls
+ */
+function controlsToProperties(controls) {
+    return Object.entries(controls).reduce((properties, [name, value]) => {
+        properties[name] = {
+            inputName: typeof value === 'string' ? name : value.alias ?? name,
+            type: typeof value === 'string' ? value : value.type,
+            description: typeof value === 'string' ? undefined : value.description ?? undefined,
+            options: typeof value === 'string' ? undefined : value.options ?? undefined,
+        };
+        return properties;
+    }, {});
+}
+//# sourceMappingURL=get-playground-metadata.js.map

package/engine/builders/helpers/get-playground-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-playground-metadata.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-playground-metadata.ts"],"names":[],"mappings":";;AAgBA,sDA2BC;AAxCD,8CAK0B;AAG1B;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,IAAe,EACf,gBAAyC;IAEzC,MAAM,UAAU,GAAG,IAAA,kCAAwB,EAAC,gBAAgB,CAAC,CAAC;IAE9D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,IAAA,2BAAiB,EAAC,UAAU,CAAC,CAAC,MAAM,CACzC,CAAC,QAAiD,EAAE,EAAU,EAAE,EAAE;YAChE,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,UAAU,GAAwC,IAAA,2BAAiB,EAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAE1F,IAAI,UAAU,EAAE,CAAC;oBACf,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAA,iCAAuB,EACpC,EAAE,EACF,UAAU,EACV,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC,CAC7D,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC,EACD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,QAA+D;IAE/D,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CACpC,CACE,UAAqC,EACrC,CAAC,IAAI,EAAE,KAAK,CAAkD,EAC9D,EAAE;QACF,UAAU,CAAC,IAAI,CAAC,GAAG;YACjB,SAAS,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI;YACjE,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;YACpD,WAAW,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,SAAS;YACnF,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS;SAC5E,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC"}

package/engine/builders/helpers/get-scoped-keyword.d.ts

@@ -0,0 +1,8 @@
+import { NgDocKeyword, NgDocPageAnchor } from '@ng-doc/core';
+import { EntryMetadata } from '../interfaces';
+/**
+ *
+ * @param metadata
+ * @param anchor
+ */
+export declare function getScopedKeyword(metadata: EntryMetadata, anchor: Required<NgDocPageAnchor>): [string, NgDocKeyword];

package/engine/builders/helpers/get-scoped-keyword.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getScopedKeyword = getScopedKeyword;
+const helpers_1 = require("../../../helpers");
+/**
+ *
+ * @param metadata
+ * @param anchor
+ */
+function getScopedKeyword(metadata, anchor) {
+    const pageKeyword = (0, helpers_1.constructPageKeyword)(anchor.scope.key, anchor.scope.title, metadata.absoluteRoute(), anchor);
+    const anchorKeyword = {
+        title: pageKeyword.title,
+        path: pageKeyword.path,
+        type: anchor.type === 'heading' ? 'link' : undefined,
+    };
+    return [(0, helpers_1.formatKeywordKey)(pageKeyword.key), anchorKeyword];
+}
+//# sourceMappingURL=get-scoped-keyword.js.map

package/engine/builders/helpers/get-scoped-keyword.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-scoped-keyword.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-scoped-keyword.ts"],"names":[],"mappings":";;AAUA,4CAkBC;AA1BD,8CAA0E;AAG1E;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,QAAuB,EACvB,MAAiC;IAEjC,MAAM,WAAW,GAAG,IAAA,8BAAoB,EACtC,MAAM,CAAC,KAAK,CAAC,GAAG,EAChB,MAAM,CAAC,KAAK,CAAC,KAAK,EAClB,QAAQ,CAAC,aAAa,EAAE,EACxB,MAAM,CACP,CAAC;IAEF,MAAM,aAAa,GAAiB;QAClC,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC;IAEF,OAAO,CAAC,IAAA,0BAAgB,EAAC,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC"}

package/engine/builders/helpers/get-structured-docs.d.ts

@@ -0,0 +1,11 @@
+import { EntryMetadata } from '../interfaces';
+export interface StructuredDoc {
+    item: EntryMetadata;
+    children?: StructuredDoc[];
+}
+/**
+ *
+ * @param pages
+ * @param items
+ */
+export declare function getStructuredDocs(items: EntryMetadata[]): StructuredDoc[];

package/engine/builders/helpers/get-structured-docs.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStructuredDocs = getStructuredDocs;
+/**
+ *
+ * @param pages
+ * @param items
+ */
+function getStructuredDocs(items) {
+    const structuredMap = new Map();
+    items.forEach((item) => {
+        addLevel(structuredMap, createLevels(item));
+    });
+    return getStructuredDocsFromMap(structuredMap);
+}
+/**
+ *
+ * @param structuredMap
+ */
+function getStructuredDocsFromMap(structuredMap) {
+    const structuredDocs = [];
+    structuredMap.forEach(([map, item]) => {
+        const children = getStructuredDocsFromMap(map);
+        structuredDocs.push({ item, children });
+    });
+    return structuredDocs;
+}
+/**
+ *
+ * @param structuredMap
+ * @param levels
+ */
+function addLevel(structuredMap, levels) {
+    const [level, ...rest] = levels;
+    if (level) {
+        const route = level.route;
+        const [map, item] = structuredMap.get(route) || [new Map(), level];
+        structuredMap.set(route, [map, item]);
+        addLevel(map, rest);
+    }
+}
+/**
+ *
+ * @param item
+ */
+function createLevels(item) {
+    const levels = [];
+    let level = item;
+    while (level) {
+        levels.unshift(level);
+        level = level.parent;
+    }
+    return levels;
+}
+//# sourceMappingURL=get-structured-docs.js.map

package/engine/builders/helpers/get-structured-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-structured-docs.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-structured-docs.ts"],"names":[],"mappings":";;AAaA,8CAQC;AAbD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,KAAsB;IACtD,MAAM,aAAa,GAAkB,IAAI,GAAG,EAAE,CAAC;IAE/C,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,wBAAwB,CAAC,aAAa,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAC,aAA4B;IAC5D,MAAM,cAAc,GAAoB,EAAE,CAAC;IAE3C,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;QACpC,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAE/C,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,aAA4B,EAAE,MAAuB;IACrE,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;IAEhC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QAEnE,aAAa,CAAC,GAAG,CAAC,KAAM,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAEvC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAmB;IACvC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,IAAI,KAAK,GAA8B,IAAI,CAAC;IAE5C,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/engine/builders/helpers/get-variable-statement-from-object-literal-expression.d.ts

@@ -0,0 +1,6 @@
+import { ObjectLiteralExpression, VariableStatement } from 'ts-morph';
+/**
+ *
+ * @param objectLiteral
+ */
+export declare function getVariableStatementFromObjectLiteralExpression(objectLiteral: ObjectLiteralExpression): VariableStatement;

package/engine/builders/helpers/get-variable-statement-from-object-literal-expression.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVariableStatementFromObjectLiteralExpression = getVariableStatementFromObjectLiteralExpression;
+const ts_morph_1 = require("ts-morph");
+/**
+ *
+ * @param objectLiteral
+ */
+function getVariableStatementFromObjectLiteralExpression(objectLiteral) {
+    const parent = objectLiteral.getParent();
+    if (ts_morph_1.Node.isVariableDeclaration(parent)) {
+        const statement = parent.getVariableStatement();
+        if (statement) {
+            return statement;
+        }
+    }
+    throw new Error(`Expected the object literal expression to be a child of a variable declaration, but it was not.`);
+}
+//# sourceMappingURL=get-variable-statement-from-object-literal-expression.js.map

package/engine/builders/helpers/get-variable-statement-from-object-literal-expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-variable-statement-from-object-literal-expression.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-variable-statement-from-object-literal-expression.ts"],"names":[],"mappings":";;AAMA,0GAgBC;AAtBD,uCAA4E;AAE5E;;;GAGG;AACH,SAAgB,+CAA+C,CAC7D,aAAsC;IAEtC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;IAEzC,IAAI,eAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAEhD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;AACJ,CAAC"}

package/engine/builders/helpers/index.d.ts

@@ -0,0 +1,14 @@
+export * from './create-declaration-metadata';
+export * from './create-declaration-tab-metadata';
+export * from './create-entry-metadata';
+export * from './create-import-path';
+export * from './create-markdown-metadata';
+export * from './get-category-source-file';
+export * from './get-entry-out-dir';
+export * from './get-entry-relative-path';
+export * from './get-entry-route';
+export * from './get-playground-metadata';
+export * from './get-scoped-keyword';
+export * from './get-structured-docs';
+export * from './get-variable-statement-from-object-literal-expression';
+export * from './markdown-front-matter';

package/engine/builders/helpers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./create-declaration-metadata"), exports);
+tslib_1.__exportStar(require("./create-declaration-tab-metadata"), exports);
+tslib_1.__exportStar(require("./create-entry-metadata"), exports);
+tslib_1.__exportStar(require("./create-import-path"), exports);
+tslib_1.__exportStar(require("./create-markdown-metadata"), exports);
+tslib_1.__exportStar(require("./get-category-source-file"), exports);
+tslib_1.__exportStar(require("./get-entry-out-dir"), exports);
+tslib_1.__exportStar(require("./get-entry-relative-path"), exports);
+tslib_1.__exportStar(require("./get-entry-route"), exports);
+tslib_1.__exportStar(require("./get-playground-metadata"), exports);
+tslib_1.__exportStar(require("./get-scoped-keyword"), exports);
+tslib_1.__exportStar(require("./get-structured-docs"), exports);
+tslib_1.__exportStar(require("./get-variable-statement-from-object-literal-expression"), exports);
+tslib_1.__exportStar(require("./markdown-front-matter"), exports);
+//# sourceMappingURL=index.js.map

package/engine/builders/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/index.ts"],"names":[],"mappings":";;;AAAA,wEAA8C;AAC9C,4EAAkD;AAClD,kEAAwC;AACxC,+DAAqC;AACrC,qEAA2C;AAC3C,qEAA2C;AAC3C,8DAAoC;AACpC,oEAA0C;AAC1C,4DAAkC;AAClC,oEAA0C;AAC1C,+DAAqC;AACrC,gEAAsC;AACtC,kGAAwE;AACxE,kEAAwC"}

package/engine/builders/helpers/markdown-front-matter.d.ts

@@ -0,0 +1,8 @@
+/**
+ *
+ * @param mdPath
+ */
+export declare function markdownFrontMatter<T extends object>(mdPath: string): {
+    data: T;
+    content: string;
+};

package/engine/builders/helpers/markdown-front-matter.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markdownFrontMatter = markdownFrontMatter;
+const tslib_1 = require("tslib");
+const gray_matter_1 = tslib_1.__importDefault(require("gray-matter"));
+/**
+ *
+ * @param mdPath
+ */
+function markdownFrontMatter(mdPath) {
+    const { data, content } = gray_matter_1.default.read(mdPath);
+    return { data, content };
+}
+//# sourceMappingURL=markdown-front-matter.js.map

package/engine/builders/helpers/markdown-front-matter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-front-matter.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/markdown-front-matter.ts"],"names":[],"mappings":";;AAMA,kDAMC;;AAZD,sEAAiC;AAEjC;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,MAAc;IAEd,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,qBAAM,CAAC,IAAI,CAAC,MAAM,CAA4C,CAAC;IAEzF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/engine/builders/index.d.ts

@@ -0,0 +1,4 @@
+export * from './helpers';
+export * from './interfaces';
+export * from './page';
+export * from './shared';

package/engine/builders/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./helpers"), exports);
+tslib_1.__exportStar(require("./interfaces"), exports);
+tslib_1.__exportStar(require("./page"), exports);
+tslib_1.__exportStar(require("./shared"), exports);
+//# sourceMappingURL=index.js.map

package/engine/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/builders/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,uDAA6B;AAC7B,iDAAuB;AACvB,mDAAyB"}