@ng-doc/app 22.0.0-beta.1 → 22.0.0

package/fesm2022/ng-doc-app-services-content-state.mjs

@@ -0,0 +1,57 @@
+import * as i0 from '@angular/core';
+import { signal, Service } from '@angular/core';
+
+/** Request-local content failures observed by the SSR readiness boundary. */
+class NgDocContentState {
+    constructor() {
+        this.failures = new Map();
+        this.failureState = signal(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "failureState" }] : /* istanbul ignore next */ []));
+        /**
+         * The failure `currentFailure()` returns, as a signal. It changes with every
+         * `report()` and `clear()` call.
+         */
+        this.failure = this.failureState.asReadonly();
+    }
+    /**
+     * Records the failure of one content owner, replacing its previous failure.
+     * @param owner - The object that owns the content source.
+     * @param failure - The failure.
+     */
+    report(owner, failure) {
+        this.failures.set(owner, failure);
+        this.failureState.set(this.currentFailure());
+    }
+    /**
+     * Forgets the failure of one content owner.
+     * @param owner - The object that owns the content source.
+     */
+    clear(owner) {
+        if (!this.failures.delete(owner))
+            return;
+        this.failureState.set(this.currentFailure());
+    }
+    /** Returns the oldest failure that is still recorded, if any. */
+    currentFailure() {
+        return this.failures.values().next().value;
+    }
+    /** Throws the error of `currentFailure()`, if there is one. */
+    throwIfFailed() {
+        const failure = this.currentFailure();
+        if (failure) {
+            throw failure.error;
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocContentState, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.1", ngImport: i0, type: NgDocContentState }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocContentState, decorators: [{
+            type: Service
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { NgDocContentState };
+//# sourceMappingURL=ng-doc-app-services-content-state.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ng-doc-app-services-content-state.mjs","sources":["../../../../libs/app/services/content-state/content-state.service.ts","../../../../libs/app/services/content-state/ng-doc-app-services-content-state.ts"],"sourcesContent":["import { Service, Signal, signal } from '@angular/core';\n\n/** A content source that failed to load or to render. */\nexport interface NgDocContentFailure {\n  /** Id of the content source that failed. */\n  readonly contentId: string;\n  /** The error it failed with. */\n  readonly error: unknown;\n}\n\n/** Request-local content failures observed by the SSR readiness boundary. */\n@Service()\nexport class NgDocContentState {\n  private readonly failures = new Map<object, NgDocContentFailure>();\n  private readonly failureState = signal<NgDocContentFailure | undefined>(undefined);\n\n  /**\n   * The failure `currentFailure()` returns, as a signal. It changes with every\n   * `report()` and `clear()` call.\n   */\n  readonly failure: Signal<NgDocContentFailure | undefined> = this.failureState.asReadonly();\n\n  /**\n   * Records the failure of one content owner, replacing its previous failure.\n   * @param owner - The object that owns the content source.\n   * @param failure - The failure.\n   */\n  report(owner: object, failure: NgDocContentFailure): void {\n    this.failures.set(owner, failure);\n    this.failureState.set(this.currentFailure());\n  }\n\n  /**\n   * Forgets the failure of one content owner.\n   * @param owner - The object that owns the content source.\n   */\n  clear(owner: object): void {\n    if (!this.failures.delete(owner)) return;\n    this.failureState.set(this.currentFailure());\n  }\n\n  /** Returns the oldest failure that is still recorded, if any. */\n  currentFailure(): NgDocContentFailure | undefined {\n    return this.failures.values().next().value;\n  }\n\n  /** Throws the error of `currentFailure()`, if there is one. */\n  throwIfFailed(): void {\n    const failure = this.currentFailure();\n    if (failure) {\n      throw failure.error;\n    }\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAUA;MAEa,iBAAiB,CAAA;AAD9B,IAAA,WAAA,GAAA;AAEmB,QAAA,IAAA,CAAA,QAAQ,GAAG,IAAI,GAAG,EAA+B;QACjD,IAAA,CAAA,YAAY,GAAG,MAAM,CAAkC,SAAS;yFAAC;AAElF;;;AAGG;AACM,QAAA,IAAA,CAAA,OAAO,GAA4C,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE;AAiC3F,IAAA;AA/BC;;;;AAIG;IACH,MAAM,CAAC,KAAa,EAAE,OAA4B,EAAA;QAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IAC9C;AAEA;;;AAGG;AACH,IAAA,KAAK,CAAC,KAAa,EAAA;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE;QAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IAC9C;;IAGA,cAAc,GAAA;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK;IAC5C;;IAGA,aAAa,GAAA;AACX,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE;QACrC,IAAI,OAAO,EAAE;YACX,MAAM,OAAO,CAAC,KAAK;QACrB;IACF;8GAxCW,iBAAiB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,OAAA,EAAA,CAAA,CAAA;+GAAjB,iBAAiB,EAAA,CAAA,CAAA;;2FAAjB,iBAAiB,EAAA,UAAA,EAAA,CAAA;kBAD7B;;;ACXD;;AAEG;;;;"}

package/fesm2022/ng-doc-app-services-fullscreen-route.mjs

@@ -0,0 +1,74 @@
+import { isPlatformBrowser } from '@angular/common';
+import * as i0 from '@angular/core';
+import { signal, computed, inject, PLATFORM_ID, DOCUMENT, Service } from '@angular/core';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { Router, NavigationEnd, NavigationCancel, NavigationError, NavigationSkipped } from '@angular/router';
+import { filter, take } from 'rxjs/operators';
+
+/** The host attribute with which `ng-doc-root` tells that a fullscreen route is shown. */
+const ROOT_ATTRIBUTE = 'data-ng-doc-fullscreen-route';
+/**
+ * Tells whether a page shows one of its fullscreen routes: a child route of the page (see
+ * `route.children` of `NgDocPage`), which `ng-doc-page` shows on its own, on the canvas of demos,
+ * instead of the page. Pages with `disableFullscreenRoutes` never report one.
+ *
+ * While one is shown, `ng-doc-root` hides the navbar, the sidebar and the footer, and
+ * `ng-doc-page-wrapper` hides the breadcrumbs, the page header, the page links and the table of
+ * contents, so the route opens as a standalone page without changes to the application's template.
+ */
+class NgDocFullscreenRouteService {
+    constructor() {
+        this.pages = signal(new Set(), /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "pages" }] : /* istanbul ignore next */ []));
+        /**
+         * Whether the server rendered a fullscreen route, until the first navigation in the browser
+         * settles. `ng-doc-root` renders before its page does, and it must render the server's markup
+         * (and hide the same chrome) until the page tells again.
+         */
+        this.serverRendered = signal(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "serverRendered" }] : /* istanbul ignore next */ []));
+        /** Whether a page shows one of its fullscreen routes. */
+        this.active = computed(() => this.serverRendered() || this.pages().size > 0, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "active" }] : /* istanbul ignore next */ []));
+        if (!isPlatformBrowser(inject(PLATFORM_ID)))
+            return;
+        this.serverRendered.set(!!inject(DOCUMENT).querySelector(`ng-doc-root[${ROOT_ATTRIBUTE}="true"]`));
+        inject(Router)
+            .events.pipe(filter((event) => event instanceof NavigationEnd ||
+            event instanceof NavigationCancel ||
+            event instanceof NavigationError ||
+            event instanceof NavigationSkipped), take(1), takeUntilDestroyed())
+            .subscribe(() => this.serverRendered.set(false));
+    }
+    /**
+     * Records whether a page shows one of its fullscreen routes.
+     * @param page - The page.
+     * @param shown - Whether the page shows a fullscreen route.
+     * @internal
+     */
+    set(page, shown) {
+        const pages = this.pages();
+        if (pages.has(page) === shown)
+            return;
+        const next = new Set(pages);
+        if (shown) {
+            next.add(page);
+        }
+        else {
+            next.delete(page);
+        }
+        this.pages.set(next);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocFullscreenRouteService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.1", ngImport: i0, type: NgDocFullscreenRouteService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocFullscreenRouteService, decorators: [{
+            type: Service
+        }], ctorParameters: () => [] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { NgDocFullscreenRouteService };
+//# sourceMappingURL=ng-doc-app-services-fullscreen-route.mjs.map

