npm - @diplodoc/cli - Versions diffs - 5.46.1 → 5.47.0 - Mend

@diplodoc/cli 5.46.1 → 5.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (852) hide show

package/tests/e2e/openapi-companion.spec.ts ADDED Viewed

@@ -0,0 +1,213 @@
+import {existsSync, readFileSync} from 'node:fs';
+import {resolve} from 'node:path';
+import {describe, expect, it} from 'vitest';
+import {TestAdapter, getTestPaths} from '../fixtures';
+/**
+ * These tests cover the CLI-side guarantees for the OpenAPI spec companion that are
+ * implemented in `packages/cli` (the openapi build wrapper + build-manifest feature):
+ *  - the standalone `*.openapi.json` file lands in the final output tree (md2md);
+ *  - its name is derived from the source spec (`petstore.yaml` -> `petstore.openapi.json`);
+ *  - it is recorded in the build manifest with the exact emitted path and the sibling
+ *    `index` leading page;
+ *  - emission does not depend on `--build-manifest`;
+ *  - for static md2html builds the companion hint is baked into the leading page `<body>`
+ *    as an HTML comment (the viewer does this at serve time for md2md, but md2html has no
+ *    viewer), gated by the companion actually being emitted.
+ *
+ * The companion *content* (filtering, x-hidden stripping, render-mode switching) is produced
+ * by `@diplodoc/openapi-extension` and is covered by that package's own unit tests.
+ */
+describe('OpenAPI spec companion (CLI build)', () => {
+    const COMPANION_PATH = 'api/petstore.openapi.json';
+    const LEADING_PAGE = 'api/index';
+    it('emits the .openapi.json companion into the md output tree', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+        });
+        const companion = resolve(outputPath, COMPANION_PATH);
+        expect(existsSync(companion)).toBe(true);
+        // The companion sits next to the generated leading page.
+        expect(existsSync(resolve(outputPath, 'api/index.md'))).toBe(true);
+        const raw = readFileSync(companion, 'utf-8');
+        // Valid JSON describing the spec.
+        const json = JSON.parse(raw);
+        expect(json.openapi).toBeTruthy();
+        expect(json.paths).toBeTruthy();
+        // Minified: no pretty-print whitespace.
+        expect(raw).not.toContain('\n');
+        expect(raw).toBe(JSON.stringify(json));
+    });
+    it('emits the companion even without --build-manifest', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+        });
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(true);
+        // Manifest is opt-in, so it must be absent here.
+        expect(existsSync(resolve(outputPath, 'yfm-build-manifest.json'))).toBe(false);
+    });
+    it('records the companion in the build manifest with the exact emitted path', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: '--build-manifest',
+        });
+        const manifest = JSON.parse(
+            readFileSync(resolve(outputPath, 'yfm-build-manifest.json'), 'utf-8'),
+        );
+        expect(Array.isArray(manifest.openapiCompanions)).toBe(true);
+        const entry = manifest.openapiCompanions.find(
+            (c: {companionPath: string}) => c.companionPath === COMPANION_PATH,
+        );
+        expect(entry).toBeDefined();
+        expect(entry.leadingPage).toBe(LEADING_PAGE);
+        // The path advertised by the manifest must resolve to a real file in the output.
+        expect(existsSync(resolve(outputPath, entry.companionPath))).toBe(true);
+    });
+    const COMMENT =
+        '<!-- json-схема со спецификацией доступна по ссылке: petstore.openapi.json -->';
+    it('bakes the companion comment into the static html body (md2html + ai opt-in)', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: false,
+            md2html: true,
+            // md2html emits the companion only when AI companions are explicitly enabled.
+            args: '--ai-openapi-companions',
+        });
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(true);
+        const html = readFileSync(resolve(outputPath, 'api/index.html'), 'utf-8');
+        expect(html).toContain(COMMENT);
+        // The comment must live inside <body>.
+        const body = html.slice(html.indexOf('<body'), html.indexOf('</body>'));
+        expect(body).toContain(COMMENT);
+    });
+    it('omits the companion and the comment for md2html without ai opt-in', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: false,
+            md2html: true,
+        });
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(false);
+        const html = readFileSync(resolve(outputPath, 'api/index.html'), 'utf-8');
+        expect(html).not.toContain('json-схема со спецификацией доступна по ссылке');
+    });
+});
+/**
+ * Covers the leading-page render-mode knobs introduced together with the companion:
+ *  - `leadingPage.spec.renderMode: inline | link` (toc);
+ *  - `--max-openapi-include-inline-size` auto-switching `inline -> link`;
+ *  - `ai.openapiCompanions: false` disabling companion emission.
+ *
+ * Assertions look at the generated leading page (`api/index.md`) and the presence of the
+ * companion file, which are the observable CLI-side outputs of these knobs.
+ */
+describe('OpenAPI leading page render modes & params (CLI build)', () => {
+    const COMPANION_PATH = 'api/petstore.openapi.json';
+    const INDEX_MD = 'api/index.md';
+    // Inline mode embeds the spec inside a `{% cut %}` block; link mode points to the companion.
+    const INLINE_MARKER = '{% cut "Open API" %}';
+    const LINK_MARKER = '[Open API specification](petstore.openapi.json)';
+    it('renderMode: inline (default) embeds the spec and still emits the companion', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {md2md: true, md2html: false});
+        const index = readFileSync(resolve(outputPath, INDEX_MD), 'utf-8');
+        expect(index).toContain(INLINE_MARKER);
+        expect(index).not.toContain(LINK_MARKER);
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(true);
+    });
+    it('renderMode: link renders a link to the companion instead of inlining it', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion-link');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {md2md: true, md2html: false});
+        const index = readFileSync(resolve(outputPath, INDEX_MD), 'utf-8');
+        expect(index).toContain(LINK_MARKER);
+        expect(index).not.toContain(INLINE_MARKER);
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(true);
+    });
+    it('--max-openapi-include-inline-size auto-switches inline -> link for large specs', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            // 1 byte: any real spec exceeds it, forcing the link form.
+            args: '--max-openapi-include-inline-size 1',
+        });
+        const index = readFileSync(resolve(outputPath, INDEX_MD), 'utf-8');
+        expect(index).toContain(LINK_MARKER);
+        expect(index).not.toContain(INLINE_MARKER);
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(true);
+    });
+    it('--max-openapi-include-inline-size 0 always renders the spec as a link', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: '--max-openapi-include-inline-size 0',
+        });
+        const index = readFileSync(resolve(outputPath, INDEX_MD), 'utf-8');
+        expect(index).toContain(LINK_MARKER);
+        expect(index).not.toContain(INLINE_MARKER);
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(true);
+    });
+    it('ai.openapiCompanions: false disables the companion file (md2md)', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-companion-disabled');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {md2md: true, md2html: false});
+        expect(existsSync(resolve(outputPath, COMPANION_PATH))).toBe(false);
+        // With no companion to link to, the leading page falls back to inlining the spec.
+        const index = readFileSync(resolve(outputPath, INDEX_MD), 'utf-8');
+        expect(index).toContain(INLINE_MARKER);
+        expect(index).not.toContain(LINK_MARKER);
+    });
+});

