@storybook/angular 9.0.0-beta.6 → 9.0.0-beta.7

package/dist/builders/build-storybook/index.mjs

@@ -0,0 +1,78 @@
+import { getEnvConfig, versions } from 'storybook/internal/common';
+import { buildStaticStandalone, withTelemetry } from 'storybook/internal/core-server';
+import { addToGlobalContext } from 'storybook/internal/telemetry';
+import { createBuilder, targetFromTargetString, } from '@angular-devkit/architect';
+import { findPackageSync } from 'fd-package-json';
+import { sync as findUpSync } from 'find-up';
+import { from, of, throwError } from 'rxjs';
+import { catchError, map, mapTo, switchMap } from 'rxjs/operators';
+import { errorSummary, printErrorDetails } from '../utils/error-handler';
+import { runCompodoc } from '../utils/run-compodoc';
+addToGlobalContext('cliVersion', versions.storybook);
+const commandBuilder = (options, context) => {
+    const builder = from(setup(options, context)).pipe(switchMap(({ tsConfig }) => {
+        const docTSConfig = findUpSync('tsconfig.doc.json', { cwd: options.configDir });
+        const runCompodoc$ = options.compodoc
+            ? runCompodoc({ compodocArgs: options.compodocArgs, tsconfig: docTSConfig ?? tsConfig }, context).pipe(mapTo({ tsConfig }))
+            : of({});
+        return runCompodoc$.pipe(mapTo({ tsConfig }));
+    }), map(({ tsConfig }) => {
+        getEnvConfig(options, {
+            staticDir: 'SBCONFIG_STATIC_DIR',
+            outputDir: 'SBCONFIG_OUTPUT_DIR',
+            configDir: 'SBCONFIG_CONFIG_DIR',
+        });
+        const { browserTarget, stylePreprocessorOptions, styles, configDir, docs, loglevel, test, outputDir, quiet, enableProdMode = true, webpackStatsJson, statsJson, debugWebpack, disableTelemetry, assets, previewUrl, sourceMap = false, preserveSymlinks = false, experimentalZoneless = false, } = options;
+        const standaloneOptions = {
+            packageJson: findPackageSync(__dirname),
+            configDir,
+            ...(docs ? { docs } : {}),
+            loglevel,
+            outputDir,
+            test,
+            quiet,
+            enableProdMode,
+            disableTelemetry,
+            angularBrowserTarget: browserTarget,
+            angularBuilderContext: context,
+            angularBuilderOptions: {
+                ...(stylePreprocessorOptions ? { stylePreprocessorOptions } : {}),
+                ...(styles ? { styles } : {}),
+                ...(assets ? { assets } : {}),
+                sourceMap,
+                preserveSymlinks,
+                experimentalZoneless,
+            },
+            tsConfig,
+            webpackStatsJson,
+            statsJson,
+            debugWebpack,
+            previewUrl,
+        };
+        return standaloneOptions;
+    }), switchMap((standaloneOptions) => runInstance({ ...standaloneOptions, mode: 'static' })), map(() => {
+        return { success: true };
+    }));
+    return builder;
+};
+export default createBuilder(commandBuilder);
+async function setup(options, context) {
+    let browserOptions;
+    let browserTarget;
+    if (options.browserTarget) {
+        browserTarget = targetFromTargetString(options.browserTarget);
+        browserOptions = await context.validateOptions(await context.getTargetOptions(browserTarget), await context.getBuilderNameForTarget(browserTarget));
+    }
+    return {
+        tsConfig: options.tsConfig ??
+            findUpSync('tsconfig.json', { cwd: options.configDir }) ??
+            browserOptions.tsConfig,
+    };
+}
+function runInstance(options) {
+    return from(withTelemetry('build', {
+        cliOptions: options,
+        presetOptions: { ...options, corePresets: [], overridePresets: [] },
+        printError: printErrorDetails,
+    }, () => buildStaticStandalone(options))).pipe(catchError((error) => throwError(errorSummary(error))));
+}