package/fesm2022/ng-doc-app-services-fullscreen-route.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-doc-app-services-fullscreen-route.mjs","sources":["../../../../libs/app/services/fullscreen-route/fullscreen-route.service.ts","../../../../libs/app/services/fullscreen-route/ng-doc-app-services-fullscreen-route.ts"],"sourcesContent":["import { isPlatformBrowser } from '@angular/common';\nimport { computed, DOCUMENT, inject, PLATFORM_ID, Service, Signal, signal } from '@angular/core';\nimport { takeUntilDestroyed } from '@angular/core/rxjs-interop';\nimport {\n  Event,\n  NavigationCancel,\n  NavigationEnd,\n  NavigationError,\n  NavigationSkipped,\n  Router,\n} from '@angular/router';\nimport { filter, take } from 'rxjs/operators';\n\n/** The host attribute with which `ng-doc-root` tells that a fullscreen route is shown. */\nconst ROOT_ATTRIBUTE = 'data-ng-doc-fullscreen-route';\n\n/**\n * Tells whether a page shows one of its fullscreen routes: a child route of the page (see\n * `route.children` of `NgDocPage`), which `ng-doc-page` shows on its own, on the canvas of demos,\n * instead of the page. Pages with `disableFullscreenRoutes` never report one.\n *\n * While one is shown, `ng-doc-root` hides the navbar, the sidebar and the footer, and\n * `ng-doc-page-wrapper` hides the breadcrumbs, the page header, the page links and the table of\n * contents, so the route opens as a standalone page without changes to the application's template.\n */\n@Service()\nexport class NgDocFullscreenRouteService {\n  private readonly pages = signal<ReadonlySet<object>>(new Set());\n  /**\n   * Whether the server rendered a fullscreen route, until the first navigation in the browser\n   * settles. `ng-doc-root` renders before its page does, and it must render the server's markup\n   * (and hide the same chrome) until the page tells again.\n   */\n  private readonly serverRendered = signal<boolean>(false);\n\n  /** Whether a page shows one of its fullscreen routes. */\n  readonly active: Signal<boolean> = computed(() => this.serverRendered() || this.pages().size > 0);\n\n  constructor() {\n    if (!isPlatformBrowser(inject(PLATFORM_ID))) return;\n\n    this.serverRendered.set(\n      !!inject(DOCUMENT).querySelector(`ng-doc-root[${ROOT_ATTRIBUTE}=\"true\"]`),\n    );\n    inject(Router)\n      .events.pipe(\n        filter(\n          (event: Event) =>\n            event instanceof NavigationEnd ||\n            event instanceof NavigationCancel ||\n            event instanceof NavigationError ||\n            event instanceof NavigationSkipped,\n        ),\n        take(1),\n        takeUntilDestroyed(),\n      )\n      .subscribe(() => this.serverRendered.set(false));\n  }\n\n  /**\n   * Records whether a page shows one of its fullscreen routes.\n   * @param page - The page.\n   * @param shown - Whether the page shows a fullscreen route.\n   * @internal\n   */\n  set(page: object, shown: boolean): void {\n    const pages: ReadonlySet<object> = this.pages();\n\n    if (pages.has(page) === shown) return;\n\n    const next = new Set(pages);\n\n    if (shown) {\n      next.add(page);\n    } else {\n      next.delete(page);\n    }\n    this.pages.set(next);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;AAaA;AACA,MAAM,cAAc,GAAG,8BAA8B;AAErD;;;;;;;;AAQG;MAEU,2BAA2B,CAAA;AAYtC,IAAA,WAAA,GAAA;AAXiB,QAAA,IAAA,CAAA,KAAK,GAAG,MAAM,CAAsB,IAAI,GAAG,EAAE;kFAAC;AAC/D;;;;AAIG;QACc,IAAA,CAAA,cAAc,GAAG,MAAM,CAAU,KAAK;2FAAC;;AAG/C,QAAA,IAAA,CAAA,MAAM,GAAoB,QAAQ,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC;mFAAC;AAG/F,QAAA,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAAE;AAE7C,QAAA,IAAI,CAAC,cAAc,CAAC,GAAG,CACrB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAA,YAAA,EAAe,cAAc,CAAA,QAAA,CAAU,CAAC,CAC1E;QACD,MAAM,CAAC,MAAM;AACV,aAAA,MAAM,CAAC,IAAI,CACV,MAAM,CACJ,CAAC,KAAY,KACX,KAAK,YAAY,aAAa;AAC9B,YAAA,KAAK,YAAY,gBAAgB;AACjC,YAAA,KAAK,YAAY,eAAe;YAChC,KAAK,YAAY,iBAAiB,CACrC,EACD,IAAI,CAAC,CAAC,CAAC,EACP,kBAAkB,EAAE;AAErB,aAAA,SAAS,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpD;AAEA;;;;;AAKG;IACH,GAAG,CAAC,IAAY,EAAE,KAAc,EAAA;AAC9B,QAAA,MAAM,KAAK,GAAwB,IAAI,CAAC,KAAK,EAAE;AAE/C,QAAA,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK;YAAE;AAE/B,QAAA,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC;QAE3B,IAAI,KAAK,EAAE;AACT,YAAA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAChB;aAAO;AACL,YAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnB;AACA,QAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACtB;8GApDW,2BAA2B,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,OAAA,EAAA,CAAA,CAAA;+GAA3B,2BAA2B,EAAA,CAAA,CAAA;;2FAA3B,2BAA2B,EAAA,UAAA,EAAA,CAAA;kBADvC;;;ACzBD;;AAEG;;;;"}

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

@@ -1,29 +1,101 @@
 import * as i0 from '@angular/core';
-import { inject, Injectable } 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.
+ */
 class NgDocHighlighterService {
     constructor() {
+        this.ownsHighlighter = false;
+        this.destroyed = false;
+        this.readyState = signal(false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "readyState" }] : /* istanbul ignore next */ []));
         this.theme = inject(NG_DOC_SHIKI_THEME);
+        /**
+         * Whether `highlight()` can highlight: `true` once `initialize()` has finished, and
+         * `false` again after the service is destroyed.
+         */
+        this.ready = this.readyState.asReadonly();
     }