package/tests/e2e/openapi-include-size.spec.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import {readFileSync} from 'node:fs';
+import {resolve} from 'node:path';
+import {glob} from 'glob';
+import {describe, expect, it} from 'vitest';
+import {TestAdapter, getTestPaths} from '../fixtures';
+const STUB_MARKER = 'This page exceeds the maximum allowed size and cannot be displayed.';
+describe('OpenAPI max include size', () => {
+    it('should replace oversized pages with stub when limit is exceeded', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-include-size-exceeds');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: '--max-openapi-include-size 1K',
+        });
+        const files = await glob('**/*.md', {cwd: outputPath, nodir: true});
+        expect(files.length).toBeGreaterThan(0);
+        const stubbed = [];
+        const preserved = [];
+        for (const file of files) {
+            const content = readFileSync(resolve(outputPath, file), 'utf-8');
+            if (content.includes(STUB_MARKER)) {
+                stubbed.push(file);
+            } else {
+                preserved.push(file);
+            }
+        }
+        // Endpoint pages and main index exceed 1K and should be stubbed
+        expect(stubbed.length).toBeGreaterThan(0);
+    });
+    it('should preserve all content when pages are within limit', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/openapi-include-size-within');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: '--max-openapi-include-size 1K',
+        });
+        const files = await glob('**/*.md', {cwd: outputPath, nodir: true});
+        expect(files.length).toBeGreaterThan(0);
+        for (const file of files) {
+            const content = readFileSync(resolve(outputPath, file), 'utf-8');
+            expect(content).not.toContain(STUB_MARKER);
+        }
+    });
+});