package/dist/builders/build-storybook/index.spec.mjs

@@ -0,0 +1,187 @@
+import { Architect, createBuilder } from '@angular-devkit/architect';
+import { TestingArchitectHost } from '@angular-devkit/architect/testing';
+import { schema } from '@angular-devkit/core';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const buildDevStandaloneMock = vi.fn();
+const buildStaticStandaloneMock = vi.fn();
+const buildMock = {
+    buildDevStandalone: buildDevStandaloneMock,
+    buildStaticStandalone: buildStaticStandaloneMock,
+    withTelemetry: (name, options, fn) => fn(),
+};
+vi.doMock('storybook/internal/core-server', () => buildMock);
+vi.doMock('storybook/internal/common', () => ({
+    JsPackageManagerFactory: {
+        getPackageManager: () => ({
+            runPackageCommand: mockRunScript,
+        }),
+    },
+    getEnvConfig: (options) => options,
+    versions: {
+        storybook: 'x.x.x',
+    },
+}));
+vi.doMock('find-up', () => ({ sync: () => './storybook/tsconfig.ts' }));
+const mockRunScript = vi.fn();
+// Randomly fails on CI. TODO: investigate why
+describe.skip('Build Storybook Builder', () => {
+    let architect;
+    let architectHost;
+    beforeEach(async () => {
+        const registry = new schema.CoreSchemaRegistry();
+        registry.addPostTransform(schema.transforms.addUndefinedDefaults);
+        architectHost = new TestingArchitectHost();
+        architect = new Architect(architectHost, registry);
+        architectHost.addBuilder('@angular-devkit/build-angular:browser', createBuilder(() => {
+            return { success: true };
+        }));
+        architectHost.addTarget({ project: 'angular-cli', target: 'build-2' }, '@angular-devkit/build-angular:browser', {
+            outputPath: 'dist/angular-cli',
+            index: 'src/index.html',
+            main: 'src/main.ts',
+            polyfills: 'src/polyfills.ts',
+            tsConfig: 'src/tsconfig.app.json',
+            assets: ['src/favicon.ico', 'src/assets'],
+            styles: ['src/styles.css'],
+            scripts: [],
+        });
+        // This will either take a Node package name, or a path to the directory
+        // for the package.json file.
+        await architectHost.addBuilderFromPackage(path.join(__dirname, '../../..'));
+    });
+    beforeEach(() => {
+        buildStaticStandaloneMock.mockImplementation((_options) => Promise.resolve(_options));
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should start storybook with angularBrowserTarget', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:build-storybook', {
+            browserTarget: 'angular-cli:build-2',
+            compodoc: false,
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).not.toHaveBeenCalledWith();
+        expect(buildStaticStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: 'angular-cli:build-2',
+            angularBuilderContext: expect.any(Object),
+            configDir: '.storybook',
+            loglevel: undefined,
+            quiet: false,
+            disableTelemetry: undefined,
+            outputDir: 'storybook-static',
+            packageJson: expect.any(Object),
+            mode: 'static',
+            tsConfig: './storybook/tsconfig.ts',
+            statsJson: false,
+        }));
+    });
+    it('should start storybook with tsConfig', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:build-storybook', {
+            tsConfig: 'path/to/tsConfig.json',
+            compodoc: false,
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).not.toHaveBeenCalledWith();
+        expect(buildStaticStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: null,
+            angularBuilderContext: expect.any(Object),
+            configDir: '.storybook',
+            loglevel: undefined,
+            quiet: false,
+            disableTelemetry: undefined,
+            outputDir: 'storybook-static',
+            packageJson: expect.any(Object),
+            mode: 'static',
+            tsConfig: 'path/to/tsConfig.json',
+            statsJson: false,
+        }));
+    });
+    it('should build storybook with webpack stats.json', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:build-storybook', {
+            tsConfig: 'path/to/tsConfig.json',
+            compodoc: false,
+            statsJson: true,
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).not.toHaveBeenCalledWith();
+        expect(buildStaticStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: null,
+            angularBuilderContext: expect.any(Object),
+            configDir: '.storybook',
+            loglevel: undefined,
+            quiet: false,
+            outputDir: 'storybook-static',
+            packageJson: expect.any(Object),
+            mode: 'static',
+            tsConfig: 'path/to/tsConfig.json',
+            statsJson: true,
+        }));
+    });
+    it('should throw error', async () => {
+        buildStaticStandaloneMock.mockRejectedValue(true);
+        const run = await architect.scheduleBuilder('@storybook/angular:build-storybook', {
+            browserTarget: 'angular-cli:build-2',
+            compodoc: false,
+        });
+        try {
+            await run.result;
+            expect(false).toEqual('Throw expected');
+        }
+        catch (error) {
+            expect(error).toEqual('Broken build, fix the error above.\nYou may need to refresh the browser.');
+        }
+    });
+    it('should run compodoc', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:build-storybook', {
+            browserTarget: 'angular-cli:build-2',
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).toHaveBeenCalledWith('compodoc', ['-p', './storybook/tsconfig.ts', '-d', '.', '-e', 'json'], '');
+        expect(buildStaticStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: 'angular-cli:build-2',
+            angularBuilderContext: expect.any(Object),
+            configDir: '.storybook',
+            loglevel: undefined,
+            quiet: false,
+            outputDir: 'storybook-static',
+            packageJson: expect.any(Object),
+            mode: 'static',
+            tsConfig: './storybook/tsconfig.ts',
+            statsJson: false,
+        }));
+    });
+    it('should start storybook with styles options', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:build-storybook', {
+            tsConfig: 'path/to/tsConfig.json',
+            compodoc: false,
+            styles: ['style.scss'],
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).not.toHaveBeenCalledWith();
+        expect(buildStaticStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: null,
+            angularBuilderContext: expect.any(Object),
+            angularBuilderOptions: { assets: [], styles: ['style.scss'] },
+            configDir: '.storybook',
+            loglevel: undefined,
+            quiet: false,
+            outputDir: 'storybook-static',
+            packageJson: expect.any(Object),
+            mode: 'static',
+            tsConfig: 'path/to/tsConfig.json',
+            statsJson: false,
+        }));
+    });
+});

