@ng-doc/builder 22.0.0 → 22.1.0

package/generator/build-provenance.json

@@ -1,8 +1,8 @@
 {
   "compilerVersion": "0.0.1",
-  "toolchainDigest": "a837a4b43736f6b95b5565f442aa62d2f2175fb549d7a44138d2955d465c9ac3",
-  "sourceDigest": "1841ad43df17a74fa1cd6499a5f1596553cd6f47e4b963e56ced0bd91aa88356",
-  "lockfileDigest": "65e081894c996e101a7c05e349275c3fd0367a5ad92843c049d452d55b8ca67c",
+  "toolchainDigest": "d3b66d41f47865fb003a881897f703f6b49568eefa8f301d410768b97f5647e2",
+  "sourceDigest": "1a038ca999385c919ea565f867343af2f42f244061951c14649d551b1082c31d",
+  "lockfileDigest": "de382fb15a8f808000ec7fba99c68f6b8329faa07755202f04ac25d0f1c8ef64",
   "tuple": {
     "@angular-devkit/architect": "0.2202.1",
     "@angular-devkit/core": "22.2.1",
@@ -13,7 +13,7 @@
     "@orama/plugin-parsedoc": "2.0.17",
     "@parcel/watcher": "2.6.0",
     "@prettier/sync": "0.5.2",
-    "@shikijs/rehype": "1.10.3",
+    "@shikijs/rehype": "4.5.0",
     "cosmiconfig": "8.2.0",
     "cosmiconfig-typescript-loader": "5.0.0",
     "css-what": "6.1.0",
@@ -43,6 +43,7 @@
     "rehype-parse": "9.0.0",
     "rehype-stringify": "10.0.1",
     "rxjs": "7.8.2",
+    "shiki": "4.5.0",
     "stringify-entities": "4.0.4",
     "tinyglobby": "0.2.17",
     "ts-morph": "28.0.0",
@@ -85,6 +86,7 @@
     "rehype-parse",
     "rehype-stringify",
     "rxjs",
+    "shiki",
     "stringify-entities",
     "tinyglobby",
     "ts-morph",

package/generator/compiler/index.d.ts

@@ -79,6 +79,25 @@ export interface CompilationOptions {
      * `CONTENT_HIGHLIGHT_CACHE_MISMATCH` when it differs.
      */
     highlightCache?: boolean | 'verify';
+    /**
+     * The cache of formatted code (`content/format-cache.ts`): a generation resolves the Prettier
+     * configuration once, and API signatures and demo snippets whose code, parser, configuration and
+     * Prettier release were formatted before reuse that result. Development generations with the
+     * artifact cache keep it beside the cache; production, `cache: false` and the reference path
+     * (`incrementalReuse: false`, which formats every call) keep none. On by default; `false`, like
+     * `NGDOC_FORMAT_CACHE=0`, formats every call as before. `verify` (or the environment's `verify`)
+     * also resolves and formats every hit again, uses that result and reports
+     * `CONTENT_FORMAT_CACHE_MISMATCH` when one differs.
+     */
+    formatCache?: boolean | 'verify';
+    /**
+     * Highlighting loads only the Shiki grammars that the languages of code blocks reach, into one
+     * highlighter per thread and theme pair, instead of every bundled grammar (which takes seconds);
+     * the HTML is the same (`@ng-doc/utils` `processHtml`'s `grammars: 'used'`). Projects with
+     * `shiki.langs` load every grammar. On by default; `false`, like `NGDOC_USED_GRAMMARS=0`, loads
+     * every grammar.
+     */
+    usedGrammars?: boolean;
     /**
      * Parallel rendering (`content/html-pool.ts`): a large generation runs the HTML pipeline of its
      * content (highlighting, anchors, keyword links, search records) on render threads, while the
@@ -107,5 +126,6 @@ export interface TargetedCompilationService extends CompilationService {
  * A compile runs its phases in order (discovery, semantic, setup, describe, plan, render, keywords,
  * link, assembly, aggregate, validation): each phase records what it emits per unit or globally,
  * and every exit folds those records into its result (`./fold`).
+ * @param options
  */
 export declare function createCompilationService(options: CompilationOptions): TargetedCompilationService;