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

package/helpers/typescript/node/sort-by-nodes-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"sort-by-nodes-name.js","sourceRoot":"","sources":["../../../../../../libs/builder/helpers/typescript/node/sort-by-nodes-name.ts"],"names":[],"mappings":";;AAMA,0CAEC;AAND;;;GAGG;AACH,SAAgB,eAAe,CAAiC,KAAU;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAI,EAAE,CAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC"}
+{"version":3,"file":"sort-by-nodes-name.js","sourceRoot":"","sources":["../../../../../../libs/builder/helpers/typescript/node/sort-by-nodes-name.ts"],"names":[],"mappings":";;AAUA,0CAEC;AAVD,iDAA+C;AAE/C;;;;;GAKG;AACH,SAAgB,eAAe,CAAiC,KAAU;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAI,EAAE,CAAI,EAAE,EAAE,CAAC,IAAA,wBAAW,EAAC,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/helpers/typescript/property/get-property-assignment.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-property-assignment.js","sourceRoot":"","sources":["../../../../../../libs/builder/helpers/typescript/property/get-property-assignment.ts"],"names":[],"mappings":";;AAOA,sDAIC;AAXD,uCAA0D;AAE1D;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,wBAAmD;IACvF,OAAO,eAAI,CAAC,oBAAoB,CAAC,wBAAwB,CAAC;QACxD,CAAC,CAAC,wBAAwB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC7D,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}
+{"version":3,"file":"get-property-assignment.js","sourceRoot":"","sources":["../../../../../../libs/builder/helpers/typescript/property/get-property-assignment.ts"],"names":[],"mappings":";;AAOA,sDAIC;AAXD,uCAA0D;AAE1D;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,wBAAmD;IACxF,OAAO,eAAI,CAAC,oBAAoB,CAAC,wBAAwB,CAAC;QACzD,CAAC,CAAC,wBAAwB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC7D,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}

package/interfaces/code-block-options.d.ts

@@ -8,5 +8,10 @@ export interface NgDocCodeBlockParams {
     icon?: string;
     fileLineStart?: number;
     fileLineEnd?: number;
+    /**
+     * The snippet of `file` to show, from `file="./x.ts"#<id>`: the lines between the two
+     * `snippet#<id>` markers. Only the Vite engine reads it.
+     */
+    snippet?: string;
     highlightedLines?: number[];
 }

package/interfaces/configuration.d.ts

@@ -1,4 +1,4 @@
-import { NgDocHeading, NgDocKeywordsLoader } from '@ng-doc/core';
+import { NgDocDemoProvidersImport, NgDocHeading, NgDocKeywordsLoader } from '@ng-doc/core';
 import { NgDocGlobalKeyword } from '@ng-doc/core/interfaces/keyword-map';
 import { NgDocRepoConfig } from './repo-config';
 /**
@@ -43,6 +43,30 @@ export interface NgDocConfiguration {
      * The configuration for the guides
      */
     guide?: NgDocGuideConfiguration;
+    /**
+     * The configuration for the API pages. Only the Vite engine reads it.
+     */
+    api?: NgDocApiConfiguration;
+    /**
+     * Shows every demo of the `demo` action in an iframe, as `isolated: true` does for one demo
+     * (`false` by default). It also builds a demo page for every demo. Only the Vite engine reads it.
+     */
+    isolatedDemos?: boolean;
+    /**
+     * The demo pages: one page per demo that loads only Angular and that demo, which isolated demos
+     * show in an iframe and "Open in new tab" opens. Only the Vite engine builds them.
+     *
+     * By default only the pages with an isolated demo get them. `true` (or an object) builds them for
+     * every page with demos; `false` never builds them, and isolated demos render in the page.
+     */
+    demoApplication?: boolean | NgDocDemoApplicationConfiguration;
+    /**
+     * Imports the module whose default export lists the providers of the demo pages, for example
+     * `() => import('./demo.providers')`. It must be written in `ng-doc.config.ts` as an arrow
+     * function that returns one `import()` of a file. NgDoc never calls it while it generates; the
+     * demo pages import the module. Only the Vite engine reads it.
+     */
+    demoProviders?: NgDocDemoProvidersImport;
     /**
      * Shiki configuration
      */
@@ -51,8 +75,43 @@ export interface NgDocConfiguration {
             light: string;
             dark: string;
         };
+        /**
+         * Shiki language registrations that code blocks can use in addition to the languages bundled
+         * with Shiki, such as a grammar imported from a `.tmLanguage.json` file or from
+         * `@shikijs/langs`. A registration named like a bundled language replaces it. Only the Vite
+         * engine reads it; load the same languages in the browser with `provideNgDocApp`.
+         */
+        langs?: Array<NgDocShikiLanguage | readonly NgDocShikiLanguage[]>;
     };
 }