package/dist/builders/start-storybook/index.mjs

@@ -0,0 +1,99 @@
+import { getEnvConfig, versions } from 'storybook/internal/common';
+import { buildDevStandalone, withTelemetry } from 'storybook/internal/core-server';
+import { addToGlobalContext } from 'storybook/internal/telemetry';
+import { createBuilder, targetFromTargetString, } from '@angular-devkit/architect';
+import { findPackageSync } from 'fd-package-json';
+import { sync as findUpSync } from 'find-up';
+import { Observable, from, of } from 'rxjs';
+import { map, mapTo, switchMap } from 'rxjs/operators';
+import { errorSummary, printErrorDetails } from '../utils/error-handler';
+import { runCompodoc } from '../utils/run-compodoc';
+addToGlobalContext('cliVersion', versions.storybook);
+const commandBuilder = (options, context) => {
+    const builder = from(setup(options, context)).pipe(switchMap(({ tsConfig }) => {
+        const docTSConfig = findUpSync('tsconfig.doc.json', { cwd: options.configDir });
+        const runCompodoc$ = options.compodoc
+            ? runCompodoc({
+                compodocArgs: [...options.compodocArgs, ...(options.quiet ? ['--silent'] : [])],
+                tsconfig: docTSConfig ?? tsConfig,
+            }, context).pipe(mapTo({ tsConfig }))
+            : of({});
+        return runCompodoc$.pipe(mapTo({ tsConfig }));
+    }), map(({ tsConfig }) => {
+        getEnvConfig(options, {
+            port: 'SBCONFIG_PORT',
+            host: 'SBCONFIG_HOSTNAME',
+            staticDir: 'SBCONFIG_STATIC_DIR',
+            configDir: 'SBCONFIG_CONFIG_DIR',
+            ci: 'CI',
+        });
+        options.port = parseInt(`${options.port}`, 10);
+        const { browserTarget, stylePreprocessorOptions, styles, ci, configDir, docs, host, https, port, quiet, enableProdMode = false, smokeTest, sslCa, sslCert, sslKey, disableTelemetry, assets, initialPath, open, debugWebpack, loglevel, webpackStatsJson, statsJson, previewUrl, sourceMap = false, preserveSymlinks = false, experimentalZoneless = false, } = options;
+        const standaloneOptions = {
+            packageJson: findPackageSync(__dirname),
+            ci,
+            configDir,
+            ...(docs ? { docs } : {}),
+            host,
+            https,
+            port,
+            quiet,
+            enableProdMode,
+            smokeTest,
+            sslCa,
+            sslCert,
+            sslKey,
+            disableTelemetry,
+            angularBrowserTarget: browserTarget,
+            angularBuilderContext: context,
+            angularBuilderOptions: {
+                ...(stylePreprocessorOptions ? { stylePreprocessorOptions } : {}),
+                ...(styles ? { styles } : {}),
+                ...(assets ? { assets } : {}),
+                preserveSymlinks,
+                sourceMap,
+                experimentalZoneless,
+            },
+            tsConfig,
+            initialPath,
+            open,
+            debugWebpack,
+            webpackStatsJson,
+            statsJson,
+            loglevel,
+            previewUrl,
+        };
+        return standaloneOptions;
+    }), switchMap((standaloneOptions) => runInstance(standaloneOptions)), map((port) => {
+        return { success: true, info: { port } };
+    }));
+    return builder;
+};
+export default createBuilder(commandBuilder);
+async function setup(options, context) {
+    let browserOptions;
+    let browserTarget;
+    if (options.browserTarget) {
+        browserTarget = targetFromTargetString(options.browserTarget);
+        browserOptions = await context.validateOptions(await context.getTargetOptions(browserTarget), await context.getBuilderNameForTarget(browserTarget));
+    }
+    return {
+        tsConfig: options.tsConfig ??
+            findUpSync('tsconfig.json', { cwd: options.configDir }) ??
+            browserOptions.tsConfig,
+    };
+}
+function runInstance(options) {
+    return new Observable((observer) => {
+        // This Observable intentionally never complete, leaving the process running ;)
+        withTelemetry('dev', {
+            cliOptions: options,
+            presetOptions: { ...options, corePresets: [], overridePresets: [] },
+            printError: printErrorDetails,
+        }, () => buildDevStandalone(options))
+            .then(({ port }) => observer.next(port))
+            .catch((error) => {
+            observer.error(errorSummary(error));
+        });
+    });
+}

