@breadstone-infrastructure/nx-tasks 0.0.231 → 0.0.233

package/executors/generate-package-docs/executor.js

@@ -0,0 +1,72 @@
+"use strict";
+// #region Imports
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const getProjectRoot_1 = require("../../utils/getProjectRoot");
+const isVerbose_1 = require("../../utils/isVerbose");
+// #endregion
+async function runExecutor(options, context) {
+    try {
+        const projectName = context.projectName;
+        if (!projectName) {
+            throw new Error('No project name available in executor context.');
+        }
+        // Auto-discover additional entry points from the build target when not explicitly provided
+        let additionalEntryPoints = options.additionalEntryPoints;
+        if (!additionalEntryPoints) {
+            const projectNode = context.projectGraph?.nodes[projectName];
+            const buildTarget = projectNode?.data.targets?.['build'];
+            if (Array.isArray(buildTarget?.options?.additionalEntryPoints)) {
+                additionalEntryPoints = buildTarget.options.additionalEntryPoints;
+            }
+        }
+        const task = (await Promise.resolve().then(() => __importStar(require('./executor.task')))).GeneratePackageDocsTask;
+        await task.run({
+            ...options,
+            cwd: (0, getProjectRoot_1.getProjectRoot)(context),
+            workspaceRoot: context.root,
+            projectName,
+            additionalEntryPoints,
+            verbose: (0, isVerbose_1.isVerbose)(context, options),
+        });
+        return { success: true };
+    }
+    catch (error) {
+        console.error(error);
+        return { success: false };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/executors/generate-package-docs/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/executors/generate-package-docs/executor.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASlB,8BAqCC;AA3CD,+DAA4D;AAC5D,qDAAkD;AAGlD,aAAa;AAEE,KAAK,UAAU,WAAW,CACrC,OAA2C,EAC3C,OAAwB;IAExB,IAAI,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAExC,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACtE,CAAC;QAED,2FAA2F;QAC3F,IAAI,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;QAC1D,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YAC7D,MAAM,WAAW,GAAG,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,qBAAqB,CAAC,EAAE,CAAC;gBAC7D,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC,qBAAiC,CAAC;YAClF,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,wDAAa,iBAAiB,GAAC,CAAC,CAAC,uBAAuB,CAAC;QACvE,MAAM,IAAI,CAAC,GAAG,CAAC;YACX,GAAG,OAAO;YACV,GAAG,EAAE,IAAA,+BAAc,EAAC,OAAO,CAAC;YAC5B,aAAa,EAAE,OAAO,CAAC,IAAI;YAC3B,WAAW;YACX,qBAAqB;YACrB,OAAO,EAAE,IAAA,qBAAS,EAAC,OAAO,EAAE,OAAO,CAAC;SACvC,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAErB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACL,CAAC"}

package/executors/generate-package-docs/executor.options.d.ts

@@ -0,0 +1,6 @@
+import type { GeneratePackageDocsTask } from './executor.task';
+/**
+ * @public
+ */
+export type GeneratePackageDocsExecutorOptions = Omit<GeneratePackageDocsTask.IGeneratePackageDocsTaskOptions, 'cwd' | 'workspaceRoot' | 'projectName'>;
+//# sourceMappingURL=executor.options.d.ts.map

package/executors/generate-package-docs/executor.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.options.d.ts","sourceRoot":"","sources":["../../../src/executors/generate-package-docs/executor.options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAI/D;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,IAAI,CAAC,uBAAuB,CAAC,+BAA+B,EAAE,KAAK,GAAG,eAAe,GAAG,aAAa,CAAC,CAAC"}

package/executors/generate-package-docs/executor.options.js

@@ -0,0 +1,4 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=executor.options.js.map

package/executors/generate-package-docs/executor.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.options.js","sourceRoot":"","sources":["../../../src/executors/generate-package-docs/executor.options.ts"],"names":[],"mappings":";AAAA,kBAAkB"}

package/executors/generate-package-docs/executor.task.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @description Task to generate API documentation for a library package using TypeDoc.
+ * @public
+ */
+export declare namespace GeneratePackageDocsTask {
+    /**
+     * Post-processing options for generated Markdown files.
+     *
+     * @public
+     */
+    interface IPostProcessingOptions {
+        /** Remove the auto-generated README.md from output. */
+        removeReadme?: boolean;
+        /** Rename globals.md to index.md for static site generators. */
+        renameGlobalsToIndex?: boolean;
+        /** Rewrite `.md` extension links for clean URL compatibility. */
+        rewriteLinks?: boolean;
+        /** Escape angle brackets in type generics for Vue/VitePress. */
+        escapeAngleBrackets?: boolean;
+        /** Add or normalize YAML frontmatter with a title. */
+        normalizeFrontmatter?: boolean;
+        /** Mark generated files with `generated: true` in frontmatter. */
+        markAsGenerated?: boolean;
+        /** Strip TypeDoc-generated package back-links at the top of pages. */
+        stripPackageBackLink?: boolean;
+        /** Resolve unresolved `{@link}` TSDoc references to plain text. */
+        resolveInlineLinks?: boolean;
+    }
+    /**
+     * Options for the generate-package-docs task.
+     *
+     * @public
+     */
+    interface IGeneratePackageDocsTaskOptions {
+        /** Absolute path to the project root. */
+        cwd: string;
+        /** Absolute path to the workspace root. */
+        workspaceRoot: string;
+        /** Nx project name. */
+        projectName: string;
+        /** Entry point file relative to `cwd`. */
+        entryPoint?: string;
+        /** Additional entry point paths (absolute or relative to workspace root). */
+        additionalEntryPoints?: string[];
+        /** TypeScript config file relative to `cwd`. */
+        tsConfig?: string;
+        /** Output directory (absolute or relative to workspace root). */
+        outputDir?: string;
+        /** Display name for the package in generated docs. Auto-detected from package.json if omitted. */
+        packageDisplayName?: string;
+        /** TypeDoc output file strategy. */
+        outputFileStrategy?: string;
+        /** Flatten output files into a single directory. */
+        flattenOutputFiles?: boolean;
+        /** Hide page headers in generated Markdown. */
+        hidePageHeader?: boolean;
+        /** Hide page titles in generated Markdown. */
+        hidePageTitle?: boolean;
+        /** Hide breadcrumb navigation in generated Markdown. */
+        hideBreadcrumbs?: boolean;
+        /** Wrap code examples in fenced code blocks. */
+        useCodeBlocks?: boolean;
+        /** Expand object types inline. */
+        expandObjects?: boolean;
+        /** Format for function parameters. */
+        parametersFormat?: string;
+        /** Format for enum members. */
+        enumMembersFormat?: string;
+        /** Format for type declarations. */
+        typeDeclarationFormat?: string;
+        /** Format for index/listing pages. */
+        indexFormat?: string;
+        /** TypeDoc member kinds that get their own file. */
+        membersWithOwnFile?: string[];
+        /** Exclude private members from docs. */
+        excludePrivate?: boolean;
+        /** Exclude protected members from docs. */
+        excludeProtected?: boolean;
+        /** Exclude external/third-party symbols from docs. */
+        excludeExternals?: boolean;
+        /** Category display order in index pages. */
+        categoryOrder?: string[];
+        /** Sort order for members. */
+        sort?: string[];
+        /** Kind sort order for members. */
+        kindSortOrder?: string[];
+        /** Git revision used for source links. */
+        gitRevision?: string;
+        /** TypeDoc log level. */
+        logLevel?: string;
+        /** Post-processing options for generated Markdown. */
+        postProcessing?: IPostProcessingOptions;
+        /** Enable verbose logging. */
+        verbose?: boolean;
+    }
+    /**
+     * Runs the generate-package-docs task.
+     *
+     * @public
+     */
+    function run(options: IGeneratePackageDocsTaskOptions): Promise<void>;
+}
+//# sourceMappingURL=executor.task.d.ts.map

package/executors/generate-package-docs/executor.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.task.d.ts","sourceRoot":"","sources":["../../../src/executors/generate-package-docs/executor.task.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,yBAAiB,uBAAuB,CAAC;IAErC;;;;OAIG;IACH,UAAiB,sBAAsB;QACnC,uDAAuD;QACvD,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,gEAAgE;QAChE,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,iEAAiE;QACjE,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,gEAAgE;QAChE,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,sDAAsD;QACtD,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,kEAAkE;QAClE,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,sEAAsE;QACtE,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,mEAAmE;QACnE,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAChC;IAED;;;;OAIG;IACH,UAAiB,+BAA+B;QAC5C,yCAAyC;QACzC,GAAG,EAAE,MAAM,CAAC;QACZ,2CAA2C;QAC3C,aAAa,EAAE,MAAM,CAAC;QACtB,uBAAuB;QACvB,WAAW,EAAE,MAAM,CAAC;QAEpB,0CAA0C;QAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,6EAA6E;QAC7E,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;QACjC,gDAAgD;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iEAAiE;QACjE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kGAAkG;QAClG,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAE5B,oCAAoC;QACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,oDAAoD;QACpD,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,+CAA+C;QAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,8CAA8C;QAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,wDAAwD;QACxD,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,gDAAgD;QAChD,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,kCAAkC;QAClC,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,sCAAsC;QACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,+BAA+B;QAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,oCAAoC;QACpC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,sCAAsC;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oDAAoD;QACpD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAE9B,yCAAyC;QACzC,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,2CAA2C;QAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAG3B,sDAAsD;QACtD,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAE3B,6CAA6C;QAC7C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,8BAA8B;QAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,mCAAmC;QACnC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAEzB,0CAA0C;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,yBAAyB;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,sDAAsD;QACtD,cAAc,CAAC,EAAE,sBAAsB,CAAC;QAExC,8BAA8B;QAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;KACrB;IA6CD;;;;OAIG;IACH,SAAsB,GAAG,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyJjF;CAuDJ"}

package/executors/generate-package-docs/executor.task.js

@@ -0,0 +1,259 @@
+"use strict";
+// #region Imports
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratePackageDocsTask = void 0;
+const utilities_1 = require("@breadstone-infrastructure/utilities");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const markdown_processing_1 = require("../../utils/markdown-processing");
+// #endregion
+/**
+ * @description Task to generate API documentation for a library package using TypeDoc.
+ * @public
+ */
+var GeneratePackageDocsTask;
+(function (GeneratePackageDocsTask) {
+    // #region Fields
+    const DEFAULT_POST_PROCESSING = {
+        removeReadme: true,
+        renameGlobalsToIndex: true,
+        rewriteLinks: true,
+        escapeAngleBrackets: true,
+        normalizeFrontmatter: true,
+        markAsGenerated: true,
+        stripPackageBackLink: true,
+        resolveInlineLinks: true,
+    };
+    const DEFAULT_OPTIONS = {
+        entryPoint: 'src/Index.ts',
+        tsConfig: 'tsconfig.json',
+        outputFileStrategy: 'members',
+        flattenOutputFiles: true,
+        hidePageHeader: false,
+        hidePageTitle: false,
+        hideBreadcrumbs: true,
+        useCodeBlocks: true,
+        expandObjects: true,
+        parametersFormat: 'table',
+        enumMembersFormat: 'table',
+        typeDeclarationFormat: 'table',
+        indexFormat: 'table',
+        membersWithOwnFile: ['Class', 'Interface', 'TypeAlias', 'Enum', 'Function', 'Variable'],
+        excludePrivate: true,
+        excludeProtected: false,
+        excludeInternal: true,
+        excludeExternals: true,
+        categoryOrder: ['Classes', 'Interfaces', 'Type Aliases', 'Functions', 'Enumerations', 'Variables'],
+        sort: ['alphabetical'],
+        kindSortOrder: ['Class', 'Interface', 'TypeAlias', 'Function', 'Enum', 'Variable'],
+        gitRevision: 'main',
+        logLevel: 'Warn',
+    };
+    // #endregion
+    // #region Methods
+    /**
+     * Runs the generate-package-docs task.
+     *
+     * @public
+     */
+    async function run(options) {
+        const logger = new utilities_1.ConsoleLogger();
+        (0, utilities_1.logSeparator)(logger, 'Generate Package Docs');
+        const projectRoot = options.cwd;
+        const workspaceRoot = options.workspaceRoot;
+        const projectName = options.projectName;
+        const entryPointRelative = options.entryPoint ?? DEFAULT_OPTIONS.entryPoint;
+        const entryPoint = path.resolve(projectRoot, entryPointRelative);
+        if (!fs.existsSync(entryPoint)) {
+            throw new Error(`Entry point not found: ${entryPoint}`);
+        }
+        const tsConfigRelative = options.tsConfig ?? DEFAULT_OPTIONS.tsConfig;
+        const tsConfig = path.resolve(projectRoot, tsConfigRelative);
+        const fallbackTsConfig = path.join(workspaceRoot, 'tsconfig.base.json');
+        const outputDir = options.outputDir
+            ? path.resolve(workspaceRoot, options.outputDir)
+            : path.join(workspaceRoot, '.docs', 'packages', projectName, 'api');
+        let packageDisplayName = options.packageDisplayName ?? projectName;
+        const packageJsonPath = path.join(projectRoot, 'package.json');
+        if (!options.packageDisplayName && fs.existsSync(packageJsonPath)) {
+            try {
+                const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                if (pkgJson.name) {
+                    packageDisplayName = pkgJson.name;
+                }
+            }
+            catch {
+                // Falls back to project name
+            }
+        }
+        const additionalEntryPoints = resolveAdditionalEntryPoints(options.additionalEntryPoints, workspaceRoot, options.verbose ? logger : undefined);
+        if (options.verbose) {
+            logger.log(`  📦 Project: ${projectName}`);
+            logger.log(`  📂 Entry: ${entryPoint}`);
+            if (additionalEntryPoints.length > 0) {
+                logger.log(`  📂 Additional entries: ${additionalEntryPoints.length}`);
+            }
+            logger.log(`  📁 Output: ${outputDir}`);
+        }
+        logger.log(`  📦 Generating docs for ${projectName}...`);
+        if (fs.existsSync(outputDir)) {
+            fs.rmSync(outputDir, { recursive: true });
+        }
+        let typedocEntry = entryPoint;
+        let tempEntryFile = null;
+        if (additionalEntryPoints.length > 0) {
+            logger.log(`  📂 Entry points: main + ${additionalEntryPoints.length} subpath(s)`);
+            const libSrc = path.join(projectRoot, 'src');
+            tempEntryFile = path.join(libSrc, '_typedoc-entry.ts');
+            const lines = ["export * from './index';"];
+            for (const ep of additionalEntryPoints) {
+                const rel = path.relative(libSrc, ep).replace(/\.ts$/, '').replace(/\\/g, '/');
+                lines.push(`export * from './${rel}';`);
+            }
+            fs.writeFileSync(tempEntryFile, lines.join('\n') + '\n', 'utf-8');
+            typedocEntry = tempEntryFile;
+        }
+        try {
+            const { Application } = await Promise.resolve().then(() => __importStar(require('typedoc')));
+            const typedocOptions = {
+                entryPoints: [typedocEntry],
+                entryPointStrategy: 'resolve',
+                tsconfig: fs.existsSync(tsConfig) ? tsConfig : fallbackTsConfig,
+                skipErrorChecking: true,
+                out: outputDir,
+                plugin: ['typedoc-plugin-markdown'],
+                outputFileStrategy: options.outputFileStrategy ?? DEFAULT_OPTIONS.outputFileStrategy,
+                flattenOutputFiles: options.flattenOutputFiles ?? DEFAULT_OPTIONS.flattenOutputFiles,
+                hidePageHeader: options.hidePageHeader ?? DEFAULT_OPTIONS.hidePageHeader,
+                hidePageTitle: options.hidePageTitle ?? DEFAULT_OPTIONS.hidePageTitle,
+                hideBreadcrumbs: options.hideBreadcrumbs ?? DEFAULT_OPTIONS.hideBreadcrumbs,
+                useCodeBlocks: options.useCodeBlocks ?? DEFAULT_OPTIONS.useCodeBlocks,
+                expandObjects: options.expandObjects ?? DEFAULT_OPTIONS.expandObjects,
+                parametersFormat: options.parametersFormat ?? DEFAULT_OPTIONS.parametersFormat,
+                enumMembersFormat: options.enumMembersFormat ?? DEFAULT_OPTIONS.enumMembersFormat,
+                typeDeclarationFormat: options.typeDeclarationFormat ?? DEFAULT_OPTIONS.typeDeclarationFormat,
+                indexFormat: options.indexFormat ?? DEFAULT_OPTIONS.indexFormat,
+                membersWithOwnFile: options.membersWithOwnFile ?? DEFAULT_OPTIONS.membersWithOwnFile,
+                projectDocuments: [],
+                excludePrivate: options.excludePrivate ?? DEFAULT_OPTIONS.excludePrivate,
+                excludeProtected: options.excludeProtected ?? DEFAULT_OPTIONS.excludeProtected,
+                excludeInternal: options.excludeInternal ?? DEFAULT_OPTIONS.excludeInternal,
+                excludeExternals: options.excludeExternals ?? DEFAULT_OPTIONS.excludeExternals,
+                categoryOrder: options.categoryOrder ?? DEFAULT_OPTIONS.categoryOrder,
+                sort: options.sort ?? DEFAULT_OPTIONS.sort,
+                kindSortOrder: options.kindSortOrder ?? DEFAULT_OPTIONS.kindSortOrder,
+                gitRevision: options.gitRevision ?? DEFAULT_OPTIONS.gitRevision,
+                logLevel: options.logLevel ?? DEFAULT_OPTIONS.logLevel,
+                name: packageDisplayName,
+            };
+            const app = await Application.bootstrapWithPlugins(typedocOptions);
+            const project = await app.convert();
+            if (!project) {
+                throw new Error(`TypeDoc conversion failed for ${projectName}`);
+            }
+            await app.generateOutputs(project);
+            const postProcessing = { ...DEFAULT_POST_PROCESSING, ...options.postProcessing };
+            if (postProcessing.removeReadme) {
+                const readmePath = path.join(outputDir, 'README.md');
+                if (fs.existsSync(readmePath)) {
+                    fs.unlinkSync(readmePath);
+                }
+            }
+            if (postProcessing.renameGlobalsToIndex) {
+                const globalsPath = path.join(outputDir, 'globals.md');
+                const indexPath = path.join(outputDir, 'index.md');
+                if (fs.existsSync(globalsPath) && !fs.existsSync(indexPath)) {
+                    fs.renameSync(globalsPath, indexPath);
+                }
+            }
+            processGeneratedMarkdown(outputDir, postProcessing);
+            const count = (0, markdown_processing_1.countMarkdownFiles)(outputDir);
+            logger.log(`  ✅ ${projectName}: ${count} API doc files`);
+        }
+        finally {
+            if (tempEntryFile && fs.existsSync(tempEntryFile)) {
+                fs.unlinkSync(tempEntryFile);
+            }
+            (0, utilities_1.logSeparator)(logger);
+        }
+    }
+    GeneratePackageDocsTask.run = run;
+    // #endregion
+    // #region Private
+    function resolveAdditionalEntryPoints(entryPoints, workspaceRoot, logger) {
+        if (!entryPoints) {
+            return [];
+        }
+        const resolved = [];
+        for (const ep of entryPoints) {
+            const abs = path.isAbsolute(ep) ? ep : path.resolve(workspaceRoot, ep);
+            if (fs.existsSync(abs)) {
+                resolved.push(abs);
+            }
+            else {
+                logger?.warn(`  ⚠ Additional entry point not found: ${ep}`);
+            }
+        }
+        return resolved;
+    }
+    function processGeneratedMarkdown(dir, options) {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                processGeneratedMarkdown(fullPath, options);
+            }
+            else if (entry.name.endsWith('.md')) {
+                if (options.normalizeFrontmatter) {
+                    (0, markdown_processing_1.normalizeFrontmatter)(fullPath, { generated: options.markAsGenerated });
+                }
+                if (options.rewriteLinks) {
+                    (0, markdown_processing_1.rewriteLinks)(fullPath);
+                }
+                if (options.stripPackageBackLink) {
+                    (0, markdown_processing_1.stripPackageBackLink)(fullPath);
+                }
+                if (options.resolveInlineLinks) {
+                    (0, markdown_processing_1.resolveInlineLinks)(fullPath);
+                }
+                if (options.escapeAngleBrackets) {
+                    (0, markdown_processing_1.escapeAngleBrackets)(fullPath);
+                }
+            }
+        }
+    }
+    // #endregion
+})(GeneratePackageDocsTask || (exports.GeneratePackageDocsTask = GeneratePackageDocsTask = {}));
+//# sourceMappingURL=executor.task.js.map

package/executors/generate-package-docs/executor.task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.task.js","sourceRoot":"","sources":["../../../src/executors/generate-package-docs/executor.task.ts"],"names":[],"mappings":"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"}