+/**
+ * A Shiki (TextMate) language registration: a grammar and the name that code blocks use for it.
+ * It must be plain JSON data, as in a `.tmLanguage.json` file or a module of `@shikijs/langs`.
+ */
+export interface NgDocShikiLanguage {
+    /** The language name: code blocks that name it (for example ` ```my-lang `) use the grammar. */
+    name: string;
+    /** The root scope of the grammar, such as `source.my-lang`. */
+    scopeName: string;
+    /** The name to display for the language. */
+    displayName?: string;
+    /** Other names that code blocks can use for the language. */
+    aliases?: string[];
+    /** The languages that the grammar embeds, which must be bundled or registered too. */
+    embeddedLangs?: string[];
+    /** The languages that the grammar embeds when they are loaded. */
+    embeddedLangsLazy?: string[];
+    /** The scopes that the grammar injects itself into. */
+    injectTo?: string[];
+    /** The TextMate rules of the grammar. */
+    patterns?: unknown;
+    /** The named TextMate rules that `patterns` include. */
+    repository?: unknown;
+    /** TextMate injections. */
+    injections?: unknown;
+    /** The selector of an injection grammar. */
+    injectionSelector?: string;
+}
 /**
  * The configuration for the guide page
  */
@@ -67,6 +126,30 @@ export interface NgDocGuideConfiguration {
      */
     headerTemplate?: string;
 }
+/**
+ * The configuration for the API pages.
+ */
+export interface NgDocApiConfiguration {
+    /**
+     * Whether API pages list the protected members of classes, inherited ones included
+     * (`true` by default). With `false`, they list only public members: hidden members get no row,
+     * anchor, search record or keyword.
+     */
+    protectedMembers?: boolean;
+}
+/**
+ * The configuration of the demo pages.
+ */
+export interface NgDocDemoApplicationConfiguration {
+    /**
+     * The URL path under which the demo pages are served, relative to the base href
+     * (`demo-preview` by default): a demo's page is `<base href><path>/<page route>/<demo name>/`.
+     * One or more URL segments of letters, digits, `-`, `_` and `.`; the first character of a
+     * segment is a letter or a digit, because some static hosts skip folders that start with `_`
+     * or `.`.
+     */
+    path?: string;
+}
 /**
  * The configuration for the global keywords.
  */

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@ng-doc/builder",
-  "version": "22.0.0-beta.2",
+  "version": "22.1.0",
+  "description": "Generates an NgDoc documentation site from your Markdown pages and TypeScript code.",
+  "keywords": [
+    "angular",
+    "documentation",
+    "generator",
+    "builder",
+    "guides",
+    "api",
+    "demo",
+    "ng-doc"
+  ],
+  "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"
+  },
+  "license": "MIT",
   "type": "commonjs",
   "builders": "./builders.json",
   "schematics": "./schematics/collection.json",