package/dist/builders/start-storybook/index.spec.mjs

@@ -0,0 +1,186 @@
+import { Architect, createBuilder } from '@angular-devkit/architect';
+import { TestingArchitectHost } from '@angular-devkit/architect/testing';
+import { schema } from '@angular-devkit/core';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const buildDevStandaloneMock = vi.fn();
+const buildStaticStandaloneMock = vi.fn();
+const buildMock = {
+    buildDevStandalone: buildDevStandaloneMock,
+    buildStaticStandalone: buildStaticStandaloneMock,
+    withTelemetry: (_, __, fn) => fn(),
+};
+vi.doMock('storybook/internal/core-server', () => buildMock);
+vi.doMock('find-up', () => ({ sync: () => './storybook/tsconfig.ts' }));
+const mockRunScript = vi.fn();
+vi.mock('storybook/internal/common', () => ({
+    getEnvConfig: (options) => options,
+    versions: {
+        storybook: 'x.x.x',
+    },
+    JsPackageManagerFactory: {
+        getPackageManager: () => ({
+            runPackageCommand: mockRunScript,
+        }),
+    },
+}));
+// Randomly fails on CI. TODO: investigate why
+describe.skip('Start Storybook Builder', () => {
+    let architect;
+    let architectHost;
+    beforeEach(async () => {
+        const registry = new schema.CoreSchemaRegistry();
+        registry.addPostTransform(schema.transforms.addUndefinedDefaults);
+        architectHost = new TestingArchitectHost();
+        architect = new Architect(architectHost, registry);
+        architectHost.addBuilder('@angular-devkit/build-angular:browser', createBuilder(() => {
+            return { success: true };
+        }));
+        architectHost.addTarget({ project: 'angular-cli', target: 'build-2' }, '@angular-devkit/build-angular:browser', {
+            outputPath: 'dist/angular-cli',
+            index: 'src/index.html',
+            main: 'src/main.ts',
+            polyfills: 'src/polyfills.ts',
+            tsConfig: 'src/tsconfig.app.json',
+            assets: ['src/favicon.ico', 'src/assets'],
+            styles: ['src/styles.css'],
+            scripts: [],
+        });
+        // This will either take a Node package name, or a path to the directory
+        // for the package.json file.
+        await architectHost.addBuilderFromPackage(join(__dirname, '../../..'));
+    });
+    beforeEach(() => {
+        buildDevStandaloneMock.mockImplementation((_options) => Promise.resolve(_options));
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should start storybook with angularBrowserTarget', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:start-storybook', {
+            browserTarget: 'angular-cli:build-2',
+            port: 4400,
+            compodoc: false,
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).not.toHaveBeenCalledWith();
+        expect(buildDevStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: 'angular-cli:build-2',
+            angularBuilderContext: expect.any(Object),
+            ci: false,
+            configDir: '.storybook',
+            disableTelemetry: undefined,
+            host: 'localhost',
+            https: false,
+            packageJson: expect.any(Object),
+            port: 4400,
+            quiet: false,
+            smokeTest: false,
+            sslCa: undefined,
+            sslCert: undefined,
+            sslKey: undefined,
+            tsConfig: './storybook/tsconfig.ts',
+        }));
+    });
+    it('should start storybook with tsConfig', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:start-storybook', {
+            tsConfig: 'path/to/tsConfig.json',
+            port: 4400,
+            compodoc: false,
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).not.toHaveBeenCalledWith();
+        expect(buildDevStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: null,
+            angularBuilderContext: expect.any(Object),
+            ci: false,
+            configDir: '.storybook',
+            disableTelemetry: undefined,
+            host: 'localhost',
+            https: false,
+            packageJson: expect.any(Object),
+            port: 4400,
+            quiet: false,
+            smokeTest: false,
+            sslCa: undefined,
+            sslCert: undefined,
+            sslKey: undefined,
+            tsConfig: 'path/to/tsConfig.json',
+        }));
+    });
+    it('should throw error', async () => {
+        buildDevStandaloneMock.mockRejectedValue(true);
+        const run = await architect.scheduleBuilder('@storybook/angular:start-storybook', {
+            browserTarget: 'angular-cli:build-2',
+            port: 4400,
+            compodoc: false,
+        });
+        try {
+            await run.result;
+            expect(false).toEqual('Throw expected');
+        }
+        catch (error) {
+            expect(error).toEqual('Broken build, fix the error above.\nYou may need to refresh the browser.');
+        }
+    });
+    it('should run compodoc', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:start-storybook', {
+            browserTarget: 'angular-cli:build-2',
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).toHaveBeenCalledWith('compodoc', ['-p', './storybook/tsconfig.ts', '-d', '.', '-e', 'json'], '');
+        expect(buildDevStandaloneMock).toHaveBeenCalledWith(expect.objectContaining({
+            angularBrowserTarget: 'angular-cli:build-2',
+            angularBuilderContext: expect.any(Object),
+            ci: false,
+            disableTelemetry: undefined,
+            configDir: '.storybook',
+            host: 'localhost',
+            https: false,
+            packageJson: expect.any(Object),
+            port: 9009,
+            quiet: false,
+            smokeTest: false,
+            sslCa: undefined,
+            sslCert: undefined,
+            sslKey: undefined,
+            tsConfig: './storybook/tsconfig.ts',
+        }));
+    });
+    it('should start storybook with styles options', async () => {
+        const run = await architect.scheduleBuilder('@storybook/angular:start-storybook', {
+            tsConfig: 'path/to/tsConfig.json',
+            port: 4400,
+            compodoc: false,
+            styles: ['src/styles.css'],
+        });
+        const output = await run.result;
+        await run.stop();
+        expect(output.success).toBeTruthy();
+        expect(mockRunScript).not.toHaveBeenCalledWith();
+        expect(buildDevStandaloneMock).toHaveBeenCalledWith({
+            angularBrowserTarget: null,
+            angularBuilderContext: expect.any(Object),
+            angularBuilderOptions: { assets: [], styles: ['src/styles.css'] },
+            disableTelemetry: undefined,
+            ci: false,
+            configDir: '.storybook',
+            host: 'localhost',
+            https: false,
+            port: 4400,
+            packageJson: expect.any(Object),
+            quiet: false,
+            smokeTest: false,
+            sslCa: undefined,
+            sslCert: undefined,
+            sslKey: undefined,
+            tsConfig: 'path/to/tsConfig.json',
+        });
+    });
+});

