angular/adev/shared-docs/pipeline/api-gen/rendering/test/cli.spec.mts

/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.dev/license
 */

import {resolve} from 'path';
import {readFile} from 'fs/promises';
import {JSDOM} from 'jsdom';
import {getRenderable} from '../processing.mjs';
import {renderEntry} from '../rendering.mjs';
import {initHighlighter} from '../../../shared/shiki.mjs';
import {setHighlighterInstance} from '../shiki/shiki.mjs';

describe('CLI docs to html', () => {
  let fragment: DocumentFragment;
  let entryJson: any;

  beforeAll(async () => {
    setHighlighterInstance(await initHighlighter());

    const entryContent = await readFile(resolve('./fake-cli-entries.json'), {
      encoding: 'utf-8',
    });

    entryJson = JSON.parse(entryContent) as any;
    const renderableJson = await getRenderable(entryJson, '', 'angular/cli');
    fragment = JSDOM.fragment(await renderEntry(renderableJson));
  });

  it('should subcommands correctly', async () => {
    const generateComponentSubcommand = entryJson.subcommands.find(
      (subcommand: any) => subcommand.name === 'component',
    );
    const renderableJson = await getRenderable(generateComponentSubcommand, '', 'angular/cli');
    fragment = JSDOM.fragment(await renderEntry(renderableJson));

    const cliTocs = fragment.querySelectorAll('.docs-reference-cli-toc')!;
    expect(cliTocs.length).toBe(2);

    expect(cliTocs[0].textContent).toContain('ng component [name] [options]');
    expect(cliTocs[1].textContent).toContain('ng c [name] [options]');
  });
});