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

package/README.md

@@ -1,37 +1,27 @@
-<!-- PROJECT LOGO -->
-<br />
-<div align="center">
-  <a href="https://github.com/ng-doc/ng-doc">
-    <img src="https://ng-doc.com/assets/images/ng-doc.svg?raw=true" alt="Logo" height="150px">
-  </a>
-
-<h1 align="center" style="margin-bottom: 0; border-bottom: 0">NgDoc</h1>
-  <p align="center">
-    Create user-friendly documentation for your projects with ease!
-    <br />
-    <a href="https://ng-doc.com/">Documentation</a>
-    ·
-    <a href="https://github.com/ng-doc/ng-doc/issues/new/choose">Report Bug</a>
-    ·
-    <a href="https://github.com/ng-doc/ng-doc/issues/new/choose">Request Feature</a>
-
-[![GitHub Workflow Status][build-shield]][build-url]
+# 🪄 @ng-doc/add
+
+The `ng add` schematics that install NgDoc and configure your project.
+
+It's part of [NgDoc](https://ng-doc.com/) 📚, the documentation engine for Angular projects.
+
 [![NPM][npm-shield]][npm-url]
 [![MIT License][license-shield]][license-url]
 
-  </p>
-</div>
+## 🚀 Getting started
+
+Run it in your Angular project to install and configure NgDoc:
 
-<!-- ABOUT THE PROJECT -->
+```bash
+ng add @ng-doc/add
+```
 
-## About The Project
+## 📖 Learn more
 