package/tests/e2e/pdf-page.spec.ts ADDED Viewed

@@ -0,0 +1,127 @@
+import {describe, test} from 'vitest';
+import {TestAdapter, cleanupDirectory, compareDirectories, getTestPaths} from '../fixtures';
+const generateMapTestTemplate = (
+    testTitle: string,
+    testRootPath: string,
+    args: string,
+    folder = 'pdf',
+    ignoreFileContent = false,
+) => {
+    test(testTitle, async () => {
+        const {inputPath, outputPath} = getTestPaths(testRootPath);
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: false,
+            md2html: true,
+            args,
+        });
+        await compareDirectories(`${outputPath}/${folder}`, ignoreFileContent);
+        await cleanupDirectory(outputPath);
+    });
+};
+const generateMd2mdTestTemplate = async (testTitle: string, testRootPath: string) => {
+    test(testTitle, async () => {
+        const {inputPath, outputPath} = getTestPaths(testRootPath);
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: '--allow-custom-resources', // this is common arg in arc ci for md2md
+        });
+        await compareDirectories(outputPath, true);
+        const midOutputFolder = 'final-output';
+        const finalOutputPath = outputPath
+            .split('/')
+            .slice(0, -1)
+            .concat(midOutputFolder)
+            .join('/');
+        await TestAdapter.testBuildPass(outputPath, finalOutputPath, {
+            md2md: false,
+            md2html: true,
+        });
+        await compareDirectories(finalOutputPath, true);
+        await cleanupDirectory(outputPath);
+        await cleanupDirectory(finalOutputPath);
+    });
+};
+describe('Pdf page mode', () => {
+    generateMapTestTemplate(
+        'creates a pdf folder when the --pdf flag is specified',
+        'mocks/pdf-page/flag-enabled',
+        '-j2 --pdf',
+    );
+    generateMapTestTemplate(
+        'creates a pdf folder when the .yfm option is specified',
+        'mocks/pdf-page/yfm-config',
+        '-j2',
+    );
+    generateMapTestTemplate(
+        'creates pdf-page.json for each standalone toc',
+        'mocks/pdf-page/multiple-tocs',
+        '--pdf',
+        '',
+        true,
+    );
+});
+describe('Pdf page with titles', () => {
+    generateMapTestTemplate(
+        'Generates content for pdf genrator with title pages',
+        'mocks/pdf-page/title-pages',
+        '--pdf',
+    );
+    generateMapTestTemplate(
+        'Generates pdf title pages as regular entries for debug purpose',
+        'mocks/pdf-page/title-pages',
+        '--pdf-debug',
+        '',
+        true,
+    );
+});
+describe('Pdf generation with md2md phase, only files structure', () => {
+    generateMd2mdTestTemplate(
+        'Generates md2md content, then uses it for md2html render with pdf when .yfm options is specified',
+        'mocks/pdf-page/title-pages',
+    );
+});
+describe('Pdf page with custom icon', () => {
+    test('md2md copies custom pdf icon asset to output', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/pdf-page/custom-pdf-icon');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: '--allow-custom-resources',
+        });
+        await compareDirectories(outputPath, true);
+        await cleanupDirectory(outputPath);
+    });
+    test('md2html copies all files and produces correct pdfIconConfig in __DATA__', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/pdf-page/custom-pdf-icon');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: false,
+            md2html: true,
+        });
+        await compareDirectories(outputPath);
+        await cleanupDirectory(outputPath);
+    });
+});

package/tests/e2e/plugin-corner-cases.spec.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import {describe, it} from 'vitest';
+import {TestAdapter, compareDirectories, getTestPaths} from '../fixtures';
+describe('plugin corner cases:', () => {
+    it('images in deflists — integrity check', async () => {
+        const {inputPath, outputPath} = getTestPaths(
+            'mocks/plugin-corner-cases/images-in-deflists',
+        );
+        await TestAdapter.testBuildPass(inputPath, outputPath, {md2md: true, md2html: false});
+        await compareDirectories(outputPath);
+    });
+});

package/tests/e2e/preprocess.test.ts ADDED Viewed

