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

package/schematics/migrate-to-vite/setup/workspace.d.ts

@@ -0,0 +1,100 @@
+import { Tree } from '@angular-devkit/schematics';
+/** A JSON value as it appears in `angular.json` or `project.json`. */
+export type JsonLike = string | number | boolean | null | JsonLike[] | {
+    [key: string]: JsonLike | undefined;
+};
+/** A JSON object as it appears in `angular.json` or `project.json`. */
+export interface JsonRecord {
+    [key: string]: JsonLike | undefined;
+}
+/** One target of a project, with the key its builder is stored under (`builder` or `executor`). */
+export interface WorkspaceTarget extends JsonRecord {
+    builder?: string;
+    executor?: string;
+    options?: JsonRecord;
+    configurations?: {
+        [name: string]: JsonRecord | undefined;
+    };
+    defaultConfiguration?: string;
+}
+/**
+ * A project of an Angular CLI (`angular.json`) or Nx (`project.json`) workspace, read without the
+ * devkit workspace API so that both layouts, and Nx's `executor` key, are handled the same way.
+ */
+export interface WorkspaceProject {
+    name: string;
+    /** The project root, workspace-relative and POSIX (`''` for the workspace root). */
+    root: string;
+    /** The source root, workspace-relative and POSIX. */
+    sourceRoot: string;
+    /** `angular.json` or the project's `project.json`. */
+    file: string;
+    /** The JSON path of the project's target map inside `file`. */
+    targetsPath: string[];
+    targets: {
+        [name: string]: WorkspaceTarget | undefined;
+    };
+    /** The `i18n` block of the project, if any. */
+    i18n?: JsonLike;
+}
+/** The builder or executor of a target. */
+export declare function targetBuilder(target: WorkspaceTarget | undefined): string | undefined;
+/** The key a target stores its builder under: `builder` (angular.json) or `executor` (Nx). */
+export declare function builderKey(target: WorkspaceTarget): 'builder' | 'executor';
+/**
+ * Reads every project of the workspace.
+ *
+ * - An Angular CLI workspace (no `nx.json`): the projects of `angular.json`, or of the
+ *   `project.json` files when there is no `angular.json`.
+ * - An Nx workspace: the `project.json` files first, then the `angular.json` projects that no
+ *   `project.json` declares. Under `nx g`, Nx shows Angular devkit schematics a virtual
+ *   `angular.json` built from every `project.json`, and writing it makes Nx rewrite all of them
+ *   (reordered keys, its own layout, no final newline), including unrelated projects. Reading a
+ *   project from its own `project.json` keeps every write in that one file, as a text edit.
+ * @param tree - The workspace tree.
+ */
+export declare function readWorkspaceProjects(tree: Tree): WorkspaceProject[];
+/**
+ * The options a target runs with for a configuration: its `options` with the configuration's
+ * values over them (a shallow merge, as Architect does).
+ */
+export declare function resolveTargetOptions(target: WorkspaceTarget, configuration: string | undefined): JsonRecord;
+/** Parses `project:target[:configuration]`; an empty project means the current one. */
+export declare function parseTargetString(value: string): {
+    project: string;
+    target: string;
+    configuration?: string;
+} | undefined;
+/** A target with its `buildTarget` option set, or removed (with `options` when that empties it). */
+export declare function withBuildTarget(target: WorkspaceTarget, buildTarget: string | undefined): WorkspaceTarget;
+/**
+ * Writes a target as a whole, replacing an existing one. A new target is inserted right after
+ * the target named by `anchor`, or right before `anchor.before`, when that target exists, so a
+ * renamed target stays next to its replacement.
+ * @param tree - The workspace tree.
+ * @param project - The project.
+ * @param name - The target.
+ * @param value - The target, or undefined to remove it.
+ * @param anchor - The target to insert a new target after, or `{ before }` to insert it before.
+ */
+export declare function writeTarget(tree: Tree, project: WorkspaceProject, name: string, value: WorkspaceTarget | undefined, anchor?: string | {
+    before: string;
+}): void;
+/**
+ * Updates an existing target to a value with the smallest text edits: only the values that differ
+ * are written, so the rest of the target keeps the layout and key order of the user's file.
+ * Writes the whole target when it does not exist.
+ * @param tree - The workspace tree.
+ * @param project - The project.
+ * @param name - The target.
+ * @param value - The target as it should be.
+ */
+export declare function updateTarget(tree: Tree, project: WorkspaceProject, name: string, value: WorkspaceTarget): void;
+/**
+ * Renames a target by rewriting its key, so the target keeps its text and its place.
+ * @param tree - The workspace tree.
+ * @param project - The project.
+ * @param from - The current name.
+ * @param to - The new name, which no target may have.
+ */
+export declare function renameTarget(tree: Tree, project: WorkspaceProject, from: string, to: string): void;