-This library is a part of NgDoc project, that uses to create documentation
-for Angular projects, please check our [repo](https://github.com/ng-doc/ng-doc) for more details.
+- [Documentation](https://ng-doc.com/)
+- [GitHub repository](https://github.com/ng-doc/ng-doc)
+- [Report a bug or request a feature](https://github.com/ng-doc/ng-doc/issues/new/choose)
 
-[npm-shield]: https://img.shields.io/npm/v/@ng-doc/builder.svg?style=for-the-badge
-[npm-url]: https://www.npmjs.com/package/@ng-doc/builder
+[npm-shield]: https://img.shields.io/npm/v/%40ng-doc%2Fadd.svg?style=for-the-badge
+[npm-url]: https://www.npmjs.com/package/@ng-doc/add
 [license-shield]: https://img.shields.io/github/license/ng-doc/ng-doc.svg?style=for-the-badge
-[license-url]: https://github.com/othneildrew/Best-README-Template/blob/master/LICENSE.txt
-[build-shield]: https://img.shields.io/github/actions/workflow/status/ng-doc/ng-doc/release.yml?style=for-the-badge&branch=release
-[build-url]: https://github.com/ng-doc/ng-doc/actions
+[license-url]: https://github.com/ng-doc/ng-doc/blob/main/LICENSE

package/package.json

@@ -1,21 +1,7 @@
 {
   "name": "@ng-doc/add",
-  "version": "22.0.0-beta.2",
-  "type": "commonjs",
-  "schematics": "./schematics/collection.json",
-  "ng-add": {
-    "save": true
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@angular/cdk": ">=22.0.0 < 23.0.0",
-    "@angular-devkit/schematics": ">=22.0.0 < 23.0.0",
-    "ng-morph": "4.8.4"
-  },
-  "types": "./schematics/index.d.ts",
-  "main": "./schematics/index.js",
+  "version": "22.1.0",
+  "description": "Adds NgDoc to an Angular or Nx project with `ng add` and sets everything up for you.",
   "keywords": [
     "angular",
     "documentation",
@@ -26,14 +12,30 @@
     "demo",
     "ng-doc"
   ],
-  "author": "Skoropad Aleksandr <alex@skoropad.dev>",
+  "homepage": "https://ng-doc.com",
+  "bugs": {
+    "url": "https://github.com/ng-doc/ng-doc/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ng-doc/ng-doc.git"
   },
-  "bugs": {
-    "url": "https://github.com/ng-doc/ng-doc/issues"
+  "license": "MIT",
+  "type": "commonjs",
+  "schematics": "./schematics/collection.json",
+  "ng-add": {
+    "save": true
   },
-  "homepage": "https://ng-doc.com",
-  "license": "MIT"
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ng-doc/builder": "22.1.0",
+    "@angular/cdk": ">=22.0.0 < 23.0.0",
+    "@angular-devkit/schematics": ">=22.0.0 < 23.0.0",
+    "ng-morph": "4.9.0"
+  },
+  "types": "./schematics/index.d.ts",
+  "main": "./schematics/index.js",
+  "author": "Skoropad Aleksandr <alex@skoropad.dev>"
 }

package/schematics/collection.json

@@ -1,16 +1,16 @@
 {
-	"$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
-	"schematics": {
-		"ng-add": {
-			"description": "Add NgDoc library to the project.",
-			"factory": "./ng-add/index#ngAdd",
-			"schema": "./ng-add/schema.json"
-		},
-		"ng-add-setup-project": {
-			"private": true,
-			"description": "Sets up the project after dependencies have been installed",
-			"factory": "./ng-add/index#ngAddSetupProject",
-			"schema": "./ng-add/schema.json"
-		}
-	}
+  "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Add NgDoc library to the project.",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json"
+    },
+    "ng-add-setup-project": {
+      "private": true,
+      "description": "Sets up the project; runs before the dependencies added by ng-add are installed",
+      "factory": "./ng-add/index#ngAddSetupProject",
+      "schema": "./ng-add/schema.json"
+    }
+  }
 }

package/schematics/ng-add/constants/modules.d.ts

@@ -3,9 +3,25 @@ export interface EntityImport {
     name: string;
     path: string;
 }
+/**
+ * One entry that `ng add` puts into an `imports` or `providers` array.
+ *
+ * An array entry is matched by its function or identifier name (the text of `initializer` before
+ * its first `(`). When the application already has such an entry, `ng add` extends it with
+ * `routes`, `features` and `options` instead of adding a second one, so the router and the HTTP
+ * client are never registered twice and a second `ng add` run changes nothing.
+ */
 export interface ImportConstant {
+    /** Expression added when the array has no entry with the same name yet. */
     initializer: string;
+    /** Named imports that the expression needs. */
     imports: EntityImport[];
+    /** Routes that the first argument of an existing call must include. */
+    routes?: string;
+    /** Feature calls that an existing call must pass, matched by their function name. */
+    features?: string[];
+    /** Properties that the options object (second argument) of an existing call must set. */
+    options?: Array<[name: string, initializer: string]>;
 }
 export interface AppImports {
     imports: ImportConstant[];
@@ -13,4 +29,10 @@ export interface AppImports {
 }
 export declare const NG_DOC_COMPONENT_IMPORTS: ImportConstant[];
 export declare const MODULE_APP: AppImports;
+/**
+ * Features that earlier versions of `ng add` added and that are deprecated now. They are dropped
+ * when `ng add` merges the duplicate calls those versions left behind; a call that the
+ * application wrote itself keeps them.
+ */
+export declare const DROPPED_FEATURES: string[];
 export declare const STANDALONE_APP: AppImports;

package/schematics/ng-add/constants/modules.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STANDALONE_APP = exports.MODULE_APP = exports.NG_DOC_COMPONENT_IMPORTS = exports.GENERATED_PATH = void 0;
+exports.STANDALONE_APP = exports.DROPPED_FEATURES = exports.MODULE_APP = exports.NG_DOC_COMPONENT_IMPORTS = exports.GENERATED_PATH = void 0;
 exports.GENERATED_PATH = '@ng-doc/generated';
 exports.NG_DOC_COMPONENT_IMPORTS = [
     {
@@ -16,14 +16,20 @@ exports.NG_DOC_COMPONENT_IMPORTS = [
         imports: [{ name: 'NgDocSidebarComponent', path: '@ng-doc/app' }],
     },
 ];
+/*
+ * No change-detection provider on purpose: NgDoc works with and without zone.js, so `ng add`
+ * keeps whatever the application uses (zoneless by default since Angular 21). No `withFetch()`
+ * either: the fetch backend is the default since Angular 22 and the feature is deprecated.
+ */
 const NG_DOC_PROVIDERS = [
     {
-        initializer: 'provideHttpClient(withInterceptorsFromDi(), withFetch())',
+        initializer: 'provideHttpClient(withInterceptorsFromDi())',
         imports: [
             { name: 'provideHttpClient', path: '@angular/common/http' },
             { name: 'withInterceptorsFromDi', path: '@angular/common/http' },
-            { name: 'withFetch', path: '@angular/common/http' },
         ],
+        // NgDoc registers class-based interceptors through `HTTP_INTERCEPTORS`.
+        features: ['withInterceptorsFromDi()'],
     },
     {
         initializer: 'provideNgDocContext()',
@@ -66,28 +72,36 @@ exports.MODULE_APP = {
                     path: exports.GENERATED_PATH,
                 },
             ],
+            routes: 'NG_DOC_ROUTING',
+            options: [
+                ['scrollPositionRestoration', "'enabled'"],
+                ['anchorScrolling', "'enabled'"],
+                ['scrollOffset', '[0, 70]'],
+            ],
         },
         ...exports.NG_DOC_COMPONENT_IMPORTS,
     ],
     providers: NG_DOC_PROVIDERS,
 };
+/**
+ * Features that earlier versions of `ng add` added and that are deprecated now. They are dropped
+ * when `ng add` merges the duplicate calls those versions left behind; a call that the
+ * application wrote itself keeps them.
+ */
+exports.DROPPED_FEATURES = ['withFetch'];
+const IN_MEMORY_SCROLLING = 'withInMemoryScrolling({scrollPositionRestoration: "enabled", anchorScrolling: "enabled"})';
 exports.STANDALONE_APP = {
     imports: exports.NG_DOC_COMPONENT_IMPORTS,
     providers: [
         {
-            initializer: 'provideHttpClient(withInterceptorsFromDi())',
-            imports: [
-                { name: 'provideHttpClient', path: '@angular/common/http' },
-                { name: 'withInterceptorsFromDi', path: '@angular/common/http' },
-            ],
-        },
-        {
-            initializer: 'provideRouter(NG_DOC_ROUTING, withInMemoryScrolling({scrollPositionRestoration: "enabled", anchorScrolling: "enabled"}))',
+            initializer: `provideRouter(NG_DOC_ROUTING, ${IN_MEMORY_SCROLLING})`,
             imports: [
                 { name: 'provideRouter', path: '@angular/router' },
                 { name: 'NG_DOC_ROUTING', path: exports.GENERATED_PATH },
                 { name: 'withInMemoryScrolling', path: '@angular/router' },
             ],
+            routes: 'NG_DOC_ROUTING',
+            features: [IN_MEMORY_SCROLLING],
         },
         ...NG_DOC_PROVIDERS,
     ],

package/schematics/ng-add/constants/modules.js.map

@@ -1 +1 @@
-{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/constants/modules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/constants/modules.ts"],"names":[],"mappings":"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"}

package/schematics/ng-add/constants/styles.d.ts

@@ -1 +1,5 @@
+/**
+ * The NgDoc stylesheets `ng-doc add` puts first in the build's `styles`: the global styles and the
+ * dark theme, which the theme toggle's Dark and Auto options switch to.
+ */
 export declare const NG_DOC_STYLES: string[];

package/schematics/ng-add/constants/styles.js

@@ -1,5 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NG_DOC_STYLES = void 0;
-exports.NG_DOC_STYLES = ['node_modules/@ng-doc/app/styles/global.css'];
+/**
+ * The NgDoc stylesheets `ng-doc add` puts first in the build's `styles`: the global styles and the
+ * dark theme, which the theme toggle's Dark and Auto options switch to.
+ */
+exports.NG_DOC_STYLES = [
+    'node_modules/@ng-doc/app/styles/global.css',
+    'node_modules/@ng-doc/app/styles/themes/dark.css',
+];
 //# sourceMappingURL=styles.js.map

package/schematics/ng-add/constants/styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/constants/styles.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAa,CAAC,4CAA4C,CAAC,CAAC"}
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/constants/styles.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,aAAa,GAAa;IACrC,4CAA4C;IAC5C,iDAAiD;CAClD,CAAC"}

package/schematics/ng-add/index.d.ts

@@ -6,7 +6,11 @@ import { Schema } from './schema';
  */
 export declare function ngAdd(options: Schema): Rule;
 /**
- *
- * @param options
+ * Sets up the project. It runs as a task before the install task of `ngAdd`, while `@ng-doc/add` is
+ * still installed. The styles, assets and providers are the same for both engines. The Vite engine then reads the build target, as it now is, into
+ * `vite.config.mjs` and the Vite targets (`@ng-doc/builder:vite-setup`); the legacy engine swaps
+ * the builders of the build and serve targets. A builder that is neither Angular's nor NgDoc's is
+ * kept, and the project generates its documentation with the `ng-doc` command.
+ * @param options - The `ng add` options.
  */
 export declare function ngAddSetupProject(options: Schema): Rule;

package/schematics/ng-add/index.js

@@ -4,6 +4,7 @@ exports.ngAdd = ngAdd;
 exports.ngAddSetupProject = ngAddSetupProject;
 const schematics_1 = require("@angular-devkit/schematics");
 const tasks_1 = require("@angular-devkit/schematics/tasks");
+const workspace_1 = require("@schematics/angular/utility/workspace");
 const ng_morph_1 = require("ng-morph");
 const version_1 = require("./constants/version");
 const add_assets_1 = require("./steps/add-assets");
@@ -14,8 +15,12 @@ const add_ng_doc_app_config_1 = require("./steps/add-ng-doc-app-config");
 const add_styles_1 = require("./steps/add-styles");
 const add_tsconfig_paths_1 = require("./steps/add-tsconfig-paths");
 const post_install_1 = require("./steps/post-install");
+const raise_initial_budget_1 = require("./steps/raise-initial-budget");
 const replace_builders_1 = require("./steps/replace-builders");
 const update_app_ts_config_1 = require("./steps/update-app-ts-config");
+const get_project_1 = require("./utils/get-project");
+const get_project_name_1 = require("./utils/get-project-name");
+const select_engine_1 = require("./utils/select-engine");
 /**
  *
  * @param options
@@ -34,21 +39,51 @@ function ngAdd(options) {
     };
 }
 /**
- *
- * @param options
+ * Sets up the project. It runs as a task before the install task of `ngAdd`, while `@ng-doc/add` is
+ * still installed. The styles, assets and providers are the same for both engines. The Vite engine then reads the build target, as it now is, into
+ * `vite.config.mjs` and the Vite targets (`@ng-doc/builder:vite-setup`); the legacy engine swaps
+ * the builders of the build and serve targets. A builder that is neither Angular's nor NgDoc's is
+ * kept, and the project generates its documentation with the `ng-doc` command.
+ * @param options - The `ng add` options.
  */
 function ngAddSetupProject(options) {
-    return (0, schematics_1.chain)([
-        (0, replace_builders_1.replaceBuilders)(options),
-        (0, add_styles_1.addStyles)(options),
-        (0, add_assets_1.addAssets)(options),
-        (0, add_js_dependencies_1.addJsDependencies)(options),
-        (0, add_ng_doc_app_config_1.addNgDocAppConfig)(options),
-        (0, add_layout_1.addLayout)(options),
-        (0, add_tsconfig_paths_1.addTsconfigPaths)(options),
-        (0, update_app_ts_config_1.updateAppTsConfig)(options),
-        (0, add_git_ignore_1.addGitIgnore)(),
-        (0, post_install_1.postInstall)(),
-    ]);
+    return async (tree, context) => {
+        const workspace = await (0, workspace_1.getWorkspace)(tree);
+        const project = (0, get_project_1.getProject)(options, workspace);
+        if (!project) {
+            throw new schematics_1.SchematicsException(`[NGDOC_ADD_PROJECT] Project "${(0, get_project_name_1.getProjectName)(options, workspace)}" was not found. Pass --project.`);
+        }
+        const choice = (0, select_engine_1.selectEngine)(tree, project, options.engine, context.logger);
+        // The Vite targets hold no Angular build options: a second run must not add any to them.
+        const editBuildTarget = !(choice.engine === 'vite' && choice.existing);
+        context.logger.info(`[INFO]: Engine: ${choice.keptBuilder
+            ? `the "ng-doc" command, next to "${choice.keptBuilder}"`
+            : choice.engine === 'vite'
+                ? 'Vite (@ng-doc/builder:vite-application)'
+                : 'legacy (@ng-doc/builder:application)'}`);
+        return (0, schematics_1.chain)([
+            choice.engine === 'legacy' && choice.replaceBuilders ? (0, replace_builders_1.replaceBuilders)(options) : (0, schematics_1.noop)(),
+            // Only a project new to NgDoc: an existing one chose its budgets. A kept builder runs
+            // Angular's builder with its budgets too.
+            choice.engine === 'legacy' && !choice.existing ? (0, raise_initial_budget_1.raiseInitialBudget)(options) : (0, schematics_1.noop)(),
+            editBuildTarget ? (0, add_styles_1.addStyles)(options) : (0, schematics_1.noop)(),
+            editBuildTarget ? (0, add_assets_1.addAssets)(options) : (0, schematics_1.noop)(),
+            editBuildTarget ? (0, add_js_dependencies_1.addJsDependencies)(options) : (0, schematics_1.noop)(),
+            (0, add_ng_doc_app_config_1.addNgDocAppConfig)(options),
+            (0, add_layout_1.addLayout)(options),
+            (0, add_tsconfig_paths_1.addTsconfigPaths)(options),
+            (0, update_app_ts_config_1.updateAppTsConfig)(options),
+            (0, add_git_ignore_1.addGitIgnore)(),
+            // `@ng-doc/add` depends on `@ng-doc/builder`, so the schematic is there before the install
+            // that follows this one. That install also installs the Vite dependencies it adds.
+            choice.engine === 'vite'
+                ? (0, schematics_1.externalSchematic)('@ng-doc/builder', 'vite-setup', {
+                    project: (0, get_project_name_1.getProjectName)(options, workspace),
+                    skipInstall: true,
+                })
+                : (0, schematics_1.noop)(),
+            (0, post_install_1.postInstall)(choice.engine, choice.keptBuilder),
+        ]);
+    };
 }
 //# sourceMappingURL=index.js.map

package/schematics/ng-add/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/add/schematics/ng-add/index.ts"],"names":[],"mappings":";;AA0BA,sBAcC;AAMD,8CAaC;AA3DD,2DAAiF;AACjF,4DAA4F;AAC5F,uCAKkB;AAElB,iDAAqD;AAErD,mDAA+C;AAC/C,2DAAsD;AACtD,qEAAgE;AAChE,mDAA+C;AAC/C,yEAAkE;AAClE,mDAA+C;AAC/C,mEAA8D;AAC9D,uDAAmD;AACnD,+DAA2D;AAC3D,uEAAiE;AAEjE;;;GAGG;AACH,SAAgB,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,IAAU,EAAE,OAAyB,EAAE,EAAE;QAC/C,IAAA,2BAAgB,EAAC,IAAA,wBAAa,EAAC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAErE,IAAA,mCAAwB,EAAC,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,wBAAc,EAAE,CAAC,CAAC;QACjF,IAAA,mCAAwB,EAAC,IAAI,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,wBAAc,EAAE,CAAC,CAAC;QACrF,IAAA,mCAAwB,EAAC,IAAI,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,wBAAc,EAAE,CAAC,CAAC;QACpF,IAAA,mCAAwB,EAAC,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,wBAAc,EAAE,CAAC,CAAC;QAClF,IAAA,sCAA2B,EAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAEjD,OAAO,CAAC,OAAO,CAAC,IAAI,8BAAsB,EAAE,EAAE;YAC5C,OAAO,CAAC,OAAO,CAAC,IAAI,wBAAgB,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;SACvE,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAA,kBAAK,EAAC;QACX,IAAA,kCAAe,EAAC,OAAO,CAAC;QACxB,IAAA,sBAAS,EAAC,OAAO,CAAC;QAClB,IAAA,sBAAS,EAAC,OAAO,CAAC;QAClB,IAAA,uCAAiB,EAAC,OAAO,CAAC;QAC1B,IAAA,yCAAiB,EAAC,OAAO,CAAC;QAC1B,IAAA,sBAAS,EAAC,OAAO,CAAC;QAClB,IAAA,qCAAgB,EAAC,OAAO,CAAC;QACzB,IAAA,wCAAiB,EAAC,OAAO,CAAC;QAC1B,IAAA,6BAAY,GAAE;QACd,IAAA,0BAAW,GAAE;KACd,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/add/schematics/ng-add/index.ts"],"names":[],"mappings":"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"}

package/schematics/ng-add/schema.d.ts

@@ -1,3 +1,11 @@
+/** The NgDoc engine that `ng add` sets up. */
+export type NgDocEngine = 'vite' | 'legacy';
 export interface Schema {
     readonly project: string;
+    /**
+     * `vite` (the Vite engine) or `legacy` (the legacy builders). Without it, a standalone
+     * application gets the Vite engine, and an NgModule application or a project that already uses
+     * NgDoc keeps or gets the legacy builders.
+     */
+    readonly engine?: NgDocEngine;
 }

package/schematics/ng-add/schema.json

@@ -1,16 +1,21 @@
 {
-	"$schema": "http://json-schema.org/draft-07/schema",
-	"$id": "ng-doc-ng-add",
-	"title": "NgDoc ng-add",
-	"type": "object",
-	"properties": {
-		"project": {
-			"type": "string",
-			"description": "The name of the project.",
-			"$default": {
-				"$source": "projectName"
-			}
-		}
-	},
-	"required": []
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "ng-doc-ng-add",
+  "title": "NgDoc ng-add",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the project.",
+      "$default": {
+        "$source": "projectName"
+      }
+    },
+    "engine": {
+      "type": "string",
+      "enum": ["vite", "legacy"],
+      "description": "The engine to set up: \"vite\" (the @ng-doc/builder:vite-application and vite-dev-server builders) or \"legacy\" (the @ng-doc/builder:application and dev-server builders). By default a standalone application on Angular's application builder (or Nx's @nx/angular:application executor) gets the Vite engine; an NgModule application, or one on another builder, gets the legacy builders. A project that already uses NgDoc keeps its builders."
+    }
+  },
+  "required": []
 }

package/schematics/ng-add/steps/add-assets.d.ts

@@ -1,8 +1,7 @@
 import { Rule } from '@angular-devkit/schematics';
 import { Schema } from '../schema';
 /**
- *
- * @param options
- * @param context
+ * Adds the NgDoc assets to the target with the Angular build options (`getBuildOptionsTarget`). Entries that are already there are not added again.
+ * @param options - The `ng add` options.
  */
 export declare function addAssets(options: Schema): Rule;

package/schematics/ng-add/steps/add-assets.js

@@ -4,11 +4,11 @@ exports.addAssets = addAssets;
 const schematics_1 = require("@angular/cdk/schematics");
 const workspace_1 = require("@schematics/angular/utility/workspace");
 const assets_1 = require("../constants/assets");
+const get_build_options_target_1 = require("../utils/get-build-options-target");
 const get_project_1 = require("../utils/get-project");
 /**
- *
- * @param options
- * @param context
+ * Adds the NgDoc assets to the target with the Angular build options (`getBuildOptionsTarget`). Entries that are already there are not added again.
+ * @param options - The `ng add` options.
  */
 function addAssets(options) {
     return async (tree, context) => {
@@ -22,9 +22,15 @@ function addAssets(options) {
                     logger.error(`❌ Target project not found. Please add assets manually.`);
                     return;
                 }
-                const targetOptions = (0, schematics_1.getProjectTargetOptions)(project, 'build');
+                const targetOptions = (0, schematics_1.getProjectTargetOptions)(project, (0, get_build_options_target_1.getBuildOptionsTarget)(project));
                 const assets = targetOptions['assets'];
-                targetOptions['assets'] = Array.from(new Set([...(0, assets_1.getNgDocAssets)(options, workspace), ...(assets ?? [])]));
+                // Asset entries are objects, so they are compared by content: a second `ng add` run must
+                // not add them again.
+                const existing = new Set((assets ?? []).map((asset) => JSON.stringify(asset)));
+                targetOptions['assets'] = [
+                    ...(0, assets_1.getNgDocAssets)(options, workspace).filter((asset) => !existing.has(JSON.stringify(asset))),
+                    ...(assets ?? []),
+                ];
                 logger.info('✅ Done!');
             }
             catch (e) {

package/schematics/ng-add/steps/add-assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-assets.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/steps/add-assets.ts"],"names":[],"mappings":";;AAkBA,8BAkCC;AApDD,wDAAkE;AAGlE,qEAI+C;AAE/C,gDAAqD;AAErD,sDAAkD;AAElD;;;;GAIG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,OAAO,KAAK,EAAE,IAAU,EAAE,OAAyB,EAAE,EAAE;QACrD,OAAO,IAAA,2BAAe,EAAC,CAAC,SAA8B,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAExD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YAEzD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAkC,IAAA,wBAAU,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;gBAE9E,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;oBAExE,OAAO;gBACT,CAAC;gBAED,MAAM,aAAa,GAA0C,IAAA,oCAAuB,EAClF,OAAO,EACP,OAAO,CACR,CAAC;gBAEF,MAAM,MAAM,GAA0B,aAAa,CAAC,QAAQ,CAA0B,CAAC;gBAEvF,aAAa,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAClC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAA,uBAAc,EAAC,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CACpE,CAAC;gBAEF,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"add-assets.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/steps/add-assets.ts"],"names":[],"mappings":";;AAkBA,8BA2CC;AA7DD,wDAAkE;AAGlE,qEAI+C;AAE/C,gDAAqD;AAErD,gFAA0E;AAC1E,sDAAkD;AAElD;;;GAGG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,OAAO,KAAK,EAAE,IAAU,EAAE,OAAyB,EAAE,EAAE;QACrD,OAAO,IAAA,2BAAe,EAAC,CAAC,SAA8B,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAExD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YAEzD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAkC,IAAA,wBAAU,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;gBAE9E,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;oBAExE,OAAO;gBACT,CAAC;gBAED,MAAM,aAAa,GAA0C,IAAA,oCAAuB,EAClF,OAAO,EACP,IAAA,gDAAqB,EAAC,OAAO,CAAC,CAC/B,CAAC;gBAEF,MAAM,MAAM,GAA0B,aAAa,CAAC,QAAQ,CAA0B,CAAC;gBAEvF,yFAAyF;gBACzF,sBAAsB;gBACtB,MAAM,QAAQ,GAAgB,IAAI,GAAG,CACnC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAChE,CAAC;gBAEF,aAAa,CAAC,QAAQ,CAAC,GAAG;oBACxB,GAAG,IAAA,uBAAc,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC,MAAM,CAC1C,CAAC,KAAgB,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAC3D;oBACD,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;iBAClB,CAAC;gBAEF,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/schematics/ng-add/steps/add-git-ignore.d.ts

@@ -1,7 +1,5 @@
 import { Rule } from '@angular-devkit/schematics';
 /**
- *
- * @param options
- * @param context
+ * Adds the generated `ng-doc` folder to `.gitignore` unless it is already ignored.
  */
 export declare function addGitIgnore(): Rule;

package/schematics/ng-add/steps/add-git-ignore.js

@@ -3,9 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.addGitIgnore = addGitIgnore;
 const workspace_1 = require("@schematics/angular/utility/workspace");
 /**
- *
- * @param options
- * @param context
+ * Adds the generated `ng-doc` folder to `.gitignore` unless it is already ignored.
  */
 function addGitIgnore() {
     return async (tree, context) => {
@@ -19,7 +17,14 @@ function addGitIgnore() {
                     logger.warn(`⚠️ ".gitignore" file was not found, please add "/ng-doc" folder into it manually.`);
                     return;
                 }
-                tree.overwrite('.gitignore', `${gitignore}\n\n# NgDoc files\n/ng-doc`);
+                // A second `ng add` run must not append the entry again.
+                const ignored = gitignore
+                    .toString()
+                    .split(/\r?\n/)
+                    .some((line) => /^\/?ng-doc\/?$/.test(line.trim()));
+                if (!ignored) {
+                    tree.overwrite('.gitignore', `${gitignore}\n\n# NgDoc files\n/ng-doc`);
+                }
                 logger.info('✅ Done!');
             }
             catch (e) {

package/schematics/ng-add/steps/add-git-ignore.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-git-ignore.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/steps/add-git-ignore.ts"],"names":[],"mappings":";;AAQA,oCA2BC;AAlCD,qEAAwE;AAExE;;;;GAIG;AACH,SAAgB,YAAY;IAC1B,OAAO,KAAK,EAAE,IAAU,EAAE,OAAyB,EAAE,EAAE;QACrD,OAAO,IAAA,2BAAe,EAAC,GAAG,EAAE;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAE3D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YAE/D,IAAI,CAAC;gBACH,MAAM,SAAS,GAAkB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAEzD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CACT,mFAAmF,CACpF,CAAC;oBAEF,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,SAAS,4BAA4B,CAAC,CAAC;gBAEvE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"add-git-ignore.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/steps/add-git-ignore.ts"],"names":[],"mappings":";;AAMA,oCAmCC;AAxCD,qEAAwE;AAExE;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,KAAK,EAAE,IAAU,EAAE,OAAyB,EAAE,EAAE;QACrD,OAAO,IAAA,2BAAe,EAAC,GAAG,EAAE;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAE3D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YAE/D,IAAI,CAAC;gBACH,MAAM,SAAS,GAAkB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAEzD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CACT,mFAAmF,CACpF,CAAC;oBAEF,OAAO;gBACT,CAAC;gBAED,yDAAyD;gBACzD,MAAM,OAAO,GAAY,SAAS;qBAC/B,QAAQ,EAAE;qBACV,KAAK,CAAC,OAAO,CAAC;qBACd,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAE9D,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,SAAS,4BAA4B,CAAC,CAAC;gBACzE,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/schematics/ng-add/steps/add-js-dependencies.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.addJsDependencies = addJsDependencies;
 const schematics_1 = require("@angular/cdk/schematics");
 const workspace_1 = require("@schematics/angular/utility/workspace");
+const get_build_options_target_1 = require("../utils/get-build-options-target");
 const get_project_1 = require("../utils/get-project");
 /**
  *
@@ -21,7 +22,7 @@ function addJsDependencies(options) {
                     logger.error(`❌ Target project not found. Please add "@ng-doc/core" library to "allowedCommonJsDependencies" manually.`);
                     return;
                 }
-                const targetOptions = (0, schematics_1.getProjectTargetOptions)(project, 'build');
+                const targetOptions = (0, schematics_1.getProjectTargetOptions)(project, (0, get_build_options_target_1.getBuildOptionsTarget)(project));
                 const jsDependencies = targetOptions['allowedCommonJsDependencies'];
                 targetOptions['allowedCommonJsDependencies'] = Array.from(new Set([...(jsDependencies ?? []), '@ng-doc/core']));
                 logger.info('✅ Done!');

package/schematics/ng-add/steps/add-js-dependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-js-dependencies.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/steps/add-js-dependencies.ts"],"names":[],"mappings":";;AAiBA,8CAqCC;AAtDD,wDAAkE;AAGlE,qEAI+C;AAG/C,sDAAkD;AAElD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,KAAK,EAAE,IAAU,EAAE,OAAyB,EAAE,EAAE;QACrD,OAAO,IAAA,2BAAe,EAAC,CAAC,SAA8B,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;YAEjE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;YAEpF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAkC,IAAA,wBAAU,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;gBAE9E,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CACV,0GAA0G,CAC3G,CAAC;oBAEF,OAAO;gBACT,CAAC;gBAED,MAAM,aAAa,GAA0C,IAAA,oCAAuB,EAClF,OAAO,EACP,OAAO,CACR,CAAC;gBACF,MAAM,cAAc,GAA0B,aAAa,CACzD,6BAA6B,CACL,CAAC;gBAE3B,aAAa,CAAC,6BAA6B,CAAC,GAAG,KAAK,CAAC,IAAI,CACvD,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC,CACrD,CAAC;gBAEF,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"add-js-dependencies.js","sourceRoot":"","sources":["../../../../../../libs/add/schematics/ng-add/steps/add-js-dependencies.ts"],"names":[],"mappings":";;AAkBA,8CAqCC;AAvDD,wDAAkE;AAGlE,qEAI+C;AAG/C,gFAA0E;AAC1E,sDAAkD;AAElD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,KAAK,EAAE,IAAU,EAAE,OAAyB,EAAE,EAAE;QACrD,OAAO,IAAA,2BAAe,EAAC,CAAC,SAA8B,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;YAEjE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;YAEpF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAkC,IAAA,wBAAU,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;gBAE9E,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CACV,0GAA0G,CAC3G,CAAC;oBAEF,OAAO;gBACT,CAAC;gBAED,MAAM,aAAa,GAA0C,IAAA,oCAAuB,EAClF,OAAO,EACP,IAAA,gDAAqB,EAAC,OAAO,CAAC,CAC/B,CAAC;gBACF,MAAM,cAAc,GAA0B,aAAa,CACzD,6BAA6B,CACL,CAAC;gBAE3B,aAAa,CAAC,6BAA6B,CAAC,GAAG,KAAK,CAAC,IAAI,CACvD,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC,CACrD,CAAC;gBAEF,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/schematics/ng-add/steps/add-layout.d.ts

@@ -1,7 +1,7 @@
 import { Rule } from '@angular-devkit/schematics';
 import { Schema } from '../schema';
 /**
- *
- * @param options
+ * Replaces the root component's template with the NgDoc layout.
+ * @param options - The `ng add` options.
  */
 export declare function addLayout(options: Schema): Rule;