-    async initialize(config) {
-        if (NgDocHighlighterService.highlighter) {
-            return;
+    /**
+     * 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.
+     */
+    initialize(config) {
+        if (this.destroyed) {
+            return Promise.reject(new Error('NgDoc highlighter has been destroyed.'));
+        }
+        if (this.initialization) {
+            return this.initialization;
+        }
+        if (config?.theme && isDevMode()) {
+            console.warn('[NgDoc] `shiki.theme` of `provideNgDocApp` has no effect. Set the theme names in ' +
+                '`shiki.themes` of `ng-doc.config.ts`: NgDoc uses them for the code blocks and the ' +
+                'code that the browser highlights.');
         }
-        NgDocHighlighterService.highlighter = (await createHighlighterCore({
+        // 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);
+        const creation = this.ownsHighlighter
+            ? NgDocHighlighterService.create(config?.themes)
+            : (NgDocHighlighterService.defaultInitialization ??= NgDocHighlighterService.create().catch((error) => {
+                NgDocHighlighterService.defaultInitialization = undefined;
+                throw error;
+            }));
+        this.initialization = creation
+            .then((highlighter) => {
+            if (this.destroyed) {
+                if (this.ownsHighlighter) {
+                    highlighter.dispose();
+                }
+                return;
+            }
+            this.highlighter = highlighter;
+            this.readyState.set(true);
+        })
+            .catch((error) => {
+            this.initialization = undefined;
+            throw error;
+        });
+        return this.initialization;
+    }
+    /** Disposes the highlighter this service created for custom themes. */
+    ngOnDestroy() {
+        this.destroyed = true;
+        this.readyState.set(false);
+        if (this.ownsHighlighter) {
+            this.highlighter?.dispose();
+        }
+        this.highlighter = undefined;
+    }
+    static async create(themes = []) {
+        return (await createHighlighterCore({
             themes: [
                 import('shiki/themes/github-light.mjs'),
                 import('shiki/themes/ayu-dark.mjs'),
-                ...(config?.themes ?? []),
+                // A new copy: Shiki changes the theme object it loads.
+                ngDocSyntaxTheme(),
+                ...themes,
             ],
             langs: [import('shiki/langs/angular-html.mjs')],
             loadWasm: getWasm,
         }));
     }
+    /**
+     * Returns the code as highlighted HTML, or an empty string before `initialize()` has
+     * finished. It reads `ready()`, so a `computed` over it updates once Shiki is loaded.
+     * @param code - Angular HTML to highlight.
+     */
     highlight(code) {
-        return (NgDocHighlighterService.highlighter?.codeToHtml(code, {
+        if (!this.readyState())
+            return '';
+        return (this.highlighter?.codeToHtml(code, {
             lang: 'angular-html',
             themes: {
                 light: this.theme.light || 'github-light',
@@ -31,14 +103,11 @@ class NgDocHighlighterService {
             },
         }) ?? '');
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.6", ngImport: i0, type: NgDocHighlighterService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.0.6", ngImport: i0, type: NgDocHighlighterService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocHighlighterService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.1", ngImport: i0, type: NgDocHighlighterService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.6", ngImport: i0, type: NgDocHighlighterService, decorators: [{
-            type: Injectable,
-            args: [{
-                    providedIn: 'root',
-                }]
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocHighlighterService, decorators: [{
+            type: Service
         }] });
 
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-services-highlighter.mjs","sources":["../../../../libs/app/services/highlighter/highlighter.service.ts","../../../../libs/app/services/highlighter/ng-doc-app-services-highlighter.ts"],"sourcesContent":["import { inject, Injectable } from '@angular/core';\nimport { NG_DOC_SHIKI_THEME } from '@ng-doc/app/tokens';\nimport { HighlighterGeneric } from '@shikijs/core/types';\nimport { ThemeInput } from 'shiki';\nimport { createHighlighterCore } from 'shiki/core';\nimport getWasm from 'shiki/wasm';\n\nexport interface NgDocHighlighterConfig {\n  /**\n   * Themes sources.\n   */\n  themes?: ThemeInput[];\n  /**\n   * Theme that will be used for rendering the code blocks.\n   */\n  theme?: {\n    light: string;\n    dark: string;\n  };\n}\n\n@Injectable({\n  providedIn: 'root',\n})\nexport class NgDocHighlighterService {\n  private static highlighter?: HighlighterGeneric<string, string>;\n\n  protected readonly theme = inject(NG_DOC_SHIKI_THEME);\n\n  async initialize(config?: NgDocHighlighterConfig): Promise<void> {\n    if (NgDocHighlighterService.highlighter) {\n      return;\n    }\n    NgDocHighlighterService.highlighter = (await createHighlighterCore({\n      themes: [\n        import('shiki/themes/github-light.mjs'),\n        import('shiki/themes/ayu-dark.mjs'),\n        ...(config?.themes ?? []),\n      ],\n      langs: [import('shiki/langs/angular-html.mjs')],\n      loadWasm: getWasm,\n    })) as HighlighterGeneric<string, string>;\n  }\n\n  highlight(code: string): string {\n    return (\n      NgDocHighlighterService.highlighter?.codeToHtml(code, {\n        lang: 'angular-html',\n        themes: {\n          light: this.theme.light || 'github-light',\n          dark: this.theme.dark || 'ayu-dark',\n        },\n      }) ?? ''\n    );\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;MAwBa,uBAAuB,CAAA;AAHpC,IAAA,WAAA,GAAA;AAMqB,QAAA,IAAA,CAAA,KAAK,GAAG,MAAM,CAAC,kBAAkB,CAAC;AA4BtD,IAAA;IA1BC,MAAM,UAAU,CAAC,MAA+B,EAAA;AAC9C,QAAA,IAAI,uBAAuB,CAAC,WAAW,EAAE;YACvC;QACF;AACA,QAAA,uBAAuB,CAAC,WAAW,IAAI,MAAM,qBAAqB,CAAC;AACjE,YAAA,MAAM,EAAE;gBACN,OAAO,+BAA+B,CAAC;gBACvC,OAAO,2BAA2B,CAAC;AACnC,gBAAA,IAAI,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;AAC1B,aAAA;AACD,YAAA,KAAK,EAAE,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/C,YAAA,QAAQ,EAAE,OAAO;AAClB,SAAA,CAAC,CAAuC;IAC3C;AAEA,IAAA,SAAS,CAAC,IAAY,EAAA;QACpB,QACE,uBAAuB,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE;AACpD,YAAA,IAAI,EAAE,cAAc;AACpB,YAAA,MAAM,EAAE;AACN,gBAAA,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc;AACzC,gBAAA,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,UAAU;AACpC,aAAA;SACF,CAAC,IAAI,EAAE;IAEZ;8GA9BW,uBAAuB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAvB,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,uBAAuB,cAFtB,MAAM,EAAA,CAAA,CAAA;;2FAEP,uBAAuB,EAAA,UAAA,EAAA,CAAA;kBAHnC,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACvBD;;AAEG;;;;"}
+{"version":3,"file":"ng-doc-app-services-highlighter.mjs","sources":["../../../../libs/app/services/highlighter/highlighter.service.ts","../../../../libs/app/services/highlighter/ng-doc-app-services-highlighter.ts"],"sourcesContent":["import { inject, isDevMode, OnDestroy, Service, Signal, signal } from '@angular/core';\nimport { NG_DOC_SHIKI_THEME } from '@ng-doc/app/tokens';\nimport { ngDocSyntaxTheme } from '@ng-doc/core/constants/syntax-theme';\nimport { HighlighterGeneric } from '@shikijs/core/types';\nimport { ThemeInput } from 'shiki';\nimport { createHighlighterCore } from 'shiki/core';\nimport getWasm from 'shiki/wasm';\n\n/** Shiki configuration of the code highlighter. */\nexport interface NgDocHighlighterConfig {\n  /**\n   * Themes sources.\n   */\n  themes?: ThemeInput[];\n  /**\n   * Has no effect, and is reported in development mode.\n   *\n   * The theme names come from `shiki.themes` in `ng-doc.config.ts`: NgDoc highlights code blocks\n   * with them when it builds the site, and passes them to the application (`NG_DOC_SHIKI_THEME`),\n   * so the code that the browser highlights matches the code blocks.\n   * @deprecated Set the theme names in `shiki.themes` of `ng-doc.config.ts` instead, and load\n   * other themes with `themes`. This field will be removed in a future major release.\n   */\n  theme?: {\n    light: string;\n    dark: string;\n  };\n}\n\n/**\n * Highlights code with Shiki. `provideNgDocApp` initializes it before the application renders.\n */\n@Service()\nexport class NgDocHighlighterService implements OnDestroy {\n  private static defaultInitialization?: Promise<HighlighterGeneric<string, string>>;\n\n  private highlighter?: HighlighterGeneric<string, string>;\n  private initialization?: Promise<void>;\n  private ownsHighlighter = false;\n  private destroyed = false;\n  private readonly readyState = signal(false);\n\n  protected readonly theme = inject(NG_DOC_SHIKI_THEME);\n\n  /**\n   * Whether `highlight()` can highlight: `true` once `initialize()` has finished, and\n   * `false` again after the service is destroyed.\n   */\n  readonly ready: Signal<boolean> = this.readyState.asReadonly();\n\n  /**\n   * Loads Shiki with the built-in themes (`github-light`, `ayu-dark` and NgDoc's `css-variables`)\n   * and the given ones. Concurrent and repeated calls share one initialization; a failed one can\n   * be retried.\n   * @param config - Custom Shiki themes to load.\n   */\n  initialize(config?: NgDocHighlighterConfig): Promise<void> {\n    if (this.destroyed) {\n      return Promise.reject(new Error('NgDoc highlighter has been destroyed.'));\n    }\n    if (this.initialization) {\n      return this.initialization;\n    }\n    if (config?.theme && isDevMode()) {\n      console.warn(\n        '[NgDoc] `shiki.theme` of `provideNgDocApp` has no effect. Set the theme names in ' +\n          '`shiki.themes` of `ng-doc.config.ts`: NgDoc uses them for the code blocks and the ' +\n          'code that the browser highlights.',\n      );\n    }\n\n    // Only immutable built-in themes are shared across SSR applications. Custom\n    // themes may reuse names with different colors, or be asynchronous getters.\n    this.ownsHighlighter = Boolean(config?.themes?.length);\n    const creation = this.ownsHighlighter\n      ? NgDocHighlighterService.create(config?.themes)\n      : (NgDocHighlighterService.defaultInitialization ??= NgDocHighlighterService.create().catch(\n          (error: unknown) => {\n            NgDocHighlighterService.defaultInitialization = undefined;\n            throw error;\n          },\n        ));\n    this.initialization = creation\n      .then((highlighter) => {\n        if (this.destroyed) {\n          if (this.ownsHighlighter) {\n            highlighter.dispose();\n          }\n          return;\n        }\n        this.highlighter = highlighter;\n        this.readyState.set(true);\n      })\n      .catch((error: unknown) => {\n        this.initialization = undefined;\n        throw error;\n      });\n    return this.initialization;\n  }\n\n  /** Disposes the highlighter this service created for custom themes. */\n  ngOnDestroy(): void {\n    this.destroyed = true;\n    this.readyState.set(false);\n    if (this.ownsHighlighter) {\n      this.highlighter?.dispose();\n    }\n    this.highlighter = undefined;\n  }\n\n  private static async create(\n    themes: ThemeInput[] = [],\n  ): Promise<HighlighterGeneric<string, string>> {\n    return (await createHighlighterCore({\n      themes: [\n        import('shiki/themes/github-light.mjs'),\n        import('shiki/themes/ayu-dark.mjs'),\n        // A new copy: Shiki changes the theme object it loads.\n        ngDocSyntaxTheme(),\n        ...themes,\n      ],\n      langs: [import('shiki/langs/angular-html.mjs')],\n      loadWasm: getWasm,\n    })) as HighlighterGeneric<string, string>;\n  }\n\n  /**\n   * Returns the code as highlighted HTML, or an empty string before `initialize()` has\n   * finished. It reads `ready()`, so a `computed` over it updates once Shiki is loaded.\n   * @param code - Angular HTML to highlight.\n   */\n  highlight(code: string): string {\n    if (!this.readyState()) return '';\n\n    return (\n      this.highlighter?.codeToHtml(code, {\n        lang: 'angular-html',\n        themes: {\n          light: this.theme.light || 'github-light',\n          dark: this.theme.dark || 'ayu-dark',\n        },\n      }) ?? ''\n    );\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}