@ng-doc/builder 22.0.0-beta.2 → 22.1.0

package/schematics/migrate-to-vite/legacy-folder.d.ts

@@ -0,0 +1,84 @@
+import { Tree } from '@angular-devkit/schematics';
+import { MigrationFinding } from './analyze';
+import { JsonLike, WorkspaceProject, WorkspaceTarget } from './setup/workspace';
+/**
+ * The `outDir` of the kept legacy targets. The legacy engine writes `<outDir>/ng-doc/<project>`, so
+ * their generated folder is `ng-doc-legacy/ng-doc/<project>`, as for NgDoc's own site.
+ */
+export declare const LEGACY_OUT_DIR = "ng-doc-legacy";
+/** The `.gitignore` line for the legacy targets' generated files. */
+export declare const LEGACY_OUT_DIR_IGNORE = "/ng-doc-legacy";
+/** One value of a kept legacy target that the migration changed, so it can be changed back. */
+export interface LegacyTargetEdit {
+    /** The legacy target, such as `build-legacy`. */
+    target: string;
+    /** The JSON path of the value inside the target, such as `['options', 'tsConfig']`. */
+    path: string[];
+    /** The value before the migration; absent when the migration added it. */
+    before?: JsonLike;
+    after: JsonLike;
+}
+/** How the kept legacy targets get a generated folder of their own. */
+export interface LegacyFolderPlan {
+    /** Their generated folder, workspace-relative. */
+    folder: string;
+    /** The files to create (the legacy NgDoc configuration and tsconfig files), by path. */
+    files: {
+        [file: string]: string;
+    };
+    edits: LegacyTargetEdit[];
+    findings: MigrationFinding[];
+}
+/** What `planLegacyFolder` needs to know about the migration. */
+export interface LegacyFolderInput {
+    /** The project before the migration, with its original targets. */
+    project: WorkspaceProject;
+    /** The original build target, and the name it is kept under. */
+    build: {
+        name: string;
+        legacyName: string;
+    };
+    /** The original serve target, and the name it is kept under. */
+    serve?: {
+        name: string;
+        legacyName: string;
+    };
+    /** The folder the legacy engine wrote before the migration, which the Vite engine now owns. */
+    legacyOutput: string;
+    /** The NgDoc configuration the legacy build target loads, if any. */
+    ngDocConfig?: string;
+    /** Files a previous run of the migration created, which may be written again. */
+    owned: ReadonlySet<string>;
+}
+/**
+ * Plans a generated folder of their own for the legacy targets that the migration keeps.
+ *
+ * Both engines write `<outDir>/ng-doc/<project>` by default. The Vite engine refuses to overwrite
+ * files it didn't write (`OUTPUT_UNOWNED_COLLISION`), and the legacy engine deletes and rewrites
+ * its folder, so a single `build-legacy` run would stop the next `serve`. The legacy targets
+ * therefore load a small NgDoc configuration with `outDir: 'ng-doc-legacy'`, compile with a
+ * tsconfig that maps `@ng-doc/generated` there, and copy their generated assets from there. The
+ * Vite engine keeps the folder and the mappings the project already has. Returns only findings
+ * when the targets can't be changed safely, and they keep sharing the folder.
+ * @param tree - The workspace tree.
+ * @param input - The migration.
+ */
+export declare function planLegacyFolder(tree: Tree, input: LegacyFolderInput): LegacyFolderPlan;
+/**
+ * Applies the edits of one legacy target.
+ * @param target - The target.
+ * @param name - The name the target is kept under.
+ * @param edits - Every edit of the migration.
+ */
+export declare function applyLegacyEdits(target: WorkspaceTarget, name: string, edits: readonly LegacyTargetEdit[]): WorkspaceTarget;
+/**
+ * Changes back the edits of one legacy target whose value is still the one the migration wrote.
+ * @param target - The target.
+ * @param name - The name the target is kept under.
+ * @param edits - Every edit of the migration.
+ * @returns The target, and the paths of the values that were changed since and are kept.
+ */
+export declare function undoLegacyEdits(target: WorkspaceTarget, name: string, edits: readonly LegacyTargetEdit[]): {
+    target: WorkspaceTarget;
+    kept: string[];
+};