package/dist/builders/utils/error-handler.mjs

@@ -0,0 +1,33 @@
+import { logger, instance as npmLog } from 'storybook/internal/node-logger';
+import { dedent } from 'ts-dedent';
+export const printErrorDetails = (error) => {
+    // Duplicate code for Standalone error handling
+    // Source: https://github.com/storybookjs/storybook/blob/39c7ba09ad84fbd466f9c25d5b92791a5450b9f6/lib/core-server/src/build-dev.ts#L136
+    npmLog.heading = '';
+    if (error instanceof Error) {
+        if (error.error) {
+            logger.error(error.error);
+        }
+        else if (error.stats && error.stats.compilation.errors) {
+            error.stats.compilation.errors.forEach((e) => logger.plain(e));
+        }
+        else {
+            logger.error(error);
+        }
+    }
+    else if (error.compilation?.errors) {
+        error.compilation.errors.forEach((e) => logger.plain(e));
+    }
+    logger.line();
+};
+export const errorSummary = (error) => {
+    return error.close
+        ? dedent `
+      FATAL broken build!, will close the process,
+      Fix the error below and restart storybook.
+    `
+        : dedent `
+      Broken build, fix the error above.
+      You may need to refresh the browser.
+    `;
+};

package/dist/builders/utils/run-compodoc.mjs