@@ -11,13 +31,12 @@
     ]
   },
   "dependencies": {
-    "@ng-doc/core": "22.0.0-beta.2",
-    "@ng-doc/utils": "22.0.0-beta.2",
-    "@angular-devkit/architect": ">=0.2200.0 < 0.2300.0",
-    "@angular-devkit/build-angular": ">=22.0.0 < 23.0.0",
-    "minimatch": "9.0.1",
+    "@ng-doc/core": "22.1.0",
+    "@ng-doc/utils": "22.1.0",
+    "@angular-devkit/architect": ">=0.2200.0 <0.2300.0",
+    "minimatch": "9.0.9",
     "rxjs": "^7.0.0",
-    "ts-morph": "22.0.0",
+    "ts-morph": "28.0.0",
     "nunjucks": "3.2.4",
     "@orama/orama": "2.0.17",
     "@orama/plugin-parsedoc": "2.0.17",
@@ -32,10 +51,64 @@
     "cosmiconfig-typescript-loader": "5.0.0",
     "find-cache-dir": "3.3.2",
     "tslib": "^2.6.2",
-    "ng-morph": "^4.0.3",
+    "ng-morph": "4.9.0",
+    "jsonc-parser": "3.3.1",
     "parsimmon": "^1.18.1",
     "@parcel/watcher": "^2.5.0",
-    "@microsoft/tsdoc": "0.15.1"
+    "@microsoft/tsdoc": "0.15.1",
+    "@shikijs/rehype": "4.5.0",
+    "shiki": "4.5.0",
+    "css-what": "6.1.0",
+    "github-slugger": "2.0.0",
+    "hast-util-has-property": "3.0.0",
+    "hast-util-heading-rank": "3.0.0",
+    "hast-util-is-element": "3.0.0",
+    "hast-util-to-string": "3.0.0",
+    "posthtml-render": "3.0.0",
+    "rehype": "13.0.1",
+    "rehype-minify-whitespace": "6.0.0",
+    "rehype-parse": "9.0.0",
+    "rehype-stringify": "10.0.1",
+    "stringify-entities": "4.0.4",
+    "typescript": "6.0.3",
+    "unified": "11.0.5",
+    "unist-util-filter": "5.0.1",
+    "unist-util-visit": "5.0.0",
+    "unist-util-visit-parents": "6.0.2",
+    "@angular-devkit/core": ">=22.0.0 <23.0.0",
+    "magic-string": "0.30.21",
+    "obug": "2.1.3",
+    "oxc-parser": "0.121.0",
+    "tinyglobby": "0.2.17"
+  },
+  "peerDependencies": {
+    "@angular/build": ">=22.0.0 <23.0.0",
+    "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
+    "@analogjs/vite-plugin-angular": "^2.8.0",
+    "@angular/compiler": ">=22.0.0 <23.0.0",
+    "@angular/compiler-cli": ">=22.0.0 <23.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
+    "@analogjs/vite-plugin-angular": {
+      "optional": true
+    },
+    "@angular/compiler": {
+      "optional": true
+    },
+    "@angular/compiler-cli": {
+      "optional": true
+    }
+  },
+  "ng-doc": {
+    "viteEngine": {
+      "@analogjs/vite-plugin-angular": "^2.8.0",
+      "@angular/compiler": "^22.0.0",
+      "@angular/compiler-cli": "^22.0.0",
+      "vite": "^8.3.0"
+    }
   },
   "publishConfig": {
     "access": "public"
@@ -45,26 +118,11 @@
       "chokidar": "^5.0.0"
     }
   },
-  "types": "./index.d.ts",
-  "main": "./index.js",
-  "keywords": [
-    "angular",
-    "documentation",
-    "generator",
-    "builder",
-    "guides",
-    "api",
-    "demo",
-    "ng-doc"
-  ],
-  "author": "Skoropad Aleksandr <alex@skoropad.dev>",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ng-doc/ng-doc.git"
+  "bin": {
+    "ng-doc": "./generator/bootstrap/bin.js"
   },
-  "bugs": {
-    "url": "https://github.com/ng-doc/ng-doc/issues"
+  "engines": {
+    "node": ">=24.15.0 <25"
   },
-  "homepage": "https://ng-doc.com",
-  "license": "MIT"
+  "author": "Skoropad Aleksandr <alex@skoropad.dev>"
 }

package/parsers/helpers/number.d.ts

@@ -1,2 +1,2 @@
-import * as P from 'parsimmon';
+import P from 'parsimmon';
 export declare const number: P.Parser<number>;

package/parsers/helpers/number.js

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.number = void 0;
 const tslib_1 = require("tslib");
-const P = tslib_1.__importStar(require("parsimmon"));
-exports.number = P.digits.map(Number);
+const parsimmon_1 = tslib_1.__importDefault(require("parsimmon"));
+exports.number = parsimmon_1.default.digits.map(Number);
 //# sourceMappingURL=number.js.map

package/parsers/helpers/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../libs/builder/parsers/helpers/number.ts"],"names":[],"mappings":";;;;AAAA,qDAA+B;AAElB,QAAA,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../libs/builder/parsers/helpers/number.ts"],"names":[],"mappings":";;;;AAAA,kEAA0B;AAEb,QAAA,MAAM,GAAG,mBAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC"}

package/parsers/helpers/param-value.d.ts