package/schematics/migrate-to-vite/setup/workspace.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.targetBuilder = targetBuilder;
+exports.builderKey = builderKey;
+exports.readWorkspaceProjects = readWorkspaceProjects;
+exports.resolveTargetOptions = resolveTargetOptions;
+exports.parseTargetString = parseTargetString;
+exports.withBuildTarget = withBuildTarget;
+exports.writeTarget = writeTarget;
+exports.updateTarget = updateTarget;
+exports.renameTarget = renameTarget;
+const path_1 = require("path");
+const json_file_1 = require("./json-file");
+function normalize(value) {
+    const normalized = path_1.posix.normalize((value ?? '').replace(/\\/g, '/')).replace(/^\.\/?|\/$/g, '');
+    return normalized === '.' ? '' : normalized;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** The builder or executor of a target. */
+function targetBuilder(target) {
+    return target?.builder ?? target?.executor;
+}
+/** The key a target stores its builder under: `builder` (angular.json) or `executor` (Nx). */
+function builderKey(target) {
+    return target.executor !== undefined && target.builder === undefined ? 'executor' : 'builder';
+}
+function projectFromJson(name, value, file, basePath, fallbackRoot) {
+    const root = normalize(typeof value['root'] === 'string' ? value['root'] : fallbackRoot);
+    const targetsKey = isRecord(value['architect']) ? 'architect' : 'targets';
+    const targets = isRecord(value[targetsKey]) ? value[targetsKey] : {};
+    return {
+        name,
+        root,
+        sourceRoot: normalize(typeof value['sourceRoot'] === 'string' ? value['sourceRoot'] : path_1.posix.join(root, 'src')),
+        file,
+        targetsPath: [...basePath, targetsKey],
+        targets: targets,
+        ...(value['i18n'] === undefined ? {} : { i18n: value['i18n'] }),
+    };
+}
+function findProjectJsonFiles(tree) {
+    const found = [];
+    const visit = (directory) => {
+        const entry = tree.getDir(directory);
+        for (const file of entry.subfiles) {
+            if (file === 'project.json')
+                found.push(path_1.posix.join(directory, file).replace(/^\//, ''));
+        }
+        for (const sub of entry.subdirs) {
+            if (sub === 'node_modules' || sub.startsWith('.') || sub === 'dist')
+                continue;
+            visit(path_1.posix.join(directory, sub));
+        }
+    };
+    visit('/');
+    return found.sort();
+}
+/**
+ * The projects of `angular.json`, or none when there is no `angular.json`.
+ * @param tree - The workspace tree.
+ */
+function readAngularJsonProjects(tree) {
+    if (!tree.exists('angular.json'))
+        return [];
+    const projects = new json_file_1.JsonFile(tree, 'angular.json').get(['projects']);
+    if (!isRecord(projects))
+        return [];
+    return Object.entries(projects)
+        .filter((entry) => isRecord(entry[1]))
+        .map(([name, value]) => projectFromJson(name, value, 'angular.json', ['projects', name], ''));
+}
+/**
+ * The projects of the `project.json` files.
+ * @param tree - The workspace tree.
+ * @param namesByRoot - Project names by root, for a `project.json` without a `name`.
+ */
+function readProjectJsonProjects(tree, namesByRoot) {
+    return findProjectJsonFiles(tree).flatMap((file) => {
+        const value = new json_file_1.JsonFile(tree, file).get([]);
+        if (!isRecord(value))
+            return [];
+        const root = path_1.posix.dirname(file) === '.' ? '' : path_1.posix.dirname(file);
+        const name = typeof value['name'] === 'string'
+            ? value['name']
+            : namesByRoot.get(root) ?? path_1.posix.basename(root);
+        return [projectFromJson(name, value, file, [], root)];
+    });
+}
+/**
+ * Reads every project of the workspace.
+ *
+ * - An Angular CLI workspace (no `nx.json`): the projects of `angular.json`, or of the
+ *   `project.json` files when there is no `angular.json`.
+ * - An Nx workspace: the `project.json` files first, then the `angular.json` projects that no
+ *   `project.json` declares. Under `nx g`, Nx shows Angular devkit schematics a virtual
+ *   `angular.json` built from every `project.json`, and writing it makes Nx rewrite all of them
+ *   (reordered keys, its own layout, no final newline), including unrelated projects. Reading a
+ *   project from its own `project.json` keeps every write in that one file, as a text edit.
+ * @param tree - The workspace tree.
+ */
+function readWorkspaceProjects(tree) {
+    const angular = readAngularJsonProjects(tree);
+    if (!tree.exists('nx.json')) {
+        return tree.exists('angular.json') ? angular : readProjectJsonProjects(tree, new Map());
+    }
+    // A `project.json` without a name is named by Nx, which the virtual `angular.json` shows.
+    const projects = readProjectJsonProjects(tree, new Map(angular.map((project) => [project.root, project.name])));
+    const names = new Set(projects.map((project) => project.name));
+    const roots = new Set(projects.map((project) => project.root));
+    return [
+        ...projects,
+        ...angular.filter((project) => !names.has(project.name) && !roots.has(project.root)),
+    ];
+}
+/**
+ * The options a target runs with for a configuration: its `options` with the configuration's
+ * values over them (a shallow merge, as Architect does).
+ */
+function resolveTargetOptions(target, configuration) {
+    const configured = configuration ? target.configurations?.[configuration] : undefined;
+    return { ...(target.options ?? {}), ...(configured ?? {}) };
+}
+/** Parses `project:target[:configuration]`; an empty project means the current one. */
+function parseTargetString(value) {
+    const match = /^([^:\s]*):([^:\s]*)(?::([^\s]+))?$/.exec(value);
+    if (!match)
+        return undefined;
+    return {
+        project: match[1],
+        target: match[2],
+        ...(match[3] === undefined ? {} : { configuration: match[3] }),
+    };
+}
+/** A target with its `buildTarget` option set, or removed (with `options` when that empties it). */
+function withBuildTarget(target, buildTarget) {
+    const options = { ...(target.options ?? {}) };
+    if (buildTarget === undefined)
+        delete options['buildTarget'];
+    else
+        options['buildTarget'] = buildTarget;
+    const { options: _previous, ...rest } = target;
+    return Object.keys(options).length ? { ...rest, options } : rest;
+}
+/**
+ * Writes a target as a whole, replacing an existing one. A new target is inserted right after
+ * the target named by `anchor`, or right before `anchor.before`, when that target exists, so a
+ * renamed target stays next to its replacement.
+ * @param tree - The workspace tree.
+ * @param project - The project.
+ * @param name - The target.
+ * @param value - The target, or undefined to remove it.
+ * @param anchor - The target to insert a new target after, or `{ before }` to insert it before.
+ */
+function writeTarget(tree, project, name, value, anchor) {
+    const json = new json_file_1.JsonFile(tree, project.file);
+    const path = [...project.targetsPath, name];
+    if (value === undefined) {
+        json.remove(path);
+        return;
+    }
+    const names = Object.keys(json.get(project.targetsPath) ?? {});
+    const exists = names.includes(name);
+    const index = anchor === undefined
+        ? -1
+        : typeof anchor === 'string'
+            ? names.indexOf(anchor) + (names.includes(anchor) ? 1 : 0)
+            : names.indexOf(anchor.before);
+    json.modify(path, value, exists || index < 0 ? undefined : () => index);
+}
+/**
+ * Applies the differences between two values as edits to the values that changed, so everything
+ * else keeps its text and order. A new property is appended to its object.
+ * @param json - The file.
+ * @param path - The path of both values.
+ * @param before - The value in the file.
+ * @param after - The value to write.
+ */
+function applyDifferences(json, path, before, after) {
+    for (const key of Object.keys(before)) {
+        if (after[key] === undefined)
+            json.modify([...path, key], undefined);
+    }
+    for (const [key, value] of Object.entries(after)) {
+        if (value === undefined)
+            continue;
+        const current = before[key];
+        if (isRecord(current) && isRecord(value)) {
+            applyDifferences(json, [...path, key], current, value);
+        }
+        else if (JSON.stringify(current) !== JSON.stringify(value)) {
+            json.modify([...path, key], value, false);
+        }
+    }
+}
+/**
+ * Updates an existing target to a value with the smallest text edits: only the values that differ
+ * are written, so the rest of the target keeps the layout and key order of the user's file.
+ * Writes the whole target when it does not exist.
+ * @param tree - The workspace tree.
+ * @param project - The project.
+ * @param name - The target.
+ * @param value - The target as it should be.
+ */
+function updateTarget(tree, project, name, value) {
+    const json = new json_file_1.JsonFile(tree, project.file);
+    const path = [...project.targetsPath, name];
+    const current = json.get(path);
+    if (isRecord(current))
+        applyDifferences(json, path, current, value);
+    else
+        writeTarget(tree, project, name, value);
+}
+/**
+ * Renames a target by rewriting its key, so the target keeps its text and its place.
+ * @param tree - The workspace tree.
+ * @param project - The project.
+ * @param from - The current name.
+ * @param to - The new name, which no target may have.
+ */
+function renameTarget(tree, project, from, to) {
+    new json_file_1.JsonFile(tree, project.file).rename([...project.targetsPath, from], to);
+}
+//# sourceMappingURL=workspace.js.map

package/schematics/migrate-to-vite/setup/workspace.js.map

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

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

@@ -0,0 +1,65 @@
+import { Tree } from '@angular-devkit/schematics';
+import { Retarget } from './analyze';
+import { LegacyTargetEdit } from './legacy-folder';
+/**
+ * What a migration changed, kept next to the report so that `--revert` can undo exactly that and
+ * a second run can tell its own files from files the user wrote. Everything is plain, sorted JSON,
+ * so the same migration always writes the same bytes.
+ */
+export interface MigrationState {
+    schemaVersion: 1;
+    project: string;
+    /** The build target, and the name its original was kept under. */
+    build: {
+        name: string;
+        legacy: string;
+    };
+    /** The serve target, and the name its original was kept under. */
+    serve?: {
+        name: string;
+        legacy: string;
+    };
+    retargets: Retarget[];
+    /** Files the migration created, with the SHA-256 of the content it wrote. */
+    created: {
+        [file: string]: string;
+    };
+    /** Files the migration changed, with the SHA-256 of the content it wrote; originals are in `backup/`. */
+    modified: {
+        [file: string]: string;
+    };
+    /** Dependencies the migration added to package.json. */
+    dependencies: {
+        [name: string]: string;
+    };
+    /** The generated folder the legacy engine wrote and the new engine owns. */
+    generatedFolder?: string;
+    /** Whether the migration deleted the legacy engine's files in `generatedFolder`. */
+    legacyOutputDeleted?: boolean;
+    /** The new engine's cache folder, deleted by `--revert`. */
+    cacheFolder?: string;
+    /** Target name to the hash of the Vite target the migration wrote, to tell later edits apart. */
+    targetHashes?: {
+        [name: string]: string;
+    };
+    /**
+     * The generated folder of the kept legacy targets, and the values of those targets the migration
+     * changed so that they write it. A second run and `--revert` change them back.
+     */
+    legacyFolder?: {
+        folder: string;
+        edits: LegacyTargetEdit[];
+    };
+}
+/** The folder of a project's migration state, report and backups. */
+export declare function stateFolder(project: string): string;
+export declare function statePath(project: string): string;
+export declare function reportPath(project: string): string;
+/** The backup of a changed file; `.bak`, so no compiler, linter or test runner picks it up. */
+export declare function backupPath(project: string, file: string): string;
+export declare function readState(tree: Tree, project: string): MigrationState | undefined;
+export declare function serializeState(state: MigrationState): string;
+/** Writes a file, creating or overwriting it; a no-op when the content is already the same. */
+export declare function writeFile(tree: Tree, file: string, content: string): void;
+/** Deletes every file under a folder of the tree. */
+export declare function deleteFolder(tree: Tree, folder: string): number;

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

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stateFolder = stateFolder;
+exports.statePath = statePath;
+exports.reportPath = reportPath;
+exports.backupPath = backupPath;
+exports.readState = readState;
+exports.serializeState = serializeState;
+exports.writeFile = writeFile;
+exports.deleteFolder = deleteFolder;
+const schematics_1 = require("@angular-devkit/schematics");
+const path_1 = require("path");
+/** The folder of a project's migration state, report and backups. */
+function stateFolder(project) {
+    return path_1.posix.join('.ng-doc-migration', project);
+}
+function statePath(project) {
+    return path_1.posix.join(stateFolder(project), 'state.json');
+}
+function reportPath(project) {
+    return path_1.posix.join(stateFolder(project), 'report.md');
+}
+/** The backup of a changed file; `.bak`, so no compiler, linter or test runner picks it up. */
+function backupPath(project, file) {
+    return `${path_1.posix.join(stateFolder(project), 'backup', file)}.bak`;
+}
+function readState(tree, project) {
+    const file = statePath(project);
+    if (!tree.exists(file))
+        return undefined;
+    const invalid = (reason) => new schematics_1.SchematicsException(`[NGDOC_MIGRATE_STATE] ${file} ${reason}. Restore it from version control. To migrate again ` +
+        `without it, restore the original targets first (for example with git), then delete ` +
+        `${stateFolder(project)}; --revert needs this file.`);
+    let state;
+    try {
+        state = JSON.parse(tree.readText(file));
+    }
+    catch {
+        throw invalid('is not valid JSON');
+    }
+    if (!state ||
+        state.schemaVersion !== 1 ||
+        state.project !== project ||
+        typeof state.build?.name !== 'string' ||
+        typeof state.build?.legacy !== 'string') {
+        throw invalid(`does not describe a migration of "${project}"`);
+    }
+    return {
+        ...state,
+        retargets: state.retargets ?? [],
+        created: state.created ?? {},
+        modified: state.modified ?? {},
+        dependencies: state.dependencies ?? {},
+    };
+}
+function sorted(record) {
+    return Object.fromEntries(Object.entries(record).sort(([left], [right]) => (left < right ? -1 : 1)));
+}
+function serializeState(state) {
+    return `${JSON.stringify({
+        schemaVersion: state.schemaVersion,
+        project: state.project,
+        build: state.build,
+        ...(state.serve ? { serve: state.serve } : {}),
+        retargets: [...state.retargets].sort((left, right) => (left.target < right.target ? -1 : 1)),
+        created: sorted(state.created),
+        modified: sorted(state.modified),
+        dependencies: sorted(state.dependencies),
+        ...(state.generatedFolder ? { generatedFolder: state.generatedFolder } : {}),
+        ...(state.legacyOutputDeleted ? { legacyOutputDeleted: true } : {}),
+        ...(state.cacheFolder ? { cacheFolder: state.cacheFolder } : {}),
+        ...(state.targetHashes ? { targetHashes: sorted(state.targetHashes) } : {}),
+        ...(state.legacyFolder ? { legacyFolder: state.legacyFolder } : {}),
+    }, null, 2)}\n`;
+}
+/** Writes a file, creating or overwriting it; a no-op when the content is already the same. */
+function writeFile(tree, file, content) {
+    if (!tree.exists(file))
+        tree.create(file, content);
+    else if (tree.readText(file) !== content)
+        tree.overwrite(file, content);
+}
+/** Deletes every file under a folder of the tree. */
+function deleteFolder(tree, folder) {
+    let count = 0;
+    tree.getDir(folder).visit((file) => {
+        tree.delete(file);
+        count++;
+    });
+    return count;
+}
+//# sourceMappingURL=state.js.map

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

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

package/schematics/migrate-to-vite/testing/fixtures.d.ts

@@ -0,0 +1,18 @@
+import { Tree } from '@angular-devkit/schematics';
+import { UnitTestTree } from '@angular-devkit/schematics/testing';
+/** The files of a workspace, by workspace-relative path. */
+export type Files = Record<string, string>;
+export declare function treeOf(files: Files): UnitTestTree;
+/** Every file of a tree with its content, for whole-tree comparisons. */
+export declare function snapshot(tree: Tree): Files;
+/**
+ * A standalone, zoneless Angular 22 application with SSR, as `ng new --ssr` creates it, after
+ * the NgDoc `ng add` schematic switched it to the legacy NgDoc builders.
+ */
+export declare function standaloneApp(): Files;
+/** An NgModule application with Zone.js and no server rendering, on the legacy builders. */
+export declare function ngModuleApp(): Files;
+/** A standalone application whose build target sets most of the options the migration handles. */
+export declare function customOptionsApp(): Files;
+/** An Nx workspace: the project lives in `apps/docs/project.json` and uses `executor`. */
+export declare function nxApp(): Files;