@@ -0,0 +1,31 @@
+import { isAbsolute, relative } from 'node:path';
+import { JsPackageManagerFactory } from 'storybook/internal/common';
+import { Observable } from 'rxjs';
+const hasTsConfigArg = (args) => args.indexOf('-p') !== -1;
+const hasOutputArg = (args) => args.indexOf('-d') !== -1 || args.indexOf('--output') !== -1;
+// relative is necessary to workaround a compodoc issue with
+// absolute paths on windows machines
+const toRelativePath = (pathToTsConfig) => {
+    return isAbsolute(pathToTsConfig) ? relative('.', pathToTsConfig) : pathToTsConfig;
+};
+export const runCompodoc = ({ compodocArgs, tsconfig }, context) => {
+    return new Observable((observer) => {
+        const tsConfigPath = toRelativePath(tsconfig);
+        const finalCompodocArgs = [
+            ...(hasTsConfigArg(compodocArgs) ? [] : ['-p', tsConfigPath]),
+            ...(hasOutputArg(compodocArgs) ? [] : ['-d', `${context.workspaceRoot || '.'}`]),
+            ...compodocArgs,
+        ];
+        const packageManager = JsPackageManagerFactory.getPackageManager();
+        try {
+            const stdout = packageManager.runPackageCommandSync('compodoc', finalCompodocArgs, context.workspaceRoot, 'inherit');
+            context.logger.info(stdout);
+            observer.next();
+            observer.complete();
+        }
+        catch (e) {
+            context.logger.error(e);
+            observer.error();
+        }
+    });
+};