@@ -1,2 +1,2 @@
-import * as P from 'parsimmon';
+import P from 'parsimmon';
 export declare const paramValue: () => P.Parser<string>;

package/parsers/helpers/param-value.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.paramValue = void 0;
 const tslib_1 = require("tslib");
-const P = tslib_1.__importStar(require("parsimmon"));
-const paramValue = () => P.regexp(/.+?(?=")/).wrap(P.string('"'), P.string('"'));
+const parsimmon_1 = tslib_1.__importDefault(require("parsimmon"));
+const paramValue = () => parsimmon_1.default.regexp(/.+?(?=")/).wrap(parsimmon_1.default.string('"'), parsimmon_1.default.string('"'));
 exports.paramValue = paramValue;
 //# sourceMappingURL=param-value.js.map

package/parsers/helpers/param-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"param-value.js","sourceRoot":"","sources":["../../../../../libs/builder/parsers/helpers/param-value.ts"],"names":[],"mappings":";;;;AAAA,qDAA+B;AAExB,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAA3E,QAAA,UAAU,cAAiE"}
+{"version":3,"file":"param-value.js","sourceRoot":"","sources":["../../../../../libs/builder/parsers/helpers/param-value.ts"],"names":[],"mappings":";;;;AAAA,kEAA0B;AAEnB,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,mBAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,mBAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,mBAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAA3E,QAAA,UAAU,cAAiE"}

package/parsers/helpers/param.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.param = param;
 const tslib_1 = require("tslib");
-const P = tslib_1.__importStar(require("parsimmon"));
+const parsimmon_1 = tslib_1.__importDefault(require("parsimmon"));
 const param_value_1 = require("./param-value");
 /**
  *
@@ -10,8 +10,8 @@ const param_value_1 = require("./param-value");
  * @param newKeyName
  */
 function param(key, newKeyName) {
-    return P.string(key)
-        .then(P.string('='))
+    return parsimmon_1.default.string(key)
+        .then(parsimmon_1.default.string('='))
         .then((0, param_value_1.paramValue)())
         .map((value) => ({ [newKeyName ?? key]: value }));
 }

package/parsers/helpers/param.js.map

@@ -1 +1 @@
-{"version":3,"file":"param.js","sourceRoot":"","sources":["../../../../../libs/builder/parsers/helpers/param.ts"],"names":[],"mappings":";;AAUA,sBAQC;;AAlBD,qDAA+B;AAG/B,+CAA2C;AAE3C;;;;GAIG;AACH,SAAgB,KAAK,CACpB,GAAM,EACN,UAAc;IAEd,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAClB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SACnB,IAAI,CAAC,IAAA,wBAAU,GAAE,CAAC;SAClB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,IAAI,GAAG,CAAC,EAAE,KAAK,EAA+C,CAAA,CAAC,CAAC;AAChG,CAAC"}
+{"version":3,"file":"param.js","sourceRoot":"","sources":["../../../../../libs/builder/parsers/helpers/param.ts"],"names":[],"mappings":";;AAUA,sBAQC;;AAlBD,kEAA0B;AAG1B,+CAA2C;AAE3C;;;;GAIG;AACH,SAAgB,KAAK,CACnB,GAAM,EACN,UAAc;IAEd,OAAO,mBAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACjB,IAAI,CAAC,mBAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SACnB,IAAI,CAAC,IAAA,wBAAU,GAAE,CAAC;SAClB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,CAA6C,CAAC,CAAC;AAClG,CAAC"}

package/parsers/parse-code-block-params.d.ts

@@ -1,6 +1,15 @@
-import { NgDocCodeBlockParams } from '../interfaces';
+import type { NgDocCodeBlockParams } from '../interfaces/code-block-options';
+/** Options of {@link parseCodeBlockParams}. */
+export interface NgDocCodeBlockParserOptions {
+    /**
+     * Whether a fragment after the `file` parameter may name a snippet: `file="./x.ts"#greeting`.
+     * Without it, only line ranges are accepted, and any other fragment fails to parse.
+     */
+    snippets?: boolean;
+}
 /**
  * Code block options parser
  * @param options - Options string to parse
+ * @param parserOptions - What the caller supports beyond the original syntax.
  */
-export declare function parseCodeBlockParams(options: string): NgDocCodeBlockParams;
+export declare function parseCodeBlockParams(options: string, parserOptions?: NgDocCodeBlockParserOptions): NgDocCodeBlockParams;

package/parsers/parse-code-block-params.js

@@ -2,41 +2,73 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCodeBlockParams = parseCodeBlockParams;
 const tslib_1 = require("tslib");
-const P = tslib_1.__importStar(require("parsimmon"));
+const parsimmon_1 = tslib_1.__importDefault(require("parsimmon"));
 const helpers_1 = require("./helpers");
+/**
+ * A code block language: a Shiki language id or alias. Besides letters and dashes, they use digits
+ * (`f90`, `1c`), `+` and `#` (`c++`, `c#`, `f#`) and other scripts (`文言`). Quotes, `=`, braces and
+ * whitespace end it, so the parameters that follow are parsed as before.
+ */
+const CODE_BLOCK_LANGUAGE = /[\p{L}\p{N}+#-]+/u;
+/** The characters of a snippet id, as `// snippet#<id>` markers spell it (`parseSnippet`). */
+const SNIPPET_ID = /[a-zA-Z0-9-]+/;
+/** A fragment that is a line range: `L<n>`, `L<n>-` or `L<n>-L<m>`. */
+const LINE_RANGE = /^L(\d+)(?:(-)(?:L(\d+))?)?$/;
+/**
+ * The fragment after a `file` parameter when snippets are on: `#L<n>`, `#L<n>-` and
+ * `#L<n>-L<m>` are line ranges (the same ranges as without snippets), any other id names a
+ * snippet.
+ * @param fragment - The fragment without its `#`.
+ */
+function fileFragment(fragment) {
+    const range = LINE_RANGE.exec(fragment);
+    if (!range)
+        return { snippet: fragment };
+    const fileLineStart = Number(range[1]) - 1;
+    if (!range[2])
+        return { fileLineStart, fileLineEnd: fileLineStart + 1 };
+    return { fileLineStart, fileLineEnd: range[3] === undefined ? undefined : Number(range[3]) };
+}
 /**
  * Code block options parser
  * @param options - Options string to parse
+ * @param parserOptions - What the caller supports beyond the original syntax.
  */
-function parseCodeBlockParams(options) {
-    const parser = P.createLanguage({
-        language: () => P.regexp(/[a-zA-Z-]+/)
-            .skip(P.optWhitespace)
+function parseCodeBlockParams(options, parserOptions = {}) {
+    const parser = parsimmon_1.default.createLanguage({
+        language: () => parsimmon_1.default.regexp(CODE_BLOCK_LANGUAGE)
+            .skip(parsimmon_1.default.optWhitespace)
             .map((language) => ({ language })),
         // File Parsers
-        fileLineNumber: () => P.string('L').then(P.digits).map(Number),
-        fileLineRange: (p) => P.seqMap(P.string('#')
+        fileLineNumber: () => parsimmon_1.default.string('L').then(parsimmon_1.default.digits).map(Number),
+        fileLineRange: (p) => parsimmon_1.default.seqMap(parsimmon_1.default.string('#')
             .then(p['fileLineNumber'])
-            .map((num) => num - 1), P.string('-').then(p['fileLineNumber'].fallback(undefined)), (fileLineStart, fileLineEnd) => ({ fileLineStart, fileLineEnd })),
-        fileLineStart: (p) => P.string('#')
+            .map((num) => num - 1), parsimmon_1.default.string('-').then(p['fileLineNumber'].fallback(undefined)), (fileLineStart, fileLineEnd) => ({ fileLineStart, fileLineEnd })),
+        fileLineStart: (p) => parsimmon_1.default.string('#')
             .then(p['fileLineNumber'])
             .map((num) => num - 1)
             .map((fileLineStart) => ({ fileLineStart, fileLineEnd: fileLineStart + 1 })),
-        lineParams: (p) => p['fileLineRange'].or(p['fileLineStart']).fallback({}),
-        highlightedLinesRange: () => P.seqMap(helpers_1.number.skip(P.string('-')), helpers_1.number, (start, end) => [...Array(end + 1).keys()].slice(start - end - 1)),
+        lineParams: (p) => (parserOptions.snippets
+            ? parsimmon_1.default.string('#').then(parsimmon_1.default.regexp(SNIPPET_ID)).map(fileFragment)
+            : p['fileLineRange'].or(p['fileLineStart'])).fallback({}),
+        highlightedLinesRange: () => parsimmon_1.default.seqMap(helpers_1.number.skip(parsimmon_1.default.string('-')), helpers_1.number, (start, end) => [...Array(end + 1).keys()].slice(start - end - 1)),
         // Main Parsers
-        lineNumbers: () => P.string('lineNumbers').map(() => ({ lineNumbers: true })),
+        lineNumbers: () => parsimmon_1.default.string('lineNumbers').map(() => ({ lineNumbers: true })),
         filePath: () => (0, helpers_1.param)('file'),
         name: () => (0, helpers_1.param)('name'),
         group: () => (0, helpers_1.param)('group'),
         fileName: () => (0, helpers_1.param)('fileName', 'name'),
         icon: () => (0, helpers_1.param)('icon'),
-        active: () => P.string('active').map(() => ({ active: true })),
-        file: (p) => P.seq(p['filePath'], p['lineParams'].map(({ fileLineStart, fileLineEnd }) => ({ fileLineStart, fileLineEnd }))).map(([file, lineParams]) => ({ ...file, ...lineParams })),
+        active: () => parsimmon_1.default.string('active').map(() => ({ active: true })),
+        file: (p) => parsimmon_1.default.seq(p['filePath'], p['lineParams'].map(({ fileLineStart, fileLineEnd, snippet }) => ({
+            fileLineStart,
+            fileLineEnd,
+            ...(snippet === undefined ? {} : { snippet }),
+        }))).map(([file, lineParams]) => ({ ...file, ...lineParams })),
         highlightedLines: (p) => p['highlightedLinesRange']
             .or(helpers_1.number)
-            .sepBy(P.string(',').then(P.optWhitespace))
-            .wrap(P.string('{'), P.string('}'))
+            .sepBy(parsimmon_1.default.string(',').then(parsimmon_1.default.optWhitespace))
+            .wrap(parsimmon_1.default.string('{'), parsimmon_1.default.string('}'))
             .map((a) => Array.from(new Set(a.flat())))
             .map((highlightedLines) => ({ highlightedLines })),
         // Combined Parsers
@@ -48,8 +80,8 @@ function parseCodeBlockParams(options) {
             .or(p['active'])
             .or(p['icon'])
             .or(p['highlightedLines'])
-            .sepBy(P.whitespace),
-        languageWithParamsParser: (p) => P.seq(p['language'], p['paramsParser']).map((v) => v.flat()),
+            .sepBy(parsimmon_1.default.whitespace),
+        languageWithParamsParser: (p) => parsimmon_1.default.seq(p['language'], p['paramsParser']).map((v) => v.flat()),
     });
     let result = parser['paramsParser'].parse(options);
     if (result.status) {

package/parsers/parse-code-block-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-code-block-params.js","sourceRoot":"","sources":["../../../../libs/builder/parsers/parse-code-block-params.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse-code-block-params.js","sourceRoot":"","sources":["../../../../libs/builder/parsers/parse-code-block-params.ts"],"names":[],"mappings":"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"}

package/parsers/parse-snippet.js

@@ -2,31 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSnippet = parseSnippet;
 const tslib_1 = require("tslib");
-const P = tslib_1.__importStar(require("parsimmon"));
+const parsimmon_1 = tslib_1.__importDefault(require("parsimmon"));
 const helpers_1 = require("./helpers");
 /**
  *
  * @param string - string to parse
  */
 function parseSnippet(string) {
-    const parser = P.createLanguage({
-        keyword: () => P.string('snippet'),
-        id: () => P.string('#')
-            .then(P.regexp(/[a-zA-Z0-9-]+/))
+    const parser = parsimmon_1.default.createLanguage({
+        keyword: () => parsimmon_1.default.string('snippet'),
+        id: () => parsimmon_1.default.string('#')
+            .then(parsimmon_1.default.regexp(/[a-zA-Z0-9-]+/))
             .fallback(null)
             .map((id) => ({ id })),
-        lang: () => P.string(':')
-            .then(P.regexp(/[a-zA-Z0-9-]+/))
+        lang: () => parsimmon_1.default.string(':')
+            .then(parsimmon_1.default.regexp(/[a-zA-Z0-9-]+/))
             .fallback(undefined)
             .map((lang) => ({ lang })),
         icon: () => (0, helpers_1.param)('icon'),
         title: () => (0, helpers_1.paramValue)().map((title) => ({ title })),
-        opened: () => P.string('opened')
+        opened: () => parsimmon_1.default.string('opened')
             .result(true)
             .fallback(undefined)
             .map((opened) => ({ opened })),
-        snippet: ({ keyword, id, lang, icon, title, opened }) => keyword.then(P.seq(id, lang, P.whitespace.then(title.or(icon).or(opened).sepBy(P.whitespace)).fallback([])).map(([id, lang, rest]) => ({ ...id, ...lang, ...Object.assign({}, ...rest) }))),
-        snippetFromFile: ({ lang, icon, title, opened }) => P.seq((0, helpers_1.param)('snippet-from-file', 'fromFile'), lang, P.whitespace.then(title.or(icon).or(opened).sepBy(P.whitespace)).fallback([])).map(([id, lang, rest]) => ({ ...id, ...lang, ...Object.assign({}, ...rest) })),
+        snippet: ({ keyword, id, lang, icon, title, opened }) => keyword.then(parsimmon_1.default.seq(id, lang, parsimmon_1.default.whitespace.then(title.or(icon).or(opened).sepBy(parsimmon_1.default.whitespace)).fallback([])).map(([id, lang, rest]) => ({ ...id, ...lang, ...Object.assign({}, ...rest) }))),
+        snippetFromFile: ({ lang, icon, title, opened }) => parsimmon_1.default.seq((0, helpers_1.param)('snippet-from-file', 'fromFile'), lang, parsimmon_1.default.whitespace.then(title.or(icon).or(opened).sepBy(parsimmon_1.default.whitespace)).fallback([])).map(([id, lang, rest]) => ({ ...id, ...lang, ...Object.assign({}, ...rest) })),
         anySnippet: ({ snippet, snippetFromFile }) => snippetFromFile.or(snippet),
     });
     const result = parser.anySnippet.parse(string);

package/parsers/parse-snippet.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-snippet.js","sourceRoot":"","sources":["../../../../libs/builder/parsers/parse-snippet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse-snippet.js","sourceRoot":"","sources":["../../../../libs/builder/parsers/parse-snippet.ts"],"names":[],"mappings":"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"}

package/schematics/collection.json

@@ -1,25 +1,36 @@
 {
-	"$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
-	"schematics": {
-		"category": {
-			"description": "Generates NgDoc Category entity",
-			"factory": "./category/index#generate",
-			"schema": "./category/schema.json"
-		},
-		"page": {
-			"description": "Generates NgDoc Page entity",
-			"factory": "./page/index#generate",
-			"schema": "./page/schema.json"
-		},
-		"api": {
-			"description": "Generates NgDoc API entity",
-			"factory": "./api/index#generate",
-			"schema": "./api/schema.json"
-		},
-		"standalone-pages-migration": {
-			"description": "Moves all dependencies from ng-doc.dependencies.ts to ng-doc.page.ts",
-			"factory": "./migrations/standalone-pages/index#migrate",
-			"schema": "./migrations/standalone-pages/schema.json"
-		}
-	}
+  "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "category": {
+      "description": "Generates NgDoc Category entity",
+      "factory": "./category/index#generate",
+      "schema": "./category/schema.json"
+    },
+    "page": {
+      "description": "Generates NgDoc Page entity",
+      "factory": "./page/index#generate",
+      "schema": "./page/schema.json"
+    },
+    "api": {
+      "description": "Generates NgDoc API entity",
+      "factory": "./api/index#generate",
+      "schema": "./api/schema.json"
+    },
+    "migrate-to-vite": {
+      "description": "Moves a project from the legacy NgDoc builders to the Vite engine (or back with --revert)",
+      "factory": "./migrate-to-vite/index#migrateToVite",
+      "schema": "./migrate-to-vite/schema.json"
+    },
+    "vite-setup": {
+      "description": "Sets up the Vite engine for a project on Angular's application builder or Nx's application executor (run by ng add @ng-doc/add)",
+      "factory": "./vite-setup/index#viteSetup",
+      "schema": "./vite-setup/schema.json",
+      "hidden": true
+    },
+    "standalone-pages-migration": {
+      "description": "Moves all dependencies from ng-doc.dependencies.ts to ng-doc.page.ts",
+      "factory": "./migrations/standalone-pages/index#migrate",
+      "schema": "./migrations/standalone-pages/schema.json"
+    }
+  }
 }