@@ -0,0 +1,40 @@
+import {describe, test} from 'vitest';
+import {TestAdapter, compareDirectories, getTestPaths} from '../fixtures';
+const generateFilesYamlTestTemplate = (
+    testTitle: string,
+    testRootPath: string,
+    args: string[] = [],
+) => {
+    test(testTitle, async () => {
+        const {inputPath, outputPath} = getTestPaths(testRootPath);
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: args.concat(['--keep-not-var', '--id-generator', 'deterministic']).join(' '),
+        });
+        await TestAdapter.testBuildPass(outputPath, outputPath + '-html', {
+            md2md: false,
+            md2html: true,
+            args: args.concat(['--id-generator', 'deterministic']).join(' '),
+        });
+        await compareDirectories(outputPath);
+    });
+};
+describe('Preprocess', () => {
+    generateFilesYamlTestTemplate('HashIncludes=true,Autotitles=false', 'mocks/preprocess', [
+        '--no-merge-autotitles',
+    ]);
+    generateFilesYamlTestTemplate('HashIncludes=true,Autotitles=true', 'mocks/preprocess');
+    generateFilesYamlTestTemplate(
+        'HashIncludes=true,Autotitles=true,Svg=true',
+        'mocks/preprocess',
+        ['--merge-svg'],
+    );
+    // generateFilesYamlTestTemplate('Nested toc restricted access', 'mocks/preprocess/test3');
+});

package/tests/e2e/redirects-validation.spec.ts ADDED Viewed

@@ -0,0 +1,62 @@
+import {describe, expect, it} from 'vitest';
+import {TestAdapter, getTestPaths} from '../fixtures';
+describe('Redirects validation', () => {
+    it('should emit an error on an unparseable redirects.yaml', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/redirects-validation/unparseable');
+        const report = await TestAdapter.build.run(inputPath, outputPath, ['-f', 'md']);
+        expect(report.code).toBe(1);
+        expect(report.errors).toContainEqual(expect.stringMatching(/redirects.yaml parsing error/));
+    });
+    it.skip('should emit a warning when supplied with a `redirects.yaml` that mentions file extensions', async () => {
+        const {inputPath, outputPath} = getTestPaths(
+            'mocks/redirects-validation/extensions-deprecation',
+        );
+        const report = await TestAdapter.build.run(inputPath, outputPath, ['-f', 'md']);
+        expect(report.code).toBe(0);
+        expect(report.warns).toContainEqual(
+            expect.stringMatching(/Redirects with explicit extensions are deprecated./),
+        );
+    });
+    it('should emit an error when an invalid regular expression pattern is encountered', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/redirects-validation/invalid-regex');
+        const report = await TestAdapter.build.run(inputPath, outputPath, ['-f', 'md']);
+        expect(report.code).toBe(1);
+        expect(report.errors).toContainEqual(
+            expect.stringMatching(
+                /Redirects configuration results in a non-valid regular expression/,
+            ),
+        );
+    });
+    it('should emit an error when a redirect is malformed', async () => {
+        const {inputPath, outputPath} = getTestPaths(
+            'mocks/redirects-validation/malformed-redirect',
+        );
+        const report = await TestAdapter.build.run(inputPath, outputPath, ['-f', 'md']);
+        expect(report.code).toBe(1);
+        expect(report.errors).toContainEqual(
+            expect.stringMatching(/One of the two parameters is missing/),
+        );
+    });
+    it('should emit an error when a redirect leads to the same path', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/redirects-validation/same-path');
+        const report = await TestAdapter.build.run(inputPath, outputPath, ['-f', 'md']);
+        expect(report.code).toBe(1);
+        expect(report.errors).toContainEqual(expect.stringMatching(/Parameters must be different/));
+    });
+});

package/tests/e2e/regression.test.ts ADDED Viewed

