@ng-doc/app 22.0.0 → 22.2.0

package/fesm2022/ng-doc-app-processors-processors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-processors-processors.mjs","sources":["../../../../libs/app/processors/processors/blockquote.processor.ts","../../../../libs/app/processors/processors/code.processor.ts","../../../../libs/app/processors/processors/demo.processor.ts","../../../../libs/app/processors/processors/demo-pane.processor.ts","../../../../libs/app/processors/processors/heading-anchor.processor.ts","../../../../libs/app/processors/processors/icon.processor.ts","../../../../libs/app/processors/processors/image.processor.ts","../../../../libs/app/processors/processors/members.processor.ts","../../../../libs/app/processors/processors/mermaid.processor.ts","../../../../libs/app/processors/processors/playground.processor.ts","../../../../libs/app/processors/processors/tabs.processor.ts","../../../../libs/app/processors/processors/ng-doc-app-processors-processors.ts"],"sourcesContent":["import { NgDocPageProcessor } from '@ng-doc/app/interfaces';\nimport { NgDocBlockquoteComponent, NgDocBlockquoteType } from '@ng-doc/ui-kit';\n\nexport const blockquoteProcessor: NgDocPageProcessor<NgDocBlockquoteComponent> = {\n  component: NgDocBlockquoteComponent,\n  selector: 'ng-doc-blockquote',\n  extractOptions: (element: Element) => ({\n    content: [Array.from(element.childNodes)],\n    inputs: {\n      type: (element.getAttribute('type') as NgDocBlockquoteType) || 'default',\n      icon: element.getAttribute('icon') ?? undefined,\n      label: element.getAttribute('label') ?? undefined,\n    },\n  }),\n};\n","import { NgDocCodeComponent } from '@ng-doc/app/components/code';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const codeProcessor: NgDocPageProcessor<NgDocCodeComponent> = {\n  component: NgDocCodeComponent,\n  selector: 'pre code',\n  nodeToReplace: (element: Element) => element.closest('pre') ?? element,\n  extractOptions: (element: Element) => ({\n    inputs: {\n      name: element.parentElement?.getAttribute('name') || undefined,\n      icon: element.parentElement?.getAttribute('icon') || undefined,\n    },\n    content: [[element.closest('pre') ?? element]],\n  }),\n};\n","import { NgDocDemoComponent } from '@ng-doc/app/components/demo';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const demoProcessor: NgDocPageProcessor<NgDocDemoComponent> = {\n  component: NgDocDemoComponent,\n  selector: 'ng-doc-demo',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      componentName: element.getAttribute('componentName') || undefined,\n      options: JSON.parse(element.querySelector('#options')?.textContent ?? '{}'),\n    },\n  }),\n};\n","import { NgDocDemoPaneComponent } from '@ng-doc/app/components/demo-pane';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const demoPaneProcessor: NgDocPageProcessor<NgDocDemoPaneComponent> = {\n\tcomponent: NgDocDemoPaneComponent,\n\tselector: 'ng-doc-demo-pane',\n\textractOptions: (element: Element) => ({\n\t\tinputs: {\n\t\t\tcomponentName: element.getAttribute('componentName') || undefined,\n\t\t\toptions: JSON.parse(element.querySelector('#options')?.textContent ?? '') || {},\n\t\t},\n\t}),\n};\n","import { NgDocHeadingAnchorComponent } from '@ng-doc/app/components/heading-anchor';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const headingAnchorProcessor: NgDocPageProcessor<NgDocHeadingAnchorComponent> = {\n  component: NgDocHeadingAnchorComponent,\n  selector: 'ng-doc-heading-anchor',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      classes: element.getAttribute('class')?.split(' ') || [],\n      anchor: element.getAttribute('anchor') || '',\n    },\n  }),\n};\n","import { NgDocPageProcessor } from '@ng-doc/app/interfaces';\nimport { NgDocIconComponent, NgDocIconSize } from '@ng-doc/ui-kit';\n\nexport const iconProcessor: NgDocPageProcessor<NgDocIconComponent> = {\n\tcomponent: NgDocIconComponent,\n\tselector: 'ng-doc-icon',\n\textractOptions: (element: Element) => ({\n\t\tinputs: {\n\t\t\ticon: element.getAttribute('icon') ?? '',\n\t\t\tsize: (Number(element.getAttribute('size')) as NgDocIconSize) || 16,\n\t\t},\n\t}),\n};\n","import { Injector, Renderer2 } from '@angular/core';\nimport { NgDocImageViewerComponent } from '@ng-doc/app/components/image-viewer';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const imageProcessor: NgDocPageProcessor<NgDocImageViewerComponent> = {\n  component: NgDocImageViewerComponent,\n  selector: 'img:not([zoom=\"false\"])',\n  nodeToReplace: (element: Element, injector: Injector) => {\n    const renderer: Renderer2 = injector.get(Renderer2);\n    const anchor: Element = renderer.createElement('div');\n\n    return element.parentNode?.insertBefore(anchor, element) ?? element;\n  },\n  extractOptions: (element: Element) => ({\n    inputs: {\n      src: element.getAttribute('src') ?? '',\n      alt: element.getAttribute('alt') ?? '',\n    },\n    content: [[element]],\n  }),\n};\n","import { NgDocMembersComponent } from '@ng-doc/app/components/members';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\n/** Adds the member filter to the members table of an API page (`<ng-doc-members>`). */\nexport const membersProcessor: NgDocPageProcessor<NgDocMembersComponent> = {\n  component: NgDocMembersComponent,\n  selector: 'ng-doc-members',\n  extractOptions: (element: Element) => ({\n    content: [Array.from(element.childNodes)],\n  }),\n};\n","import { NgDocMermaidViewerComponent } from '@ng-doc/app/components/mermaid-viewer';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const mermaidProcessor: NgDocPageProcessor<NgDocMermaidViewerComponent> = {\n  component: NgDocMermaidViewerComponent,\n  selector: 'pre.mermaid',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      graph: element.textContent ?? '',\n    },\n  }),\n};\n","import { NgDocPlaygroundComponent } from '@ng-doc/app/components/playground';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\nimport { isPresent } from '@ng-doc/core/helpers/is-present';\n\nexport const playgroundProcessor: NgDocPageProcessor<NgDocPlaygroundComponent> = {\n  component: NgDocPlaygroundComponent,\n  selector: 'ng-doc-playground',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      id: element.getAttribute('id') || undefined,\n      properties:\n        JSON.parse(element.querySelector('#data')?.textContent?.replace(/\\n/g, '\\\\n') ?? '') ||\n        undefined,\n      pipeName: element.querySelector('#pipeName')?.textContent || undefined,\n      selectors: (element.querySelector('#selectors')?.textContent || '')\n        .split(',')\n        .map((selector: string) => selector.trim())\n        .filter(isPresent),\n      options: JSON.parse(element.querySelector('#options')?.textContent ?? '') || {},\n    },\n  }),\n};\n","import { Injector, Renderer2 } from '@angular/core';\nimport { NgDocTabsComponent } from '@ng-doc/app/components/tabs';\nimport { NgDocPageProcessor, NgDocTab } from '@ng-doc/app/interfaces';\n\nexport const tabsProcessor: NgDocPageProcessor<NgDocTabsComponent> = {\n\tcomponent: NgDocTabsComponent,\n\tselector: 'ng-doc-tab',\n\tnodeToReplace: (element: Element, injector: Injector) => {\n\t\tconst renderer: Renderer2 = injector.get(Renderer2);\n\t\tconst anchor: Element = renderer.createElement('div');\n\n\t\treturn element.parentNode?.insertBefore(anchor, element) ?? element;\n\t},\n\textractOptions: (element: Element, root: Element) => {\n\t\tconst group: string | null = element.getAttribute('group') ?? '';\n\t\tconst tabs: Element[] = Array.from(root.querySelectorAll(`ng-doc-tab[group=\"${group}\"]`));\n\t\tconst mappedTabs: NgDocTab[] = tabs.map((tab: Element) => ({\n\t\t\ttitle: tab.getAttribute('name') ?? '',\n\t\t\tcontent: tab,\n\t\t\ticon: tab.getAttribute('icon') || undefined,\n\t\t\tactive: tab.hasAttribute('active'),\n\t\t}));\n\n\t\ttabs.forEach((tab: Element) => tab.remove());\n\n\t\treturn {\n\t\t\tinputs: {\n\t\t\t\ttabs: mappedTabs,\n\t\t\t},\n\t\t};\n\t},\n};\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ng-doc-app-processors-processors.mjs","sources":["../../../../libs/app/processors/processors/blockquote.processor.ts","../../../../libs/app/processors/processors/code.processor.ts","../../../../libs/app/processors/processors/demo.processor.ts","../../../../libs/app/processors/processors/demo-pane.processor.ts","../../../../libs/app/processors/processors/heading-anchor.processor.ts","../../../../libs/app/processors/processors/icon.processor.ts","../../../../libs/app/processors/processors/image.processor.ts","../../../../libs/app/processors/processors/members.processor.ts","../../../../libs/app/processors/processors/mermaid.processor.ts","../../../../libs/app/processors/processors/playground.processor.ts","../../../../libs/app/processors/processors/tabs.processor.ts","../../../../libs/app/processors/processors/ng-doc-app-processors-processors.ts"],"sourcesContent":["import { NgDocPageProcessor } from '@ng-doc/app/interfaces';\nimport { NgDocBlockquoteComponent, NgDocBlockquoteType } from '@ng-doc/ui-kit';\n\nexport const blockquoteProcessor: NgDocPageProcessor<NgDocBlockquoteComponent> = {\n  component: NgDocBlockquoteComponent,\n  selector: 'ng-doc-blockquote',\n  extractOptions: (element: Element) => ({\n    content: [Array.from(element.childNodes)],\n    inputs: {\n      type: (element.getAttribute('type') as NgDocBlockquoteType) || 'default',\n      icon: element.getAttribute('icon') ?? undefined,\n      label: element.getAttribute('label') ?? undefined,\n    },\n  }),\n};\n","import { NgDocCodeComponent } from '@ng-doc/app/components/code';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const codeProcessor: NgDocPageProcessor<NgDocCodeComponent> = {\n  component: NgDocCodeComponent,\n  selector: 'pre code',\n  nodeToReplace: (element: Element) => element.closest('pre') ?? element,\n  extractOptions: (element: Element) => ({\n    inputs: {\n      name: element.parentElement?.getAttribute('name') || undefined,\n      icon: element.parentElement?.getAttribute('icon') || undefined,\n    },\n    content: [[element.closest('pre') ?? element]],\n  }),\n};\n","import { NgDocDemoComponent } from '@ng-doc/app/components/demo';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const demoProcessor: NgDocPageProcessor<NgDocDemoComponent> = {\n  component: NgDocDemoComponent,\n  selector: 'ng-doc-demo',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      componentName: element.getAttribute('componentName') || undefined,\n      options: JSON.parse(element.querySelector('#options')?.textContent ?? '{}'),\n    },\n  }),\n};\n","import { NgDocDemoPaneComponent } from '@ng-doc/app/components/demo-pane';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const demoPaneProcessor: NgDocPageProcessor<NgDocDemoPaneComponent> = {\n\tcomponent: NgDocDemoPaneComponent,\n\tselector: 'ng-doc-demo-pane',\n\textractOptions: (element: Element) => ({\n\t\tinputs: {\n\t\t\tcomponentName: element.getAttribute('componentName') || undefined,\n\t\t\toptions: JSON.parse(element.querySelector('#options')?.textContent ?? '') || {},\n\t\t},\n\t}),\n};\n","import { NgDocHeadingAnchorComponent } from '@ng-doc/app/components/heading-anchor';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const headingAnchorProcessor: NgDocPageProcessor<NgDocHeadingAnchorComponent> = {\n  component: NgDocHeadingAnchorComponent,\n  selector: 'ng-doc-heading-anchor',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      classes: element.getAttribute('class')?.split(' ') || [],\n      anchor: element.getAttribute('anchor') || '',\n    },\n  }),\n};\n","import { NgDocPageProcessor } from '@ng-doc/app/interfaces';\nimport { NgDocIconComponent, NgDocIconSize } from '@ng-doc/ui-kit';\n\nexport const iconProcessor: NgDocPageProcessor<NgDocIconComponent> = {\n\tcomponent: NgDocIconComponent,\n\tselector: 'ng-doc-icon',\n\textractOptions: (element: Element) => ({\n\t\tinputs: {\n\t\t\ticon: element.getAttribute('icon') ?? '',\n\t\t\tsize: (Number(element.getAttribute('size')) as NgDocIconSize) || 16,\n\t\t},\n\t}),\n};\n","import { Injector, Renderer2 } from '@angular/core';\nimport { NgDocImageViewerComponent } from '@ng-doc/app/components/image-viewer';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const imageProcessor: NgDocPageProcessor<NgDocImageViewerComponent> = {\n  component: NgDocImageViewerComponent,\n  selector: 'img:not([zoom=\"false\"])',\n  nodeToReplace: (element: Element, injector: Injector) => {\n    const renderer: Renderer2 = injector.get(Renderer2);\n    const anchor: Element = renderer.createElement('div');\n\n    return element.parentNode?.insertBefore(anchor, element) ?? element;\n  },\n  extractOptions: (element: Element) => ({\n    inputs: {\n      src: element.getAttribute('src') ?? '',\n      alt: element.getAttribute('alt') ?? '',\n    },\n    content: [[element]],\n  }),\n};\n","import { NgDocMembersComponent } from '@ng-doc/app/components/members';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\n/** Adds the member filter to the members table of an API page (`<ng-doc-members>`). */\nexport const membersProcessor: NgDocPageProcessor<NgDocMembersComponent> = {\n  component: NgDocMembersComponent,\n  selector: 'ng-doc-members',\n  extractOptions: (element: Element) => ({\n    content: [Array.from(element.childNodes)],\n  }),\n};\n","import { NgDocMermaidViewerComponent } from '@ng-doc/app/components/mermaid-viewer';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\n\nexport const mermaidProcessor: NgDocPageProcessor<NgDocMermaidViewerComponent> = {\n  component: NgDocMermaidViewerComponent,\n  selector: 'pre.mermaid',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      graph: element.textContent ?? '',\n    },\n  }),\n};\n","import { NgDocPlaygroundComponent } from '@ng-doc/app/components/playground';\nimport { NgDocPageProcessor } from '@ng-doc/app/interfaces';\nimport { isPresent } from '@ng-doc/core/helpers/is-present';\n\nexport const playgroundProcessor: NgDocPageProcessor<NgDocPlaygroundComponent> = {\n  component: NgDocPlaygroundComponent,\n  selector: 'ng-doc-playground',\n  extractOptions: (element: Element) => ({\n    inputs: {\n      id: element.getAttribute('id') || undefined,\n      properties:\n        JSON.parse(element.querySelector('#data')?.textContent?.replace(/\\n/g, '\\\\n') ?? '') ||\n        undefined,\n      pipeName: element.querySelector('#pipeName')?.textContent || undefined,\n      selectors: (element.querySelector('#selectors')?.textContent || '')\n        .split(',')\n        .map((selector: string) => selector.trim())\n        .filter(isPresent),\n      options: JSON.parse(element.querySelector('#options')?.textContent ?? '') || {},\n    },\n  }),\n};\n","import { Injector, Renderer2 } from '@angular/core';\nimport { NgDocTabsComponent } from '@ng-doc/app/components/tabs';\nimport { NgDocPageProcessor, NgDocTab } from '@ng-doc/app/interfaces';\n\n/**\n * Turns the `<ng-doc-tab group=\"…\" name=\"…\">` elements of a page into tabs: every tab of a group\n * becomes one `NgDocTabsComponent`, where the first tab of the group was. Code groups are made of\n * them, and Markdown can wrap any content in them.\n */\nexport const tabsProcessor: NgDocPageProcessor<NgDocTabsComponent> = {\n  component: NgDocTabsComponent,\n  selector: 'ng-doc-tab',\n  nodeToReplace: (element: Element, injector: Injector) => {\n    const renderer: Renderer2 = injector.get(Renderer2);\n    const anchor: Element = renderer.createElement('div');\n\n    return element.parentNode?.insertBefore(anchor, element) ?? element;\n  },\n  extractOptions: (element: Element, root: Element) => {\n    const group: string = element.getAttribute('group') ?? '';\n    const tabs: Element[] = Array.from(root.querySelectorAll('ng-doc-tab')).filter(\n      (tab: Element) => (tab.getAttribute('group') ?? '') === group,\n    );\n\n    if (!tabs.includes(element)) {\n      tabs.unshift(element);\n    }\n\n    // The tabs stay on the page until the component first renders (`NgDocTabsComponent`), so\n    // the processors after this one, the page's own included, still reach their content. The\n    // page processor skips elements that have left the page, so the other tabs of the group are\n    // swapped for copies that hold their content: otherwise each would get tabs of its own.\n    const contents: Element[] = tabs.map((tab: Element) => {\n      if (tab === element || !tab.parentNode) {\n        return tab;\n      }\n\n      const copy: Element = tab.cloneNode(false) as Element;\n\n      while (tab.firstChild) {\n        copy.appendChild(tab.firstChild);\n      }\n      tab.parentNode.replaceChild(copy, tab);\n\n      return copy;\n    });\n\n    return {\n      inputs: {\n        tabs: tabs.map((tab: Element, index: number) => ({\n          title: tab.getAttribute('name') ?? '',\n          content: contents[index],\n          icon: tab.getAttribute('icon') || undefined,\n          active: tab.hasAttribute('active'),\n        })) satisfies NgDocTab[],\n      },\n    };\n  },\n};\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/ng-doc-app-providers-ng-doc-app.mjs

@@ -1,6 +1,7 @@
-import { isPlatformBrowser, ViewportScroller } from '@angular/common';
-import { provideAppInitializer, inject, PLATFORM_ID, DOCUMENT } from '@angular/core';
+import { isPlatformBrowser } from '@angular/common';
+import { provideEnvironmentInitializer, inject, PLATFORM_ID, DOCUMENT, PendingTasks } from '@angular/core';
 import { ɵcaptureNgDocHydrationSnapshots as _captureNgDocHydrationSnapshots } from '@ng-doc/app/helpers';
+import { NgDocApiListIndexService } from '@ng-doc/app/services';
 import { NgDocContentScrollIntent } from '@ng-doc/app/services/content-scroll-intent';
 import { NgDocHighlighterService } from '@ng-doc/app/services/highlighter';
 import { NG_DOC_SHORTCUTS, NgDocShortcutsService } from '@ng-doc/app/services/shortcuts';
@@ -9,6 +10,12 @@ import { provideNgDocUiKitConfig } from '@ng-doc/ui-kit';
 
 /**
  * Provides the NgDoc application configuration.
+ *
+ * Add it to the application's providers, or to the `providers` of the route that holds the
+ * documentation, together with the other NgDoc providers: then NgDoc starts only when the reader
+ * opens the documentation, and its code stays out of the application's initial bundle. It starts
+ * with environment initializers, which run where it is provided. The server render waits until
+ * the code highlighter of playgrounds has loaded.
  * @param config - The optional application configuration.
  */
 function provideNgDocApp(config) {
@@ -18,33 +25,37 @@ function provideNgDocApp(config) {
             provide: NG_DOC_CONTENT_SCROLL_POSITION_RESTORATION,
             useValue: config?.contentScrollPositionRestoration ?? 'disabled',
         },
+        { provide: NG_DOC_SHORTCUTS, useValue: config?.shortcuts ?? true },
+        /* --- Services --- */
+        // Provided where the configuration is, so that they read the NgDoc providers of a lazy route
+        // (the generated context, the shortcuts option): an instance in the root injector could not
+        // see them. In the root injector this is the instance `providedIn: 'root'` gives.
+        NgDocHighlighterService,
+        NgDocShortcutsService,
+        NgDocApiListIndexService,
         ...(config?.contentAnchorScrolling || config?.contentScrollPositionRestoration === 'enabled'
             ? [
-                provideAppInitializer(() => {
+                provideEnvironmentInitializer(() => {
                     inject(NgDocContentScrollIntent).start();
                 }),
             ]
             : []),
         /* --- Hydration --- */
-        // Before the application renders: the pages and headers that skip hydration show their
-        // server-rendered content until their own is rendered, instead of a blank page.
-        provideAppInitializer(() => {
+        // Before the documentation renders: the pages and headers that skip hydration show their
+        // server-rendered content until their own is rendered, instead of a blank page. A lazy route
+        // creates its injector before it creates its components, so this also runs in time when the
+        // documentation is the first route the browser hydrates.
+        provideEnvironmentInitializer(() => {
             if (isPlatformBrowser(inject(PLATFORM_ID)))
                 _captureNgDocHydrationSnapshots(inject(DOCUMENT));
         }),
-        /* --- Keyboard shortcuts --- */
-        { provide: NG_DOC_SHORTCUTS, useValue: config?.shortcuts ?? true },
-        // Created at start-up so the built-in shortcuts work on every page.
-        provideAppInitializer(() => {
-            inject(NgDocShortcutsService);
-        }),
-        /* --- Viewport Scroller --- */
-        provideAppInitializer(() => {
-            inject(ViewportScroller).setOffset([0, 120]);
-        }),
         /* --- Shiki --- */
-        provideAppInitializer(async () => {
-            await inject(NgDocHighlighterService).initialize(config?.shiki);
+        // Started with the documentation instead of blocking the application's start: the playgrounds
+        // highlight their code once it is ready, and the application stays unstable until then, so the
+        // server renders the highlighted code.
+        provideEnvironmentInitializer(() => {
+            const highlighter = inject(NgDocHighlighterService);
+            inject(PendingTasks).run(() => highlighter.initialize(config?.shiki));
         }),
         /* --- UiKit --- */
         ...provideNgDocUiKitConfig(config?.uiKit),

package/fesm2022/ng-doc-app-providers-ng-doc-app.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-providers-ng-doc-app.mjs","sources":["../../../../libs/app/providers/ng-doc-app/provide-ng-doc-app.ts","../../../../libs/app/providers/ng-doc-app/ng-doc-app-providers-ng-doc-app.ts"],"sourcesContent":["import { isPlatformBrowser, ViewportScroller } from '@angular/common';\nimport {\n  DOCUMENT,\n  EnvironmentProviders,\n  inject,\n  PLATFORM_ID,\n  provideAppInitializer,\n  Provider,\n} from '@angular/core';\nimport { ɵcaptureNgDocHydrationSnapshots } from '@ng-doc/app/helpers';\nimport { NgDocContentScrollIntent } from '@ng-doc/app/services/content-scroll-intent';\nimport type { NgDocHighlighterConfig } from '@ng-doc/app/services/highlighter';\nimport { NgDocHighlighterService } from '@ng-doc/app/services/highlighter';\nimport { NG_DOC_SHORTCUTS, NgDocShortcutsService } from '@ng-doc/app/services/shortcuts';\nimport type { NgDocContentScrollPositionRestoration } from '@ng-doc/app/tokens';\nimport {\n  NG_DOC_CONTENT_ANCHOR_SCROLLING,\n  NG_DOC_CONTENT_SCROLL_POSITION_RESTORATION,\n} from '@ng-doc/app/tokens';\nimport type { NgDocUiConfig } from '@ng-doc/ui-kit';\nimport { provideNgDocUiKitConfig } from '@ng-doc/ui-kit';\n\n/**\n * NgDoc application config.\n */\nexport interface NgDocApplicationConfig {\n  /**\n   * Replays a router anchor scroll once asynchronous NgDoc content has been processed.\n   * Enable this beside Angular router anchor scrolling.\n   */\n  contentAnchorScrolling?: boolean;\n  /**\n   * Replays a saved router position after asynchronous NgDoc content is processed.\n   * Select the same intent as Angular router scroll position restoration.\n   */\n  contentScrollPositionRestoration?: NgDocContentScrollPositionRestoration;\n  /**\n   * UI Kit configuration.\n   */\n  uiKit?: NgDocUiConfig;\n  /**\n   * Shiki theme.\n   */\n  shiki?: NgDocHighlighterConfig;\n  /**\n   * Whether single-key shortcuts (slash, the square brackets, F, L and T) are on for readers who\n   * have not turned them on or off themselves. Readers can always change it with the switch in\n   * the search palette. Command+K (Control+K) opens the search either way. Defaults to true.\n   */\n  shortcuts?: boolean;\n}\n\n/**\n * Provides the NgDoc application configuration.\n * @param config - The optional application configuration.\n */\nexport function provideNgDocApp(\n  config?: NgDocApplicationConfig,\n): Array<EnvironmentProviders | Provider> {\n  return [\n    { provide: NG_DOC_CONTENT_ANCHOR_SCROLLING, useValue: config?.contentAnchorScrolling ?? false },\n    {\n      provide: NG_DOC_CONTENT_SCROLL_POSITION_RESTORATION,\n      useValue: config?.contentScrollPositionRestoration ?? 'disabled',\n    },\n    ...(config?.contentAnchorScrolling || config?.contentScrollPositionRestoration === 'enabled'\n      ? [\n          provideAppInitializer(() => {\n            inject(NgDocContentScrollIntent).start();\n          }),\n        ]\n      : []),\n\n    /* --- Hydration --- */\n    // Before the application renders: the pages and headers that skip hydration show their\n    // server-rendered content until their own is rendered, instead of a blank page.\n    provideAppInitializer(() => {\n      if (isPlatformBrowser(inject(PLATFORM_ID))) ɵcaptureNgDocHydrationSnapshots(inject(DOCUMENT));\n    }),\n\n    /* --- Keyboard shortcuts --- */\n    { provide: NG_DOC_SHORTCUTS, useValue: config?.shortcuts ?? true },\n    // Created at start-up so the built-in shortcuts work on every page.\n    provideAppInitializer(() => {\n      inject(NgDocShortcutsService);\n    }),\n\n    /* --- Viewport Scroller --- */\n    provideAppInitializer(() => {\n      inject(ViewportScroller).setOffset([0, 120]);\n    }),\n\n    /* --- Shiki --- */\n    provideAppInitializer(async () => {\n      await inject(NgDocHighlighterService).initialize(config?.shiki);\n    }),\n\n    /* --- UiKit --- */\n    ...provideNgDocUiKitConfig(config?.uiKit),\n  ];\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["ɵcaptureNgDocHydrationSnapshots"],"mappings":";;;;;;;;;AAoDA;;;AAGG;AACG,SAAU,eAAe,CAC7B,MAA+B,EAAA;IAE/B,OAAO;QACL,EAAE,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,MAAM,EAAE,sBAAsB,IAAI,KAAK,EAAE;AAC/F,QAAA;AACE,YAAA,OAAO,EAAE,0CAA0C;AACnD,YAAA,QAAQ,EAAE,MAAM,EAAE,gCAAgC,IAAI,UAAU;AACjE,SAAA;QACD,IAAI,MAAM,EAAE,sBAAsB,IAAI,MAAM,EAAE,gCAAgC,KAAK;AACjF,cAAE;gBACE,qBAAqB,CAAC,MAAK;AACzB,oBAAA,MAAM,CAAC,wBAAwB,CAAC,CAAC,KAAK,EAAE;AAC1C,gBAAA,CAAC,CAAC;AACH;cACD,EAAE,CAAC;;;;QAKP,qBAAqB,CAAC,MAAK;AACzB,YAAA,IAAI,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAAE,gBAAAA,+BAA+B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/F,QAAA,CAAC,CAAC;;QAGF,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI,EAAE;;QAElE,qBAAqB,CAAC,MAAK;YACzB,MAAM,CAAC,qBAAqB,CAAC;AAC/B,QAAA,CAAC,CAAC;;QAGF,qBAAqB,CAAC,MAAK;AACzB,YAAA,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC9C,QAAA,CAAC,CAAC;;QAGF,qBAAqB,CAAC,YAAW;YAC/B,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC;AACjE,QAAA,CAAC,CAAC;;AAGF,QAAA,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC;KAC1C;AACH;;ACpGA;;AAEG;;;;"}
+{"version":3,"file":"ng-doc-app-providers-ng-doc-app.mjs","sources":["../../../../libs/app/providers/ng-doc-app/provide-ng-doc-app.ts","../../../../libs/app/providers/ng-doc-app/ng-doc-app-providers-ng-doc-app.ts"],"sourcesContent":["import { isPlatformBrowser } from '@angular/common';\nimport {\n  DOCUMENT,\n  EnvironmentProviders,\n  inject,\n  PendingTasks,\n  PLATFORM_ID,\n  provideEnvironmentInitializer,\n  Provider,\n} from '@angular/core';\nimport { ɵcaptureNgDocHydrationSnapshots } from '@ng-doc/app/helpers';\nimport { NgDocApiListIndexService } from '@ng-doc/app/services';\nimport { NgDocContentScrollIntent } from '@ng-doc/app/services/content-scroll-intent';\nimport type { NgDocHighlighterConfig } from '@ng-doc/app/services/highlighter';\nimport { NgDocHighlighterService } from '@ng-doc/app/services/highlighter';\nimport { NG_DOC_SHORTCUTS, NgDocShortcutsService } from '@ng-doc/app/services/shortcuts';\nimport type { NgDocContentScrollPositionRestoration } from '@ng-doc/app/tokens';\nimport {\n  NG_DOC_CONTENT_ANCHOR_SCROLLING,\n  NG_DOC_CONTENT_SCROLL_POSITION_RESTORATION,\n} from '@ng-doc/app/tokens';\nimport type { NgDocUiConfig } from '@ng-doc/ui-kit';\nimport { provideNgDocUiKitConfig } from '@ng-doc/ui-kit';\n\n/**\n * NgDoc application config.\n */\nexport interface NgDocApplicationConfig {\n  /**\n   * Replays a router anchor scroll once asynchronous NgDoc content has been processed.\n   * Enable this beside Angular router anchor scrolling.\n   */\n  contentAnchorScrolling?: boolean;\n  /**\n   * Replays a saved router position after asynchronous NgDoc content is processed.\n   * Select the same intent as Angular router scroll position restoration.\n   */\n  contentScrollPositionRestoration?: NgDocContentScrollPositionRestoration;\n  /**\n   * UI Kit configuration.\n   */\n  uiKit?: NgDocUiConfig;\n  /**\n   * Extra Shiki themes and languages for the code that the browser highlights.\n   */\n  shiki?: NgDocHighlighterConfig;\n  /**\n   * Whether single-key shortcuts (slash, the square brackets, F, L and T) are on for readers who\n   * have not turned them on or off themselves. Readers can always change it with the switch in\n   * the search palette. Command+K (Control+K) opens the search either way. Defaults to true.\n   */\n  shortcuts?: boolean;\n}\n\n/**\n * Provides the NgDoc application configuration.\n *\n * Add it to the application's providers, or to the `providers` of the route that holds the\n * documentation, together with the other NgDoc providers: then NgDoc starts only when the reader\n * opens the documentation, and its code stays out of the application's initial bundle. It starts\n * with environment initializers, which run where it is provided. The server render waits until\n * the code highlighter of playgrounds has loaded.\n * @param config - The optional application configuration.\n */\nexport function provideNgDocApp(\n  config?: NgDocApplicationConfig,\n): Array<EnvironmentProviders | Provider> {\n  return [\n    { provide: NG_DOC_CONTENT_ANCHOR_SCROLLING, useValue: config?.contentAnchorScrolling ?? false },\n    {\n      provide: NG_DOC_CONTENT_SCROLL_POSITION_RESTORATION,\n      useValue: config?.contentScrollPositionRestoration ?? 'disabled',\n    },\n    { provide: NG_DOC_SHORTCUTS, useValue: config?.shortcuts ?? true },\n\n    /* --- Services --- */\n    // Provided where the configuration is, so that they read the NgDoc providers of a lazy route\n    // (the generated context, the shortcuts option): an instance in the root injector could not\n    // see them. In the root injector this is the instance `providedIn: 'root'` gives.\n    NgDocHighlighterService,\n    NgDocShortcutsService,\n    NgDocApiListIndexService,\n\n    ...(config?.contentAnchorScrolling || config?.contentScrollPositionRestoration === 'enabled'\n      ? [\n          provideEnvironmentInitializer(() => {\n            inject(NgDocContentScrollIntent).start();\n          }),\n        ]\n      : []),\n\n    /* --- Hydration --- */\n    // Before the documentation renders: the pages and headers that skip hydration show their\n    // server-rendered content until their own is rendered, instead of a blank page. A lazy route\n    // creates its injector before it creates its components, so this also runs in time when the\n    // documentation is the first route the browser hydrates.\n    provideEnvironmentInitializer(() => {\n      if (isPlatformBrowser(inject(PLATFORM_ID))) ɵcaptureNgDocHydrationSnapshots(inject(DOCUMENT));\n    }),\n\n    /* --- Shiki --- */\n    // Started with the documentation instead of blocking the application's start: the playgrounds\n    // highlight their code once it is ready, and the application stays unstable until then, so the\n    // server renders the highlighted code.\n    provideEnvironmentInitializer(() => {\n      const highlighter = inject(NgDocHighlighterService);\n\n      inject(PendingTasks).run(() => highlighter.initialize(config?.shiki));\n    }),\n\n    /* --- UiKit --- */\n    ...provideNgDocUiKitConfig(config?.uiKit),\n  ];\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["ɵcaptureNgDocHydrationSnapshots"],"mappings":";;;;;;;;;;AAsDA;;;;;;;;;AASG;AACG,SAAU,eAAe,CAC7B,MAA+B,EAAA;IAE/B,OAAO;QACL,EAAE,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,MAAM,EAAE,sBAAsB,IAAI,KAAK,EAAE;AAC/F,QAAA;AACE,YAAA,OAAO,EAAE,0CAA0C;AACnD,YAAA,QAAQ,EAAE,MAAM,EAAE,gCAAgC,IAAI,UAAU;AACjE,SAAA;QACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI,EAAE;;;;;QAMlE,uBAAuB;QACvB,qBAAqB;QACrB,wBAAwB;QAExB,IAAI,MAAM,EAAE,sBAAsB,IAAI,MAAM,EAAE,gCAAgC,KAAK;AACjF,cAAE;gBACE,6BAA6B,CAAC,MAAK;AACjC,oBAAA,MAAM,CAAC,wBAAwB,CAAC,CAAC,KAAK,EAAE;AAC1C,gBAAA,CAAC,CAAC;AACH;cACD,EAAE,CAAC;;;;;;QAOP,6BAA6B,CAAC,MAAK;AACjC,YAAA,IAAI,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAAE,gBAAAA,+BAA+B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/F,QAAA,CAAC,CAAC;;;;;QAMF,6BAA6B,CAAC,MAAK;AACjC,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,uBAAuB,CAAC;AAEnD,YAAA,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACvE,QAAA,CAAC,CAAC;;AAGF,QAAA,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC;KAC1C;AACH;;ACjHA;;AAEG;;;;"}

package/fesm2022/ng-doc-app-providers-texts.mjs

@@ -0,0 +1,53 @@
+import { InjectionToken, inject } from '@angular/core';
+import { NG_DOC_TEXTS, mergeNgDocTexts, NG_DOC_DEFAULT_TEXTS } from '@ng-doc/app/tokens';
+import { NG_DOC_UI_KIT_TEXTS } from '@ng-doc/ui-kit/texts';
+
+/** The changes of every `provideNgDocTexts` call of one injector, in the order of the calls. */
+const NG_DOC_TEXTS_OVERRIDES = new InjectionToken('NG_DOC_TEXTS_OVERRIDES');
+/**
+ * Changes the texts NgDoc shows to readers, for example to translate them. Pass the groups and
+ * texts to change; every other text keeps its English default (`NG_DOC_DEFAULT_TEXTS`). NgDoc
+ * ships complete translations in entry points of their own, such as `NG_DOC_TEXTS_DE` from
+ * `@ng-doc/app/texts/de`; pass one first and your changes after it.
+ *
+ * Calls and arguments add up: in one injector they apply in order, so a later one wins for a
+ * text both set, and the providers of a child injector (a lazy route, for example) apply on top of the
+ * texts of its parent. The texts are read when a component is created, so they are fixed per
+ * injector: switch the language by reloading the application, not at run time.
+ * @example
+ * ```typescript
+ * provideNgDocTexts(NG_DOC_TEXTS_DE, { search: { placeholder: 'Handbuch durchsuchen…' } });
+ *
+ * provideNgDocTexts({
+ *   search: { placeholder: 'Dokumentation durchsuchen…' },
+ *   searchPalette: { noResults: ({ query }) => `Keine Ergebnisse für „${query}“` },
+ * });
+ * ```
+ * @param texts - The texts to change, by group, in the order they apply.
+ * @returns The providers to add to the application, a route or a page.
+ */
+function provideNgDocTexts(...texts) {
+    return [
+        ...texts.map((overrides) => ({
+            provide: NG_DOC_TEXTS_OVERRIDES,
+            useValue: overrides,
+            multi: true,
+        })),
+        { provide: NG_DOC_TEXTS, useFactory: resolveTexts },
+        // The ui-kit components read their own token: NgDocTexts extends NgDocUiKitTexts, so the
+        // same object serves both and the two libraries always show the same texts.
+        { provide: NG_DOC_UI_KIT_TEXTS, useFactory: () => inject(NG_DOC_TEXTS) },
+    ];
+}
+/** The texts of the parent injector, or the defaults, with this injector's changes on top. */
+function resolveTexts() {
+    const parent = inject(NG_DOC_TEXTS, { skipSelf: true, optional: true });
+    return mergeNgDocTexts(parent ?? NG_DOC_DEFAULT_TEXTS, ...inject(NG_DOC_TEXTS_OVERRIDES, { self: true }));
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { provideNgDocTexts };
+//# sourceMappingURL=ng-doc-app-providers-texts.mjs.map

package/fesm2022/ng-doc-app-providers-texts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-doc-app-providers-texts.mjs","sources":["../../../../libs/app/providers/texts/provide-ng-doc-texts.ts","../../../../libs/app/providers/texts/ng-doc-app-providers-texts.ts"],"sourcesContent":["import { inject, InjectionToken, Provider } from '@angular/core';\nimport type { NgDocTexts, NgDocTextsOverrides } from '@ng-doc/app/interfaces';\nimport { mergeNgDocTexts, NG_DOC_DEFAULT_TEXTS, NG_DOC_TEXTS } from '@ng-doc/app/tokens';\nimport { NG_DOC_UI_KIT_TEXTS } from '@ng-doc/ui-kit/texts';\n\n/** The changes of every `provideNgDocTexts` call of one injector, in the order of the calls. */\nconst NG_DOC_TEXTS_OVERRIDES = new InjectionToken<NgDocTextsOverrides[]>('NG_DOC_TEXTS_OVERRIDES');\n\n/**\n * Changes the texts NgDoc shows to readers, for example to translate them. Pass the groups and\n * texts to change; every other text keeps its English default (`NG_DOC_DEFAULT_TEXTS`). NgDoc\n * ships complete translations in entry points of their own, such as `NG_DOC_TEXTS_DE` from\n * `@ng-doc/app/texts/de`; pass one first and your changes after it.\n *\n * Calls and arguments add up: in one injector they apply in order, so a later one wins for a\n * text both set, and the providers of a child injector (a lazy route, for example) apply on top of the\n * texts of its parent. The texts are read when a component is created, so they are fixed per\n * injector: switch the language by reloading the application, not at run time.\n * @example\n * ```typescript\n * provideNgDocTexts(NG_DOC_TEXTS_DE, { search: { placeholder: 'Handbuch durchsuchen…' } });\n *\n * provideNgDocTexts({\n *   search: { placeholder: 'Dokumentation durchsuchen…' },\n *   searchPalette: { noResults: ({ query }) => `Keine Ergebnisse für „${query}“` },\n * });\n * ```\n * @param texts - The texts to change, by group, in the order they apply.\n * @returns The providers to add to the application, a route or a page.\n */\nexport function provideNgDocTexts(...texts: NgDocTextsOverrides[]): Provider[] {\n  return [\n    ...texts.map((overrides: NgDocTextsOverrides) => ({\n      provide: NG_DOC_TEXTS_OVERRIDES,\n      useValue: overrides,\n      multi: true,\n    })),\n    { provide: NG_DOC_TEXTS, useFactory: resolveTexts },\n    // The ui-kit components read their own token: NgDocTexts extends NgDocUiKitTexts, so the\n    // same object serves both and the two libraries always show the same texts.\n    { provide: NG_DOC_UI_KIT_TEXTS, useFactory: () => inject(NG_DOC_TEXTS) },\n  ];\n}\n\n/** The texts of the parent injector, or the defaults, with this injector's changes on top. */\nfunction resolveTexts(): NgDocTexts {\n  const parent: NgDocTexts | null = inject(NG_DOC_TEXTS, { skipSelf: true, optional: true });\n\n  return mergeNgDocTexts(\n    parent ?? NG_DOC_DEFAULT_TEXTS,\n    ...inject(NG_DOC_TEXTS_OVERRIDES, { self: true }),\n  );\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAKA;AACA,MAAM,sBAAsB,GAAG,IAAI,cAAc,CAAwB,wBAAwB,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,iBAAiB,CAAC,GAAG,KAA4B,EAAA;IAC/D,OAAO;QACL,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,SAA8B,MAAM;AAChD,YAAA,OAAO,EAAE,sBAAsB;AAC/B,YAAA,QAAQ,EAAE,SAAS;AACnB,YAAA,KAAK,EAAE,IAAI;AACZ,SAAA,CAAC,CAAC;AACH,QAAA,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE;;;AAGnD,QAAA,EAAE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE;KACzE;AACH;AAEA;AACA,SAAS,YAAY,GAAA;AACnB,IAAA,MAAM,MAAM,GAAsB,MAAM,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAE1F,IAAA,OAAO,eAAe,CACpB,MAAM,IAAI,oBAAoB,EAC9B,GAAG,MAAM,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAClD;AACH;;ACpDA;;AAEG;;;;"}

package/fesm2022/ng-doc-app-providers-title.mjs

@@ -0,0 +1,129 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, inject, EnvironmentInjector, runInInjectionContext, Injectable, makeEnvironmentProviders } from '@angular/core';
+import { Title } from '@angular/platform-browser';
+import { TitleStrategy } from '@angular/router';
+
+/** Route data key that names what a generated route's title belongs to. */
+const TITLE_KIND_DATA = 'ngDocTitle';
+/** Route data key of a page route that names the page type (`guide` or `api`). */
+const PAGE_TYPE_DATA = 'ngDocPageType';
+/** The function that `provideNgDocTitle` was given. */
+const NG_DOC_TITLE_FN = new InjectionToken('NG_DOC_TITLE_FN');
+/**
+ * Title strategy that builds the document title with the function given to `provideNgDocTitle`,
+ * from the categories, page, tab and API declaration of the current route. It stays internal:
+ * `provideNgDocTitle` is the public way to set it.
+ */
+class NgDocTitleStrategy extends TitleStrategy {
+    constructor() {
+        super(...arguments);
+        this.title = inject(Title);
+        this.injector = inject(EnvironmentInjector);
+        this.titleFn = inject(NG_DOC_TITLE_FN);
+    }
+    /**
+     * Sets the document title for the router state.
+     * @param snapshot - The router state after a navigation.
+     */
+    updateTitle(snapshot) {
+        const title = runInInjectionContext(this.injector, () => this.titleFn(this.buildContext(snapshot)));
+        if (title !== undefined) {
+            this.title.setTitle(title);
+        }
+    }
+    /**
+     * Collects the titles of the router state by what they belong to.
+     * @param snapshot - The router state after a navigation.
+     */
+    buildContext(snapshot) {
+        const categories = [];
+        let page;
+        let tab;
+        let ownTitle;
+        let isApi = false;
+        for (let route = snapshot.root; route; route = route.firstChild) {
+            const config = route.routeConfig;
+            if (config?.data?.[PAGE_TYPE_DATA] === 'api') {
+                isApi = true;
+            }
+            // Only a route's own title counts: routes without one inherit the title of their parent,
+            // which would repeat it.
+            if (config?.title === undefined) {
+                continue;
+            }
+            const title = this.getResolvedTitleForRoute(route);
+            if (typeof title !== 'string') {
+                continue;
+            }
+            switch (config.data?.[TITLE_KIND_DATA]) {
+                case 'category':
+                    categories.push(title);
+                    break;
+                case 'page':
+                    page = title;
+                    break;
+                case 'tab':
+                    // A page with one tab shows no tabs, and the tab's title is the page's.
+                    if ((route.parent?.routeConfig?.children?.length ?? 0) > 1) {
+                        tab = title;
+                    }
+                    break;
+                default:
+                    // A title below the page comes from the page's own `route`, and wins over the
+                    // generated one. Titles above the documentation belong to the application.
+                    if (page !== undefined) {
+                        ownTitle = title;
+                    }
+            }
+        }
+        // The first tab of a page usually has no title of its own and shows the page's.
+        if (tab === page) {
+            tab = undefined;
+        }
+        page = ownTitle ?? page;
+        return {
+            title: this.buildTitle(snapshot),
+            categories,
+            page: isApi ? undefined : page,
+            tab,
+            api: isApi ? page : undefined,
+            snapshot,
+        };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocTitleStrategy, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocTitleStrategy }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocTitleStrategy, decorators: [{
+            type: Injectable
+        }] });
+/**
+ * Builds the browser tab title of every navigation with a function that receives the categories,
+ * the page, the tab and the API declaration of the route, so titles like
+ * "Installation · Getting started | NgDoc" need no parsing of route titles.
+ *
+ * Without it, Angular sets the title of the deepest route: the page's (or its tab's) title.
+ * @param titleFn - Builds the title; `undefined` keeps the current title.
+ * @example
+ * ```ts
+ * provideNgDocTitle(({ categories, page, tab, api, title }) => {
+ *   const name = api ?? page;
+ *
+ *   return name
+ *     ? [tab, name, ...[...categories].reverse()].filter(Boolean).join(' · ') + ' | My library'
+ *     : (title ?? 'My library');
+ * });
+ * ```
+ */
+function provideNgDocTitle(titleFn) {
+    return makeEnvironmentProviders([
+        { provide: NG_DOC_TITLE_FN, useValue: titleFn },
+        { provide: TitleStrategy, useClass: NgDocTitleStrategy },
+    ]);
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { provideNgDocTitle };
+//# sourceMappingURL=ng-doc-app-providers-title.mjs.map

package/fesm2022/ng-doc-app-providers-title.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-doc-app-providers-title.mjs","sources":["../../../../libs/app/providers/title/provide-ng-doc-title.ts","../../../../libs/app/providers/title/ng-doc-app-providers-title.ts"],"sourcesContent":["import {\n  EnvironmentInjector,\n  EnvironmentProviders,\n  inject,\n  Injectable,\n  InjectionToken,\n  makeEnvironmentProviders,\n  runInInjectionContext,\n} from '@angular/core';\nimport { Title } from '@angular/platform-browser';\nimport { ActivatedRouteSnapshot, RouterStateSnapshot, TitleStrategy } from '@angular/router';\n\n/**\n * What the title of a route belongs to. NgDoc writes it as `ngDocTitle` into the `data` of the\n * routes it generates.\n */\ntype NgDocTitleKind = 'category' | 'page' | 'tab';\n\n/** Route data key that names what a generated route's title belongs to. */\nconst TITLE_KIND_DATA: string = 'ngDocTitle';\n\n/** Route data key of a page route that names the page type (`guide` or `api`). */\nconst PAGE_TYPE_DATA: string = 'ngDocPageType';\n\n/**\n * The parts of the current route that `provideNgDocTitle` passes to its function.\n *\n * Outside the documentation (a landing page, for example), `categories` is empty and `page`,\n * `tab` and `api` are not set.\n */\nexport interface NgDocTitleContext {\n  /**\n   * The title Angular sets by default: the title of the deepest route that has one. It is not set\n   * when no route of the navigation has a title.\n   */\n  readonly title: string | undefined;\n  /** Titles of the categories that contain the page, the outermost category first. */\n  readonly categories: readonly string[];\n  /**\n   * Title of the guide or the API list. A title in the page's own route replaces it. Not set on\n   * an API page, which sets `api` instead.\n   */\n  readonly page: string | undefined;\n  /**\n   * Title of the active tab, when the page has more than one tab. Not set on a tab titled like\n   * the page, usually its first one.\n   */\n  readonly tab: string | undefined;\n  /** Name of the API declaration, on an API page. */\n  readonly api: string | undefined;\n  /** The router state the title is for. */\n  readonly snapshot: RouterStateSnapshot;\n}\n\n/**\n * Builds the browser tab title from the parts of the current route. It runs in an injection\n * context, so it can call `inject()`. When it returns `undefined`, the title stays as it is.\n */\nexport type NgDocTitleFn = (context: NgDocTitleContext) => string | undefined;\n\n/** The function that `provideNgDocTitle` was given. */\nconst NG_DOC_TITLE_FN = new InjectionToken<NgDocTitleFn>('NG_DOC_TITLE_FN');\n\n/**\n * Title strategy that builds the document title with the function given to `provideNgDocTitle`,\n * from the categories, page, tab and API declaration of the current route. It stays internal:\n * `provideNgDocTitle` is the public way to set it.\n */\n@Injectable()\nclass NgDocTitleStrategy extends TitleStrategy {\n  private readonly title = inject(Title);\n  private readonly injector = inject(EnvironmentInjector);\n  private readonly titleFn = inject(NG_DOC_TITLE_FN);\n\n  /**\n   * Sets the document title for the router state.\n   * @param snapshot - The router state after a navigation.\n   */\n  override updateTitle(snapshot: RouterStateSnapshot): void {\n    const title = runInInjectionContext(this.injector, () =>\n      this.titleFn(this.buildContext(snapshot)),\n    );\n\n    if (title !== undefined) {\n      this.title.setTitle(title);\n    }\n  }\n\n  /**\n   * Collects the titles of the router state by what they belong to.\n   * @param snapshot - The router state after a navigation.\n   */\n  buildContext(snapshot: RouterStateSnapshot): NgDocTitleContext {\n    const categories: string[] = [];\n    let page: string | undefined;\n    let tab: string | undefined;\n    let ownTitle: string | undefined;\n    let isApi = false;\n\n    for (\n      let route: ActivatedRouteSnapshot | null = snapshot.root;\n      route;\n      route = route.firstChild\n    ) {\n      const config = route.routeConfig;\n\n      if (config?.data?.[PAGE_TYPE_DATA] === 'api') {\n        isApi = true;\n      }\n\n      // Only a route's own title counts: routes without one inherit the title of their parent,\n      // which would repeat it.\n      if (config?.title === undefined) {\n        continue;\n      }\n\n      const title = this.getResolvedTitleForRoute(route);\n\n      if (typeof title !== 'string') {\n        continue;\n      }\n\n      switch (config.data?.[TITLE_KIND_DATA] as NgDocTitleKind | undefined) {\n        case 'category':\n          categories.push(title);\n          break;\n        case 'page':\n          page = title;\n          break;\n        case 'tab':\n          // A page with one tab shows no tabs, and the tab's title is the page's.\n          if ((route.parent?.routeConfig?.children?.length ?? 0) > 1) {\n            tab = title;\n          }\n          break;\n        default:\n          // A title below the page comes from the page's own `route`, and wins over the\n          // generated one. Titles above the documentation belong to the application.\n          if (page !== undefined) {\n            ownTitle = title;\n          }\n      }\n    }\n\n    // The first tab of a page usually has no title of its own and shows the page's.\n    if (tab === page) {\n      tab = undefined;\n    }\n\n    page = ownTitle ?? page;\n\n    return {\n      title: this.buildTitle(snapshot),\n      categories,\n      page: isApi ? undefined : page,\n      tab,\n      api: isApi ? page : undefined,\n      snapshot,\n    };\n  }\n}\n\n/**\n * Builds the browser tab title of every navigation with a function that receives the categories,\n * the page, the tab and the API declaration of the route, so titles like\n * \"Installation · Getting started | NgDoc\" need no parsing of route titles.\n *\n * Without it, Angular sets the title of the deepest route: the page's (or its tab's) title.\n * @param titleFn - Builds the title; `undefined` keeps the current title.\n * @example\n * ```ts\n * provideNgDocTitle(({ categories, page, tab, api, title }) => {\n *   const name = api ?? page;\n *\n *   return name\n *     ? [tab, name, ...[...categories].reverse()].filter(Boolean).join(' · ') + ' | My library'\n *     : (title ?? 'My library');\n * });\n * ```\n */\nexport function provideNgDocTitle(titleFn: NgDocTitleFn): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    { provide: NG_DOC_TITLE_FN, useValue: titleFn },\n    { provide: TitleStrategy, useClass: NgDocTitleStrategy },\n  ]);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/ng-doc-app-providers.mjs

@@ -3,6 +3,8 @@ export * from '@ng-doc/app/providers/ng-doc-app';
 export * from '@ng-doc/app/providers/page-skeleton';
 export * from '@ng-doc/app/providers/playground-demo';
 export * from '@ng-doc/app/providers/search-engine';
+export * from '@ng-doc/app/providers/texts';
+export * from '@ng-doc/app/providers/title';
 export * from '@ng-doc/app/providers/type-control';
 
 /**

package/fesm2022/ng-doc-app-providers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-providers.mjs","sources":["../../../../libs/app/providers/ng-doc-app-providers.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;AAAA;;AAEG"}
+{"version":3,"file":"ng-doc-app-providers.mjs","sources":["../../../../libs/app/providers/ng-doc-app-providers.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;;;AAAA;;AAEG"}

package/fesm2022/ng-doc-app-services-content-scroll-intent.mjs

@@ -1,4 +1,4 @@
-import { isPlatformBrowser } from '@angular/common';
+import { isPlatformBrowser, Location } from '@angular/common';
 import * as i0 from '@angular/core';
 import { inject, PLATFORM_ID, signal, DestroyRef, Service } from '@angular/core';
 import { Router, NavigationStart, NavigationEnd, Scroll, NavigationCancel, NavigationError, NavigationSkipped } from '@angular/router';
@@ -8,6 +8,7 @@ class NgDocContentScrollIntent {
     constructor() {
         this.browser = isPlatformBrowser(inject(PLATFORM_ID));
         this.router = inject(Router);
+        this.location = inject(Location);
         this.listeners = new Set();
         this.started = false;
         this.successful = false;
@@ -19,11 +20,15 @@ class NgDocContentScrollIntent {
         this.currentIntent = this.intentState.asReadonly();
         inject(DestroyRef).onDestroy(() => this.destroy());
     }
-    /** Starts following router events. Does nothing on the server or when already started. */
+    /**
+     * Starts following router events. Does nothing on the server or when already started. Started
+     * during a navigation, it follows that navigation too.
+     */
     start() {
         if (this.started || !this.browser)
             return;
         this.started = true;
+        this.followCurrentNavigation();
         this.subscription = this.router.events.subscribe((event) => {
             if (event instanceof NavigationStart)
                 this.navigationStarted(event);
@@ -73,6 +78,26 @@ class NgDocContentScrollIntent {
                 navigation.extras.scroll !== 'manual',
         };
     }
+    /**
+     * Takes the navigation in progress as the candidate. The providers of a lazy route start the
+     * intent while the router loads that route, after the first navigation has started, and its
+     * fragment must still be replayed.
+     */
+    followCurrentNavigation() {
+        const navigation = this.router.currentNavigation();
+        if (!navigation)
+            return;
+        // The router restores the history state of the first navigation, as `restoredState` of its
+        // NavigationStart, when that state has a navigation id.
+        const state = this.location.getState();
+        this.candidate = {
+            navigationId: navigation.id,
+            eligible: navigation.trigger === 'imperative' &&
+                navigation.previousNavigation === null &&
+                !state?.navigationId &&
+                navigation.extras.scroll !== 'manual',
+        };
+    }
     navigationEnded(event) {
         const candidate = this.candidate;
         this.candidate = undefined;

package/fesm2022/ng-doc-app-services-content-scroll-intent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-services-content-scroll-intent.mjs","sources":["../../../../libs/app/services/content-scroll-intent/content-scroll-intent.service.ts","../../../../libs/app/services/content-scroll-intent/ng-doc-app-services-content-scroll-intent.ts"],"sourcesContent":["import { isPlatformBrowser } from '@angular/common';\nimport { DestroyRef, inject, PLATFORM_ID, Service, Signal, signal } from '@angular/core';\nimport {\n  NavigationCancel,\n  NavigationEnd,\n  NavigationError,\n  NavigationSkipped,\n  NavigationStart,\n  Router,\n  Scroll,\n} from '@angular/router';\nimport { Subscription } from 'rxjs';\n\n/** The fragment of the application's first navigation, kept until a page replays or drops it. */\nexport interface NgDocInitialContentScrollIntent {\n  /** The decoded fragment of the navigation. */\n  readonly anchor: string;\n  /** Id of the navigation that produced the fragment. */\n  readonly navigationId: number;\n  /** The URL after redirects. */\n  readonly url: string;\n}\n\n/** Captures the public initial-navigation facts that are unavailable after component activation. */\n@Service()\nexport class NgDocContentScrollIntent {\n  private readonly browser = isPlatformBrowser(inject(PLATFORM_ID));\n  private readonly router = inject(Router);\n  private candidate?: { eligible: boolean; navigationId: number };\n  private intent?: NgDocInitialContentScrollIntent;\n  private readonly listeners = new Set<\n    (intent: NgDocInitialContentScrollIntent | undefined) => void\n  >();\n  private started = false;\n  private successful = false;\n  private subscription?: Subscription;\n  private readonly intentState = signal<NgDocInitialContentScrollIntent | undefined>(undefined);\n\n  /**\n   * The pending initial intent as a signal, the same value `subscribe()` listeners receive.\n   */\n  readonly currentIntent: Signal<NgDocInitialContentScrollIntent | undefined> =\n    this.intentState.asReadonly();\n\n  constructor() {\n    inject(DestroyRef).onDestroy(() => this.destroy());\n  }\n\n  /** Starts following router events. Does nothing on the server or when already started. */\n  start(): void {\n    if (this.started || !this.browser) return;\n    this.started = true;\n    this.subscription = this.router.events.subscribe((event) => {\n      if (event instanceof NavigationStart) this.navigationStarted(event);\n      else if (event instanceof NavigationEnd) this.navigationEnded(event);\n      else if (event instanceof Scroll) this.scrolled(event);\n      else if (\n        event instanceof NavigationCancel ||\n        event instanceof NavigationError ||\n        event instanceof NavigationSkipped\n      ) {\n        if (this.candidate && event.id >= this.candidate.navigationId) this.candidate = undefined;\n        if (this.intent && event.id >= this.intent.navigationId) this.publish(undefined);\n      }\n    });\n  }\n\n  /**\n   * Calls the listener with every change of the intent, and at once with the pending one.\n   * @param listener - Receives the intent, or `undefined` once it is consumed or cancelled.\n   * @returns A function that removes the listener.\n   */\n  subscribe(listener: (intent: NgDocInitialContentScrollIntent | undefined) => void): () => void {\n    this.listeners.add(listener);\n    if (this.intent) listener(this.intent);\n    return () => this.listeners.delete(listener);\n  }\n\n  /**\n   * Consumes the current fallback after its page has either replayed or explicitly yielded it.\n   * @param navigationId - The navigation of the intent to consume.\n   */\n  settle(navigationId: number): void {\n    if (this.intent?.navigationId === navigationId) this.publish(undefined);\n  }\n\n  private navigationStarted(event: NavigationStart): void {\n    this.publish(undefined);\n    const navigation = this.router.currentNavigation();\n    this.candidate = {\n      navigationId: event.id,\n      eligible:\n        !this.successful &&\n        event.navigationTrigger === 'imperative' &&\n        event.restoredState == null &&\n        navigation?.id === event.id &&\n        navigation.previousNavigation === null &&\n        navigation.extras.scroll !== 'manual',\n    };\n  }\n\n  private navigationEnded(event: NavigationEnd): void {\n    const candidate = this.candidate;\n    this.candidate = undefined;\n    this.successful = true;\n    if (!candidate?.eligible || candidate.navigationId !== event.id) return;\n    const anchor = this.router.parseUrl(event.urlAfterRedirects).fragment;\n    if (anchor) {\n      this.publish({ anchor, navigationId: event.id, url: event.urlAfterRedirects });\n    }\n  }\n\n  private scrolled(event: Scroll): void {\n    if (this.intent && event.routerEvent.id >= this.intent.navigationId) this.publish(undefined);\n    if (this.candidate && event.routerEvent.id >= this.candidate.navigationId) {\n      this.candidate = undefined;\n    }\n  }\n\n  private publish(intent: NgDocInitialContentScrollIntent | undefined): void {\n    if (this.intent === intent) return;\n    this.intent = intent;\n    this.intentState.set(intent);\n    for (const listener of [...this.listeners]) listener(intent);\n  }\n\n  private destroy(): void {\n    this.subscription?.unsubscribe();\n    this.subscription = undefined;\n    this.candidate = undefined;\n    this.intent = undefined;\n    this.intentState.set(undefined);\n    this.listeners.clear();\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ng-doc-app-services-content-scroll-intent.mjs","sources":["../../../../libs/app/services/content-scroll-intent/content-scroll-intent.service.ts","../../../../libs/app/services/content-scroll-intent/ng-doc-app-services-content-scroll-intent.ts"],"sourcesContent":["import { isPlatformBrowser, Location } from '@angular/common';\nimport { DestroyRef, inject, PLATFORM_ID, Service, Signal, signal } from '@angular/core';\nimport {\n  NavigationCancel,\n  NavigationEnd,\n  NavigationError,\n  NavigationSkipped,\n  NavigationStart,\n  Router,\n  Scroll,\n} from '@angular/router';\nimport { Subscription } from 'rxjs';\n\n/** The fragment of the application's first navigation, kept until a page replays or drops it. */\nexport interface NgDocInitialContentScrollIntent {\n  /** The decoded fragment of the navigation. */\n  readonly anchor: string;\n  /** Id of the navigation that produced the fragment. */\n  readonly navigationId: number;\n  /** The URL after redirects. */\n  readonly url: string;\n}\n\n/** Captures the public initial-navigation facts that are unavailable after component activation. */\n@Service()\nexport class NgDocContentScrollIntent {\n  private readonly browser = isPlatformBrowser(inject(PLATFORM_ID));\n  private readonly router = inject(Router);\n  private readonly location = inject(Location);\n  private candidate?: { eligible: boolean; navigationId: number };\n  private intent?: NgDocInitialContentScrollIntent;\n  private readonly listeners = new Set<\n    (intent: NgDocInitialContentScrollIntent | undefined) => void\n  >();\n  private started = false;\n  private successful = false;\n  private subscription?: Subscription;\n  private readonly intentState = signal<NgDocInitialContentScrollIntent | undefined>(undefined);\n\n  /**\n   * The pending initial intent as a signal, the same value `subscribe()` listeners receive.\n   */\n  readonly currentIntent: Signal<NgDocInitialContentScrollIntent | undefined> =\n    this.intentState.asReadonly();\n\n  constructor() {\n    inject(DestroyRef).onDestroy(() => this.destroy());\n  }\n\n  /**\n   * Starts following router events. Does nothing on the server or when already started. Started\n   * during a navigation, it follows that navigation too.\n   */\n  start(): void {\n    if (this.started || !this.browser) return;\n    this.started = true;\n    this.followCurrentNavigation();\n    this.subscription = this.router.events.subscribe((event) => {\n      if (event instanceof NavigationStart) this.navigationStarted(event);\n      else if (event instanceof NavigationEnd) this.navigationEnded(event);\n      else if (event instanceof Scroll) this.scrolled(event);\n      else if (\n        event instanceof NavigationCancel ||\n        event instanceof NavigationError ||\n        event instanceof NavigationSkipped\n      ) {\n        if (this.candidate && event.id >= this.candidate.navigationId) this.candidate = undefined;\n        if (this.intent && event.id >= this.intent.navigationId) this.publish(undefined);\n      }\n    });\n  }\n\n  /**\n   * Calls the listener with every change of the intent, and at once with the pending one.\n   * @param listener - Receives the intent, or `undefined` once it is consumed or cancelled.\n   * @returns A function that removes the listener.\n   */\n  subscribe(listener: (intent: NgDocInitialContentScrollIntent | undefined) => void): () => void {\n    this.listeners.add(listener);\n    if (this.intent) listener(this.intent);\n    return () => this.listeners.delete(listener);\n  }\n\n  /**\n   * Consumes the current fallback after its page has either replayed or explicitly yielded it.\n   * @param navigationId - The navigation of the intent to consume.\n   */\n  settle(navigationId: number): void {\n    if (this.intent?.navigationId === navigationId) this.publish(undefined);\n  }\n\n  private navigationStarted(event: NavigationStart): void {\n    this.publish(undefined);\n    const navigation = this.router.currentNavigation();\n    this.candidate = {\n      navigationId: event.id,\n      eligible:\n        !this.successful &&\n        event.navigationTrigger === 'imperative' &&\n        event.restoredState == null &&\n        navigation?.id === event.id &&\n        navigation.previousNavigation === null &&\n        navigation.extras.scroll !== 'manual',\n    };\n  }\n\n  /**\n   * Takes the navigation in progress as the candidate. The providers of a lazy route start the\n   * intent while the router loads that route, after the first navigation has started, and its\n   * fragment must still be replayed.\n   */\n  private followCurrentNavigation(): void {\n    const navigation = this.router.currentNavigation();\n\n    if (!navigation) return;\n\n    // The router restores the history state of the first navigation, as `restoredState` of its\n    // NavigationStart, when that state has a navigation id.\n    const state = this.location.getState() as { navigationId?: unknown } | null;\n\n    this.candidate = {\n      navigationId: navigation.id,\n      eligible:\n        navigation.trigger === 'imperative' &&\n        navigation.previousNavigation === null &&\n        !state?.navigationId &&\n        navigation.extras.scroll !== 'manual',\n    };\n  }\n\n  private navigationEnded(event: NavigationEnd): void {\n    const candidate = this.candidate;\n    this.candidate = undefined;\n    this.successful = true;\n    if (!candidate?.eligible || candidate.navigationId !== event.id) return;\n    const anchor = this.router.parseUrl(event.urlAfterRedirects).fragment;\n    if (anchor) {\n      this.publish({ anchor, navigationId: event.id, url: event.urlAfterRedirects });\n    }\n  }\n\n  private scrolled(event: Scroll): void {\n    if (this.intent && event.routerEvent.id >= this.intent.navigationId) this.publish(undefined);\n    if (this.candidate && event.routerEvent.id >= this.candidate.navigationId) {\n      this.candidate = undefined;\n    }\n  }\n\n  private publish(intent: NgDocInitialContentScrollIntent | undefined): void {\n    if (this.intent === intent) return;\n    this.intent = intent;\n    this.intentState.set(intent);\n    for (const listener of [...this.listeners]) listener(intent);\n  }\n\n  private destroy(): void {\n    this.subscription?.unsubscribe();\n    this.subscription = undefined;\n    this.candidate = undefined;\n    this.intent = undefined;\n    this.intentState.set(undefined);\n    this.listeners.clear();\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/ng-doc-app-services-highlighter.mjs

@@ -2,11 +2,11 @@ import * as i0 from '@angular/core';
 import { signal, inject, isDevMode, Service } from '@angular/core';
 import { NG_DOC_SHIKI_THEME } from '@ng-doc/app/tokens';
 import { ngDocSyntaxTheme } from '@ng-doc/core/constants/syntax-theme';
-import { createHighlighterCore } from 'shiki/core';
-import getWasm from 'shiki/wasm';
 
 /**
- * Highlights code with Shiki. `provideNgDocApp` initializes it before the application renders.
+ * Highlights code with Shiki. `provideNgDocApp` starts its initialization where it is provided (the
+ * application, or the route that holds the documentation), and the server render waits for it.
+ * Shiki is loaded on demand: `initialize()` imports it.
  */
 class NgDocHighlighterService {
     constructor() {
@@ -23,9 +23,9 @@ class NgDocHighlighterService {
     }
     /**
      * Loads Shiki with the built-in themes (`github-light`, `ayu-dark` and NgDoc's `css-variables`)
-     * and the given ones. Concurrent and repeated calls share one initialization; a failed one can
-     * be retried.
-     * @param config - Custom Shiki themes to load.
+     * and the given ones, and the given languages. Concurrent and repeated calls share one
+     * initialization; a failed one can be retried.
+     * @param config - Custom Shiki themes and languages to load.
      */
     initialize(config) {
         if (this.destroyed) {
@@ -39,11 +39,11 @@ class NgDocHighlighterService {
                 '`shiki.themes` of `ng-doc.config.ts`: NgDoc uses them for the code blocks and the ' +
                 'code that the browser highlights.');
         }
-        // Only immutable built-in themes are shared across SSR applications. Custom
-        // themes may reuse names with different colors, or be asynchronous getters.
-        this.ownsHighlighter = Boolean(config?.themes?.length);
+        // Only immutable built-in themes and languages are shared across SSR applications. Custom
+        // ones may reuse names with other definitions, or be asynchronous getters.
+        this.ownsHighlighter = Boolean(config?.themes?.length || config?.langs?.length);
         const creation = this.ownsHighlighter
-            ? NgDocHighlighterService.create(config?.themes)
+            ? NgDocHighlighterService.create(config?.themes, config?.langs)
             : (NgDocHighlighterService.defaultInitialization ??= NgDocHighlighterService.create().catch((error) => {
                 NgDocHighlighterService.defaultInitialization = undefined;
                 throw error;
@@ -65,7 +65,7 @@ class NgDocHighlighterService {
         });
         return this.initialization;
     }
-    /** Disposes the highlighter this service created for custom themes. */
+    /** Disposes the highlighter this service created for custom themes or languages. */
     ngOnDestroy() {
         this.destroyed = true;
         this.readyState.set(false);
@@ -74,8 +74,12 @@ class NgDocHighlighterService {
         }
         this.highlighter = undefined;
     }
-    static async create(themes = []) {
-        return (await createHighlighterCore({
+    static async create(themes = [], langs = []) {
+        const [{ createHighlighterCore }, { createOnigurumaEngine }] = await Promise.all([
+            import('shiki/core'),
+            import('shiki/engine/oniguruma'),
+        ]);
+        return createHighlighterCore({
             themes: [
                 import('shiki/themes/github-light.mjs'),
                 import('shiki/themes/ayu-dark.mjs'),
@@ -83,9 +87,12 @@ class NgDocHighlighterService {
                 ngDocSyntaxTheme(),
                 ...themes,
             ],
-            langs: [import('shiki/langs/angular-html.mjs')],
-            loadWasm: getWasm,
-        }));
+            // Later registrations of a name replace earlier ones, so the given languages win.
+            langs: [import('shiki/langs/angular-html.mjs'), ...langs],
+            // The Oniguruma engine, as at build time, so that the browser tokenizes code as the code
+            // blocks were tokenized.
+            engine: createOnigurumaEngine(import('shiki/wasm')),
+        });
     }
     /**
      * Returns the code as highlighted HTML, or an empty string before `initialize()` has