package/schematics/migrate-to-vite/legacy-folder.js

@@ -0,0 +1,340 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_OUT_DIR_IGNORE = exports.LEGACY_OUT_DIR = void 0;
+exports.planLegacyFolder = planLegacyFolder;
+exports.applyLegacyEdits = applyLegacyEdits;
+exports.undoLegacyEdits = undoLegacyEdits;
+const path_1 = require("path");
+const json_file_1 = require("./setup/json-file");
+/**
+ * The `outDir` of the kept legacy targets. The legacy engine writes `<outDir>/ng-doc/<project>`, so
+ * their generated folder is `ng-doc-legacy/ng-doc/<project>`, as for NgDoc's own site.
+ */
+exports.LEGACY_OUT_DIR = 'ng-doc-legacy';
+/** The `.gitignore` line for the legacy targets' generated files. */
+exports.LEGACY_OUT_DIR_IGNORE = `/${exports.LEGACY_OUT_DIR}`;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalizePath(value) {
+    const normalized = path_1.posix.normalize(value.replace(/\\/g, '/')).replace(/^\.\/|\/$/g, '');
+    return normalized === '.' ? '' : normalized;
+}
+/** A path relative to a folder, in the `./` form tsconfig `paths` need without a `baseUrl`. */
+function relativeTo(folder, file) {
+    const relative = path_1.posix.relative(folder || '.', file) || '.';
+    return relative.startsWith('.') ? relative : `./${relative}`;
+}
+function within(file, folder) {
+    return file === folder || file.startsWith(`${folder}/`);
+}
+function readCompilerPaths(tree, file) {
+    const seen = new Set();
+    let paths;
+    let baseUrl;
+    let current = file;
+    while (current && !seen.has(current) && (!paths || baseUrl === undefined)) {
+        if (!tree.exists(current) && tree.exists(`${current}.json`))
+            current = `${current}.json`;
+        if (!tree.exists(current))
+            break;
+        seen.add(current);
+        const json = new json_file_1.JsonFile(tree, current);
+        const value = json.get(['compilerOptions', 'paths']);
+        if (!paths && isRecord(value)) {
+            paths = { file: current, value: value };
+        }
+        const url = json.get(['compilerOptions', 'baseUrl']);
+        if (baseUrl === undefined && typeof url === 'string') {
+            baseUrl = normalizePath(path_1.posix.join(path_1.posix.dirname(current), url));
+        }
+        const extended = json.get(['extends']);
+        // Only a relative `extends` can hold the project's own mappings; a package's tsconfig doesn't.
+        current =
+            typeof extended === 'string' && extended.startsWith('.')
+                ? normalizePath(path_1.posix.join(path_1.posix.dirname(current), extended))
+                : undefined;
+    }
+    if (!paths)
+        return undefined;
+    return {
+        paths: paths.value,
+        base: baseUrl ?? normalizePath(path_1.posix.dirname(paths.file)),
+        baseUrl: baseUrl !== undefined,
+    };
+}
+/**
+ * The `paths` of a tsconfig for the legacy targets: every mapping into the legacy engine's old
+ * folder points into its new one, and the other mappings stay as they resolve today. TypeScript
+ * replaces `paths` as a whole, so the file repeats every mapping. Returns undefined when no
+ * mapping points into the old folder: the legacy build would not import its own pages then.
+ */
+function legacyPaths(compiler, folder, from, to) {
+    // Without an inherited `baseUrl`, the new file's own folder resolves the entries it writes.
+    const base = compiler.baseUrl ? compiler.base : folder;
+    let moved = false;
+    const paths = Object.fromEntries(Object.entries(compiler.paths).map(([alias, entries]) => [
+        alias,
+        (Array.isArray(entries) ? entries : []).map((entry) => {
+            if (typeof entry !== 'string')
+                return entry;
+            const resolved = normalizePath(path_1.posix.join(compiler.base, entry));
+            if (within(resolved, from)) {
+                moved = true;
+                const next = path_1.posix.join(to, path_1.posix.relative(from, resolved));
+                return compiler.baseUrl ? path_1.posix.relative(base || '.', next) : relativeTo(base, next);
+            }
+            return compiler.baseUrl ? entry : relativeTo(base, resolved);
+        }),
+    ]));
+    return moved ? paths : undefined;
+}
+/** `tsconfig.app.json` → `tsconfig.app.legacy.json`, keeping the folder and any Nx tokens. */
+function legacyName(file, extension) {
+    const match = /\.(json|ts|js|mjs|cjs|mts|cts)$/.exec(file);
+    return `${match ? file.slice(0, -match[0].length) : file}.legacy${extension}`;
+}
+function legacyConfigText(source, file) {
+    const header = [
+        '// The NgDoc configuration of the legacy builders (`build-legacy`, `serve-legacy`), created by',
+        `// \`ng g @ng-doc/builder:migrate-to-vite\`. Their generated files go to \`${exports.LEGACY_OUT_DIR}/\`, so`,
+        "// they never share a folder with the Vite engine, which refuses files it didn't write.",
+        "import type { NgDocConfiguration } from '@ng-doc/builder';",
+        '',
+    ];
+    if (!source) {
+        return [
+            ...header,
+            `const legacyConfig: NgDocConfiguration = { outDir: '${exports.LEGACY_OUT_DIR}' };`,
+            '',
+            'export default legacyConfig;',
+            '',
+        ].join('\n');
+    }
+    const specifier = relativeTo(path_1.posix.dirname(file), source.replace(/\.(ts|js|mjs|cjs|mts|cts)$/, ''));
+    return [
+        ...header,
+        `import config from '${specifier}';`,
+        '',
+        `const legacyConfig: NgDocConfiguration = { ...config, outDir: '${exports.LEGACY_OUT_DIR}' };`,
+        '',
+        'export default legacyConfig;',
+        '',
+    ].join('\n');
+}
+function legacyTsconfigText(extended, paths) {
+    const body = JSON.stringify({ extends: `./${extended}`, compilerOptions: { paths } }, null, 2);
+    return [
+        '/* The tsconfig of the legacy builders (`build-legacy`, `serve-legacy`), created by',
+        '   `ng g @ng-doc/builder:migrate-to-vite`. It maps `@ng-doc/generated` to their own',
+        `   generated folder in \`${exports.LEGACY_OUT_DIR}/\`. */`,
+        body,
+        '',
+    ].join('\n');
+}
+/**
+ * Plans a generated folder of their own for the legacy targets that the migration keeps.
+ *
+ * Both engines write `<outDir>/ng-doc/<project>` by default. The Vite engine refuses to overwrite
+ * files it didn't write (`OUTPUT_UNOWNED_COLLISION`), and the legacy engine deletes and rewrites
+ * its folder, so a single `build-legacy` run would stop the next `serve`. The legacy targets
+ * therefore load a small NgDoc configuration with `outDir: 'ng-doc-legacy'`, compile with a
+ * tsconfig that maps `@ng-doc/generated` there, and copy their generated assets from there. The
+ * Vite engine keeps the folder and the mappings the project already has. Returns only findings
+ * when the targets can't be changed safely, and they keep sharing the folder.
+ * @param tree - The workspace tree.
+ * @param input - The migration.
+ */
+function planLegacyFolder(tree, input) {
+    const { project, legacyOutput, owned } = input;
+    const folder = path_1.posix.join(exports.LEGACY_OUT_DIR, 'ng-doc', project.name);
+    const build = project.targets[input.build.name];
+    const serve = input.serve ? project.targets[input.serve.name] : undefined;
+    const findings = [];
+    const shared = (subject, reason) => ({
+        folder,
+        files: {},
+        edits: [],
+        findings: [
+            {
+                level: 'manual',
+                subject,
+                message: `${reason} The legacy targets keep writing \`${legacyOutput}\`, the Vite engine's ` +
+                    `folder: delete it before you switch engines, or give the legacy targets their own ` +
+                    `folder (\`outDir: '${exports.LEGACY_OUT_DIR}'\` in their NgDoc configuration, with ` +
+                    '`@ng-doc/generated` and the generated assets entry pointing there).',
+            },
+        ],
+    });
+    // Nx interpolates these in options; the files are read at the resolved paths.
+    const nx = (value) => normalizePath(value
+        .replace(/\{workspaceRoot\}\/?/g, '')
+        .replace(/\{projectRoot\}/g, project.root || '.')
+        .replace(/\{projectName\}/g, project.name));
+    if (folder === legacyOutput) {
+        // The Vite engine follows the configuration's `outDir` too, so it already writes this folder.
+        return shared('ngDoc.outDir', `is \`${exports.LEGACY_OUT_DIR}\`, the folder the legacy targets would get.`);
+    }
+    const files = {};
+    const edits = [];
+    const create = (file, text) => {
+        if (tree.exists(file) && !owned.has(file))
+            return false;
+        files[file] = text;
+        return true;
+    };
+    const edit = (target, path, before, after) => {
+        edits.push({ target, path, ...(before === undefined ? {} : { before }), after });
+    };
+    // The NgDoc configuration: the build target's, with the legacy `outDir` over it.
+    const serveConfig = isRecord(serve?.options?.['ngDoc'])
+        ? serve.options['ngDoc']['config']
+        : undefined;
+    if (typeof serveConfig === 'string' && normalizePath(serveConfig) !== input.ngDocConfig) {
+        return shared(`${input.serve.legacyName}.ngDoc.config`, `names \`${serveConfig}\`, another NgDoc configuration than the build target's.`);
+    }
+    const source = input.ngDocConfig;
+    // Next to the project's configuration, or in the project folder when that configuration lies
+    // outside it (shared by several projects, which each get their own legacy configuration).
+    const configFile = source && (!project.root || within(path_1.posix.dirname(source), project.root))
+        ? legacyName(source, '.ts')
+        : path_1.posix.join(project.root, 'ng-doc.config.legacy.ts');
+    if (!create(configFile, legacyConfigText(source, configFile))) {
+        return shared(configFile, 'already exists.');
+    }
+    // tsconfig files: one per `tsConfig` value of the build target, each extending the original.
+    const tsConfigs = [];
+    if (typeof build.options?.['tsConfig'] === 'string') {
+        tsConfigs.push({ path: ['options', 'tsConfig'], value: build.options['tsConfig'] });
+    }
+    for (const [name, configuration] of Object.entries(build.configurations ?? {})) {
+        if (typeof configuration?.['tsConfig'] === 'string') {
+            tsConfigs.push({
+                path: ['configurations', name, 'tsConfig'],
+                value: configuration['tsConfig'],
+            });
+        }
+    }
+    if (!tsConfigs.length) {
+        return shared(`${input.build.legacyName}.tsConfig`, 'is not set.');
+    }
+    for (const { path, value } of tsConfigs) {
+        const file = nx(value);
+        const compiler = readCompilerPaths(tree, file);
+        const paths = compiler && legacyPaths(compiler, path_1.posix.dirname(file), legacyOutput, folder);
+        if (!paths) {
+            return shared(`${input.build.legacyName}.tsConfig`, `\`${file}\` maps no path into \`${legacyOutput}\`, so the schematic can't point ` +
+                '`@ng-doc/generated` of the legacy targets at another folder.');
+        }
+        const legacyFile = legacyName(file, '.json');
+        if (!create(legacyFile, legacyTsconfigText(path_1.posix.basename(file), paths))) {
+            return shared(legacyFile, 'already exists.');
+        }
+        edit(input.build.legacyName, path, value, legacyName(value, '.json'));
+    }
+    // The generated assets entry, in the options and in every configuration that sets `assets`.
+    const assetsOf = (path, value) => {
+        if (!Array.isArray(value))
+            return;
+        let moved = false;
+        const next = value.map((entry) => {
+            if (!isRecord(entry) || typeof entry['input'] !== 'string')
+                return entry;
+            const input = nx(entry['input']);
+            if (!within(input, legacyOutput))
+                return entry;
+            moved = true;
+            return { ...entry, input: path_1.posix.join(folder, path_1.posix.relative(legacyOutput, input)) };
+        });
+        if (moved)
+            edit(input.build.legacyName, path, value, next);
+    };
+    assetsOf(['options', 'assets'], build.options?.['assets']);
+    for (const [name, configuration] of Object.entries(build.configurations ?? {})) {
+        assetsOf(['configurations', name, 'assets'], configuration?.['assets']);
+    }
+    // Both legacy builders load the configuration named in their own options.
+    const withConfig = (name, target) => {
+        if (!target.options) {
+            edit(name, ['options'], undefined, { ngDoc: { config: configFile } });
+            return;
+        }
+        const ngDoc = isRecord(target.options['ngDoc']) ? target.options['ngDoc'] : undefined;
+        edit(name, ['options', 'ngDoc'], ngDoc, { ...(ngDoc ?? {}), config: configFile });
+    };
+    withConfig(input.build.legacyName, build);
+    if (serve && input.serve)
+        withConfig(input.serve.legacyName, serve);
+    for (const [legacy, target] of [
+        [input.build.legacyName, build],
+        ...(serve && input.serve ? [[input.serve.legacyName, serve]] : []),
+    ]) {
+        for (const [name, configuration] of Object.entries(target.configurations ?? {})) {
+            if (configuration?.['ngDoc'] === undefined)
+                continue;
+            findings.push({
+                level: 'manual',
+                subject: `${legacy}.configurations.${name}.ngDoc`,
+                message: `replaces the NgDoc configuration of the legacy targets. Set \`outDir: '${exports.LEGACY_OUT_DIR}'\` ` +
+                    `in it, so that configuration writes \`${folder}\` too.`,
+            });
+        }
+    }
+    return { folder, files, edits, findings };
+}
+function valueAt(target, path) {
+    let current = target;
+    for (const key of path) {
+        if (!isRecord(current))
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+function withValue(target, path, value) {
+    const set = (record, [key, ...rest]) => {
+        const next = { ...record };
+        if (rest.length) {
+            next[key] = set(isRecord(record[key]) ? record[key] : {}, rest);
+        }
+        else if (value === undefined) {
+            delete next[key];
+        }
+        else {
+            next[key] = value;
+        }
+        return next;
+    };
+    return set(target, path);
+}
+/**
+ * Applies the edits of one legacy target.
+ * @param target - The target.
+ * @param name - The name the target is kept under.
+ * @param edits - Every edit of the migration.
+ */
+function applyLegacyEdits(target, name, edits) {
+    return edits
+        .filter((item) => item.target === name)
+        .reduce((current, item) => withValue(current, item.path, item.after), target);
+}
+/**
+ * Changes back the edits of one legacy target whose value is still the one the migration wrote.
+ * @param target - The target.
+ * @param name - The name the target is kept under.
+ * @param edits - Every edit of the migration.
+ * @returns The target, and the paths of the values that were changed since and are kept.
+ */
+function undoLegacyEdits(target, name, edits) {
+    const kept = [];
+    let current = target;
+    for (const item of edits.filter((edit) => edit.target === name)) {
+        if (JSON.stringify(valueAt(current, item.path)) !== JSON.stringify(item.after)) {
+            kept.push(`${name}.${item.path.join('.')}`);
+            continue;
+        }
+        current = withValue(current, item.path, item.before);
+    }
+    return { target: current, kept };
+}
+//# sourceMappingURL=legacy-folder.js.map

package/schematics/migrate-to-vite/legacy-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-folder.js","sourceRoot":"","sources":["../../../../../libs/builder/schematics/migrate-to-vite/legacy-folder.ts"],"names":[],"mappings":"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"}

package/schematics/migrate-to-vite/report.d.ts

@@ -0,0 +1,32 @@
+import { MigrationFinding } from './analyze';
+import { DependencyMismatch } from './setup/dependencies';
+/** Everything the report describes besides the findings. */
+export interface ReportInput {
+    project: string;
+    findings: MigrationFinding[];
+    configFile?: string;
+    targets?: {
+        [name: string]: string;
+    };
+    created?: string[];
+    /** The project's own Vite configurations that NgDoc's configuration sits next to. */
+    keptViteConfigs?: string[];
+    modified?: string[];
+    deleted?: string;
+    /** The generated folder the Vite engine writes. */
+    generatedFolder?: string;
+    /** The generated folder of the kept legacy targets, when they got one of their own. */
+    legacyFolder?: {
+        folder: string;
+        targets: string[];
+    };
+    dependencies?: {
+        [name: string]: string;
+    };
+    mismatches?: DependencyMismatch[];
+}
+/**
+ * Renders the migration report as Markdown. It depends only on its input, never on the time or on
+ * what an earlier run did, so running the migration again rewrites the same report.
+ */
+export declare function renderReport(input: ReportInput): string;

package/schematics/migrate-to-vite/report.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderReport = renderReport;
+const dependencies_1 = require("./setup/dependencies");
+const SECTIONS = [
+    {
+        level: 'blocking',
+        title: 'Blocking',
+        intro: 'The project was not migrated, and nothing was changed. Resolve these first:',
+    },
+    {
+        level: 'manual',
+        title: 'Needs a manual change',
+        intro: 'These were not migrated. The site can behave differently until you handle them:',
+    },
+    {
+        level: 'migrated',
+        title: 'Migrated',
+        intro: 'These options and settings moved to the Vite configuration or the new targets:',
+    },
+    {
+        level: 'dropped',
+        title: 'Dropped',
+        intro: 'These have no effect under Vite, or Vite already behaves this way:',
+    },
+];
+function unique(findings) {
+    const seen = new Set();
+    return findings.filter((finding) => {
+        const key = `${finding.level}\u0000${finding.subject}\u0000${finding.message}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * Renders the migration report as Markdown. It depends only on its input, never on the time or on
+ * what an earlier run did, so running the migration again rewrites the same report.
+ */
+function renderReport(input) {
+    const findings = unique(input.findings);
+    const blocked = findings.some((finding) => finding.level === 'blocking');
+    const lines = [`# NgDoc migration to the Vite engine: ${input.project}`, ''];
+    if (!blocked) {
+        lines.push('## Changes', '');
+        for (const [name, legacy] of Object.entries(input.targets ?? {})) {
+            lines.push(`- Target \`${name}\` runs the Vite engine; the original is kept as \`${legacy}\`.`);
+        }
+        for (const file of input.created ?? [])
+            lines.push(`- Created \`${file}\`.`);
+        if (input.keptViteConfigs?.length && input.configFile) {
+            lines.push(`- ${input.keptViteConfigs.map((file) => `\`${file}\``).join(', ')} stays the ` +
+                'configuration of Vite and Vitest run directly; NgDoc uses ' +
+                `\`${input.configFile}\`, which the Vite targets name in \`configFile\`.`);
+        }
+        for (const file of input.modified ?? [])
+            lines.push(`- Changed \`${file}\`.`);
+        if (input.deleted) {
+            lines.push(`- Deleted the legacy generated folder \`${input.deleted}\`; the Vite engine writes it again.`);
+        }
+        if (input.legacyFolder) {
+            lines.push(`- ${input.legacyFolder.targets.map((name) => `\`${name}\``).join(' and ')} write their ` +
+                `generated files to \`${input.legacyFolder.folder}\` (added to \`.gitignore\`), so the ` +
+                'legacy builders and the Vite engine never share a generated folder.');
+        }
+        for (const [name, version] of Object.entries(input.dependencies ?? {})) {
+            lines.push(`- Added \`${name}@${version}\` to \`devDependencies\`.`);
+        }
+        for (const mismatch of input.mismatches ?? []) {
+            lines.push(`- ${(0, dependencies_1.dependencyMismatchText)(mismatch)}`);
+        }
+        lines.push('');
+    }
+    for (const section of SECTIONS) {
+        const items = findings.filter((finding) => finding.level === section.level);
+        if (!items.length)
+            continue;
+        lines.push(`## ${section.title}`, '', section.intro, '');
+        for (const finding of items)
+            lines.push(`- \`${finding.subject}\`: ${finding.message}`);
+        lines.push('');
+    }
+    if (!blocked) {
+        lines.push('## Next steps', '', '1. Install the dependencies if the schematic did not (`npm install`).', '2. Run `ng serve` and `ng build`, and compare the pages with the legacy build (`ng run ' +
+            `${input.project}:build-legacy\`).`, input.legacyFolder
+            ? `3. The Vite targets write \`${input.generatedFolder ?? `ng-doc/${input.project}`}\` and ` +
+                `the \`-legacy\` targets \`${input.legacyFolder.folder}\`, so you can switch between ` +
+                'them without deleting anything.'
+            : `3. Both engines write \`${input.generatedFolder ?? `ng-doc/${input.project}`}\`. ` +
+                'Delete it whenever you switch between the `-legacy` targets and the Vite targets: ' +
+                "the Vite engine refuses files it didn't write (`OUTPUT_UNOWNED_COLLISION`), and the " +
+                "legacy engine replaces the Vite engine's files.", '4. Commit the changes, including this folder if you want to keep `--revert` available.', '', '## Roll back', '', `Run \`ng g @ng-doc/builder:migrate-to-vite --project ${input.project} --revert\`. It restores the`, 'original targets and the changed files, and deletes the files it created unless you edited', 'them. It keeps the added dependencies. Your version control remains the primary way back.', '');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/schematics/migrate-to-vite/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../../../libs/builder/schematics/migrate-to-vite/report.ts"],"names":[],"mappings":"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"}

package/schematics/migrate-to-vite/schema.d.ts

@@ -0,0 +1,13 @@
+/** The options of `ng g @ng-doc/builder:migrate-to-vite`. */
+export interface NgDocMigrateToViteSchema {
+    /** The project to migrate (default: the only project on the legacy builders). */
+    project?: string;
+    /** Undo an earlier migration of the project. */
+    revert?: boolean;
+    /** The Vite configuration file to create, workspace-relative. */
+    viteConfig?: string;
+    /** The root component's file, workspace-relative. */
+    rootComponent?: string;
+    /** Do not install the added dependencies. */
+    skipInstall?: boolean;
+}

package/schematics/migrate-to-vite/schema.js

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

package/schematics/migrate-to-vite/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../libs/builder/schematics/migrate-to-vite/schema.ts"],"names":[],"mappings":""}

package/schematics/migrate-to-vite/schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "NgDocMigrateToVite",
+  "title": "Migrate an NgDoc project to the Vite engine",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The project to migrate. Defaults to the only project that builds with @ng-doc/builder:application."
+    },
+    "revert": {
+      "type": "boolean",
+      "default": false,
+      "description": "Undo an earlier migration of the project: restore its original targets and changed files, and delete the files the migration created."
+    },
+    "viteConfig": {
+      "type": "string",
+      "description": "The Vite configuration file to create, relative to the workspace root. Defaults to vite.config.mjs in the project root."
+    },
+    "rootComponent": {
+      "type": "string",
+      "description": "The file of the application's root component, relative to the workspace root. Found from the browser entry by default."
+    },
+    "skipInstall": {
+      "type": "boolean",
+      "default": false,
+      "description": "Do not install the added dependencies."
+    }
+  },
+  "additionalProperties": false
+}