@@ -0,0 +1,39 @@
+import {describe, it} from 'vitest';
+import {dedent} from 'ts-dedent';
+import {TestAdapter, compareDirectories, getTestPaths} from '../fixtures';
+function test(_description: string) {
+    it('internal', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/regression');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: true,
+            md2html: false,
+            args: '-j2 --keep-not-var --add-system-meta --id-generator deterministic',
+        });
+        await TestAdapter.testBuildPass(outputPath, outputPath + '-html', {
+            md2md: false,
+            md2html: true,
+            args: '-j2 --id-generator deterministic',
+        });
+        await TestAdapter.testBuildPass(outputPath, outputPath + '-static-html', {
+            md2md: false,
+            md2html: true,
+            args: '-j2 --static-content --id-generator deterministic',
+        });
+        await compareDirectories(outputPath);
+        await compareDirectories(outputPath + '-html');
+        // await compareDirectories(outputPath + '-static-html');
+    });
+}
+describe('Regression', {timeout: 90_000}, () => {
+    test(dedent`
+        - not_var liquid syntax
+        - normalize leading hrefs
+        - empty href in toc item
+        - term inside superscript: ^[?](*term)^
+        - term inside link text: [[?](*term)](url)
+    `);
+});

package/tests/e2e/restricted-access.test.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import {describe, test} from 'vitest';
+import {TestAdapter, compareDirectories, getTestPaths} from '../fixtures';
+const generateFilesYamlTestTemplate = (testTitle: string, testRootPath: string) => {
+    test(testTitle, async () => {
+        const {inputPath, outputPath} = getTestPaths(testRootPath);
+        await TestAdapter.testBuildPass(inputPath, outputPath, {md2md: true});
+        await compareDirectories(outputPath);
+    });
+};
+describe('Restricted access', () => {
+    generateFilesYamlTestTemplate('Simple restricted access', 'mocks/restricted-access/test1');
+    generateFilesYamlTestTemplate('Nested restricted access', 'mocks/restricted-access/test2');
+    generateFilesYamlTestTemplate('Nested toc restricted access', 'mocks/restricted-access/test3');
+});

package/tests/e2e/rtl.spec.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import {describe} from 'vitest';
+import {generateMapTestTemplate} from '../fixtures';
+describe('Generate html document with correct lang and dir attributes. Load correct bundles.', () => {
+    generateMapTestTemplate(
+        'documentation with rtl and ltr langs',
+        'mocks/rtl/multidirectional-languages',
+        {md2html: true, md2md: false, args: '--allow-custom-resources'},
+    );
+    generateMapTestTemplate('documentation with only one rtl lang', 'mocks/rtl/rtl-language', {
+        md2html: true,
+        md2md: false,
+        args: '--allow-custom-resources',
+    });
+});

package/tests/e2e/search.test.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import {describe, it} from 'vitest';
+import {TestAdapter, compareDirectories, getTestPaths} from '../fixtures';
+describe('Local search', () => {
+    it('internal', async () => {
+        const {inputPath, outputPath} = getTestPaths('mocks/search');
+        await TestAdapter.testBuildPass(inputPath, outputPath, {
+            md2md: false,
+            md2html: true,
+            args: '-j2 --search --interface-toc',
+        });
+        await compareDirectories(outputPath);
+    });
+});

package/tests/e2e/single-page.spec.ts ADDED Viewed

@@ -0,0 +1,23 @@
+import {describe, test} from 'vitest';
+import {TestAdapter, compareDirectories, getTestPaths} from '../fixtures';
+const generateMapTestSinglePageTemplate = (
+    testTitle: string,
+    testRootPath: string,
+    {md2md = true, md2html = true, args = '--single-page'},
+) => {
+    test(testTitle, async () => {
+        const {inputPath, outputPath} = getTestPaths(testRootPath);
+        await TestAdapter.testBuildPass(inputPath, outputPath, {md2md, md2html, args});
+        await compareDirectories(outputPath);
+    });
+};
+describe('Single page mode', () => {
+    generateMapTestSinglePageTemplate(
+        'simple md2html single page with lang dirs',
+        'mocks/single-page',
+        {md2md: false},
+    );
+});

package/tests/e2e/skip-html-extension.spec.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import {describe} from 'vitest';
+import {generateMapTestTemplate} from '../fixtures';
+describe('Skip html extension', () => {
+    generateMapTestTemplate(
+        'correctly trims .html and index.html on multilingual docs',
+        'mocks/skip-html-extension/multilingual',
+        {md2md: false, md2html: true, args: '-j2 --skip-html-extension'},
+    );
+    generateMapTestTemplate(
+        'correctly trims .html and index.html on monolingual docs',
+        'mocks/skip-html-extension/monolingual',
+        {md2md: false, md2html: true, args: '-j2 --skip-html-extension'},
+    );
+});