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

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

@@ -0,0 +1,214 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, inject, DOCUMENT, Injector, NgZone, PLATFORM_ID, signal, computed, afterNextRender, DestroyRef, untracked, Service } from '@angular/core';
+import { isPlatformBrowser } from '@angular/common';
+import { NgDocStoreService } from '@ng-doc/app/services/store';
+import { NgDocThemeService } from '@ng-doc/app/services/theme';
+
+/**
+ * Whether single-key shortcuts are on for readers who have not turned them on or off themselves.
+ * The default is true. Set it with the shortcuts option of provideNgDocApp.
+ */
+const NG_DOC_SHORTCUTS = new InjectionToken('NG_DOC_SHORTCUTS', { factory: () => true });
+/**
+ * The local storage key that keeps a reader's choice to turn single-key shortcuts on ("1") or off
+ * ("0").
+ */
+const NG_DOC_STORE_SHORTCUTS_KEY = 'ng-doc-shortcuts';
+
+/**
+ * Elements where a single key types text or drives the widget instead of running a shortcut:
+ * fields, widgets with their own key handling or typeahead, and demos and playgrounds, which
+ * host the reader's components.
+ */
+const OWN_KEYS = [
+    'input',
+    'textarea',
+    'select',
+    '[contenteditable]:not([contenteditable="false"])',
+    ...[
+        'combobox',
+        'listbox',
+        'menu',
+        'menubar',
+        'grid',
+        'tree',
+        'treegrid',
+        'slider',
+        'spinbutton',
+        'application',
+    ].map((role) => `[role="${role}"]`),
+    'ng-doc-demo',
+    'ng-doc-demo-pane',
+    'ng-doc-playground',
+].join(', ');
+/**
+ * Keyboard shortcuts of the documentation.
+ *
+ * Single-key shortcuts (slash opens the search, the square brackets open the previous and next
+ * page, F focuses the filter of the page, L copies the link to the page and T switches between
+ * the light and the dark theme) are on by default. Readers turn them all off with one switch, and
+ * the choice is saved in the browser. A site turns them off by default with the shortcuts option
+ * of provideNgDocApp. They never run while the reader types in a field or holds Command, Control
+ * or Alt. Chords such as Command+K (Control+K) always work.
+ */
+class NgDocShortcutsService {
+    constructor() {
+        this.document = inject(DOCUMENT);
+        this.injector = inject(Injector);
+        this.ngZone = inject(NgZone);
+        this.browser = isPlatformBrowser(inject(PLATFORM_ID));
+        this.appDefault = inject(NG_DOC_SHORTCUTS);
+        this.userChoice = signal(undefined, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "userChoice" }] : /* istanbul ignore next */ []));
+        this.shortcuts = [];
+        /**
+         * Whether single-key shortcuts are on: the reader's saved choice, or the site's default.
+         * Components hide the hints of single-key shortcuts while it is false.
+         */
+        this.enabled = computed(() => this.userChoice() ?? this.appDefault, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "enabled" }] : /* istanbul ignore next */ []));
+        this.registerDefaults();
+        if (!this.browser) {
+            return;
+        }
+        // The saved choice is read after the first render, so a hydrated page first renders exactly
+        // what the server rendered (the site's default) and then switches.
+        afterNextRender(() => this.userChoice.set(this.readChoice()), { injector: this.injector });
+        const listener = (event) => this.onKeydown(event);
+        // One document listener for every shortcut; change detection runs only when one matches.
+        this.ngZone.runOutsideAngular(() => this.document.addEventListener('keydown', listener));
+        inject(DestroyRef).onDestroy(() => this.document.removeEventListener('keydown', listener));
+    }
+    /**
+     * Turns single-key shortcuts on or off for this reader and saves the choice in the browser.
+     * @param enabled - Whether single-key shortcuts should run.
+     */
+    setEnabled(enabled) {
+        this.userChoice.set(enabled);
+        if (this.browser) {
+            try {
+                this.injector.get(NgDocStoreService).set(NG_DOC_STORE_SHORTCUTS_KEY, enabled ? '1' : '0');
+            }
+            catch {
+                // Storage can be unavailable (private mode, blocked cookies); the choice lasts the visit.
+            }
+        }
+    }
+    /** Turns single-key shortcuts off when they are on, and on when they are off. */
+    toggle() {
+        this.setEnabled(!untracked(this.enabled));
+    }
+    /**
+     * Registers a shortcut. When several shortcuts use the same key, the one registered last runs,
+     * so a page can take over a key while it is shown and give it back when it is destroyed.
+     * @param shortcut - The shortcut to register.
+     * @returns A function that removes the shortcut.
+     */
+    register(shortcut) {
+        this.shortcuts.push(shortcut);
+        return () => {
+            const index = this.shortcuts.lastIndexOf(shortcut);
+            if (index !== -1) {
+                this.shortcuts.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Runs the single-key shortcut registered for a key, as if the reader pressed it, even while
+     * single-key shortcuts are off. The search palette uses it for its actions.
+     * @param key - The key of the shortcut, for example 't'.
+     * @returns Whether a shortcut is registered for the key.
+     */
+    run(key) {
+        const shortcut = this.find(key.toLowerCase(), false);
+        untracked(() => shortcut?.handler());
+        return !!shortcut;
+    }
+    onKeydown(event) {
+        if (event.defaultPrevented || event.isComposing || event.repeat || !event.key) {
+            return;
+        }
+        // AltGr (Control+Alt on Windows) types characters such as [ and ] on many layouts: those
+        // keys are plain characters, not chords.
+        const altGraph = !!event.getModifierState?.('AltGraph');
+        const chord = !altGraph && (event.metaKey || event.ctrlKey) && !event.altKey;
+        const shortcut = this.find(event.key.toLowerCase(), chord);
+        if (!shortcut || (!chord && !this.acceptsSingleKey(event, altGraph))) {
+            return;
+        }
+        event.preventDefault();
+        this.ngZone.run(() => untracked(() => shortcut.handler(event)));
+    }
+    find(key, chord) {
+        for (let index = this.shortcuts.length - 1; index >= 0; index--) {
+            const shortcut = this.shortcuts[index];
+            if (shortcut.key.toLowerCase() === key && !!shortcut.chord === chord) {
+                return shortcut;
+            }
+        }
+        return undefined;
+    }
+    acceptsSingleKey(event, altGraph) {
+        if (!untracked(this.enabled) ||
+            event.metaKey ||
+            (!altGraph && (event.ctrlKey || event.altKey))) {
+            return false;
+        }
+        const target = event.composedPath?.()[0] ?? event.target;
+        return !(target instanceof Element && target.closest(OWN_KEYS));
+    }
+    readChoice() {
+        try {
+            const saved = this.injector.get(NgDocStoreService).get(NG_DOC_STORE_SHORTCUTS_KEY);
+            return saved === '1' ? true : saved === '0' ? false : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    registerDefaults() {
+        this.register({ key: 't', handler: () => this.toggleDarkTheme() });
+        this.register({ key: 'l', handler: () => this.copyLink() });
+        // Pager links: rel="prev"/"next" is the standard marker; the classes are the NgDoc pager's.
+        this.register({ key: '[', handler: () => this.click('a[rel~="prev"], a.ng-doc-prev-page') });
+        this.register({ key: ']', handler: () => this.click('a[rel~="next"], a.ng-doc-next-page') });
+    }
+    toggleDarkTheme() {
+        const themeService = this.injector.get(NgDocThemeService);
+        const theme = themeService.theme();
+        const toggle = this.themeToggle;
+        // A second T restores the theme the first one replaced (auto or a custom theme), unless the
+        // reader changed the theme in between.
+        if (toggle && toggle.set === theme) {
+            this.themeToggle = undefined;
+            themeService.set(toggle.previous ?? undefined);
+            return;
+        }
+        const dark = theme === 'dark' ||
+            (theme === 'auto' &&
+                !!this.document.defaultView?.matchMedia?.('(prefers-color-scheme: dark)').matches);
+        const next = dark ? null : 'dark';
+        this.themeToggle = { previous: theme, set: next };
+        themeService.set(next ?? undefined);
+    }
+    copyLink() {
+        void this.document.defaultView?.navigator.clipboard
+            ?.writeText(this.document.location.href)
+            .catch(() => undefined);
+    }
+    click(selector) {
+        this.document.querySelector(selector)?.click();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocShortcutsService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.1", ngImport: i0, type: NgDocShortcutsService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocShortcutsService, decorators: [{
+            type: Service
+        }], ctorParameters: () => [] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { NG_DOC_SHORTCUTS, NG_DOC_STORE_SHORTCUTS_KEY, NgDocShortcutsService };
+//# sourceMappingURL=ng-doc-app-services-shortcuts.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ng-doc-app-services-shortcuts.mjs","sources":["../../../../libs/app/services/shortcuts/shortcut.ts","../../../../libs/app/services/shortcuts/shortcuts.service.ts","../../../../libs/app/services/shortcuts/ng-doc-app-services-shortcuts.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\n\n/**\n * A keyboard shortcut registered with the NgDocShortcutsService.\n */\nexport interface NgDocShortcut {\n  /**\n   * The key that runs the shortcut, compared with the key of the keyboard event without regard to\n   * case, for example '/', '[' or 'f'.\n   */\n  key: string;\n  /**\n   * Whether the shortcut is a chord with the Command key (macOS) or the Control key (elsewhere).\n   * Chords always work: in text fields too, and when single-key shortcuts are turned off. Other\n   * shortcuts are single keys: they run only while single-key shortcuts are on, never while the\n   * reader types in a field, and never with Command, Control or Alt held.\n   */\n  chord?: boolean;\n  /**\n   * Runs the shortcut. The default action of the keyboard event is prevented before it runs. The\n   * event is missing when the shortcut runs from the search palette.\n   */\n  handler: (event?: KeyboardEvent) => void;\n}\n\n/**\n * Whether single-key shortcuts are on for readers who have not turned them on or off themselves.\n * The default is true. Set it with the shortcuts option of provideNgDocApp.\n */\nexport const NG_DOC_SHORTCUTS: InjectionToken<boolean> = new InjectionToken<boolean>(\n  'NG_DOC_SHORTCUTS',\n  { factory: () => true },\n);\n\n/**\n * The local storage key that keeps a reader's choice to turn single-key shortcuts on (\"1\") or off\n * (\"0\").\n */\nexport const NG_DOC_STORE_SHORTCUTS_KEY: string = 'ng-doc-shortcuts';\n","import { isPlatformBrowser } from '@angular/common';\nimport {\n  afterNextRender,\n  computed,\n  DestroyRef,\n  DOCUMENT,\n  inject,\n  Injector,\n  NgZone,\n  PLATFORM_ID,\n  Service,\n  Signal,\n  signal,\n  untracked,\n} from '@angular/core';\nimport { NgDocStoreService } from '@ng-doc/app/services/store';\nimport { NgDocThemeService } from '@ng-doc/app/services/theme';\n\nimport { NG_DOC_SHORTCUTS, NG_DOC_STORE_SHORTCUTS_KEY, NgDocShortcut } from './shortcut';\n\n/**\n * Elements where a single key types text or drives the widget instead of running a shortcut:\n * fields, widgets with their own key handling or typeahead, and demos and playgrounds, which\n * host the reader's components.\n */\nconst OWN_KEYS = [\n  'input',\n  'textarea',\n  'select',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  ...[\n    'combobox',\n    'listbox',\n    'menu',\n    'menubar',\n    'grid',\n    'tree',\n    'treegrid',\n    'slider',\n    'spinbutton',\n    'application',\n  ].map((role: string) => `[role=\"${role}\"]`),\n  'ng-doc-demo',\n  'ng-doc-demo-pane',\n  'ng-doc-playground',\n].join(', ');\n\n/**\n * Keyboard shortcuts of the documentation.\n *\n * Single-key shortcuts (slash opens the search, the square brackets open the previous and next\n * page, F focuses the filter of the page, L copies the link to the page and T switches between\n * the light and the dark theme) are on by default. Readers turn them all off with one switch, and\n * the choice is saved in the browser. A site turns them off by default with the shortcuts option\n * of provideNgDocApp. They never run while the reader types in a field or holds Command, Control\n * or Alt. Chords such as Command+K (Control+K) always work.\n */\n@Service()\nexport class NgDocShortcutsService {\n  private readonly document = inject(DOCUMENT);\n  private readonly injector = inject(Injector);\n  private readonly ngZone = inject(NgZone);\n  private readonly browser = isPlatformBrowser(inject(PLATFORM_ID));\n  private readonly appDefault = inject(NG_DOC_SHORTCUTS);\n  private readonly userChoice = signal<boolean | undefined>(undefined);\n  private readonly shortcuts: NgDocShortcut[] = [];\n  // The theme T switched away from, and the theme it set, so a second T restores the first.\n  private themeToggle?: { previous: string | null; set: string | null };\n\n  /**\n   * Whether single-key shortcuts are on: the reader's saved choice, or the site's default.\n   * Components hide the hints of single-key shortcuts while it is false.\n   */\n  readonly enabled: Signal<boolean> = computed(() => this.userChoice() ?? this.appDefault);\n\n  constructor() {\n    this.registerDefaults();\n\n    if (!this.browser) {\n      return;\n    }\n\n    // The saved choice is read after the first render, so a hydrated page first renders exactly\n    // what the server rendered (the site's default) and then switches.\n    afterNextRender(() => this.userChoice.set(this.readChoice()), { injector: this.injector });\n\n    const listener = (event: KeyboardEvent) => this.onKeydown(event);\n    // One document listener for every shortcut; change detection runs only when one matches.\n    this.ngZone.runOutsideAngular(() => this.document.addEventListener('keydown', listener));\n    inject(DestroyRef).onDestroy(() => this.document.removeEventListener('keydown', listener));\n  }\n\n  /**\n   * Turns single-key shortcuts on or off for this reader and saves the choice in the browser.\n   * @param enabled - Whether single-key shortcuts should run.\n   */\n  setEnabled(enabled: boolean): void {\n    this.userChoice.set(enabled);\n\n    if (this.browser) {\n      try {\n        this.injector.get(NgDocStoreService).set(NG_DOC_STORE_SHORTCUTS_KEY, enabled ? '1' : '0');\n      } catch {\n        // Storage can be unavailable (private mode, blocked cookies); the choice lasts the visit.\n      }\n    }\n  }\n\n  /** Turns single-key shortcuts off when they are on, and on when they are off. */\n  toggle(): void {\n    this.setEnabled(!untracked(this.enabled));\n  }\n\n  /**\n   * Registers a shortcut. When several shortcuts use the same key, the one registered last runs,\n   * so a page can take over a key while it is shown and give it back when it is destroyed.\n   * @param shortcut - The shortcut to register.\n   * @returns A function that removes the shortcut.\n   */\n  register(shortcut: NgDocShortcut): () => void {\n    this.shortcuts.push(shortcut);\n\n    return () => {\n      const index = this.shortcuts.lastIndexOf(shortcut);\n\n      if (index !== -1) {\n        this.shortcuts.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Runs the single-key shortcut registered for a key, as if the reader pressed it, even while\n   * single-key shortcuts are off. The search palette uses it for its actions.\n   * @param key - The key of the shortcut, for example 't'.\n   * @returns Whether a shortcut is registered for the key.\n   */\n  run(key: string): boolean {\n    const shortcut = this.find(key.toLowerCase(), false);\n\n    untracked(() => shortcut?.handler());\n\n    return !!shortcut;\n  }\n\n  private onKeydown(event: KeyboardEvent): void {\n    if (event.defaultPrevented || event.isComposing || event.repeat || !event.key) {\n      return;\n    }\n\n    // AltGr (Control+Alt on Windows) types characters such as [ and ] on many layouts: those\n    // keys are plain characters, not chords.\n    const altGraph = !!event.getModifierState?.('AltGraph');\n    const chord = !altGraph && (event.metaKey || event.ctrlKey) && !event.altKey;\n    const shortcut = this.find(event.key.toLowerCase(), chord);\n\n    if (!shortcut || (!chord && !this.acceptsSingleKey(event, altGraph))) {\n      return;\n    }\n\n    event.preventDefault();\n    this.ngZone.run(() => untracked(() => shortcut.handler(event)));\n  }\n\n  private find(key: string, chord: boolean): NgDocShortcut | undefined {\n    for (let index = this.shortcuts.length - 1; index >= 0; index--) {\n      const shortcut = this.shortcuts[index];\n\n      if (shortcut.key.toLowerCase() === key && !!shortcut.chord === chord) {\n        return shortcut;\n      }\n    }\n\n    return undefined;\n  }\n\n  private acceptsSingleKey(event: KeyboardEvent, altGraph: boolean): boolean {\n    if (\n      !untracked(this.enabled) ||\n      event.metaKey ||\n      (!altGraph && (event.ctrlKey || event.altKey))\n    ) {\n      return false;\n    }\n\n    const target = event.composedPath?.()[0] ?? event.target;\n\n    return !(target instanceof Element && target.closest(OWN_KEYS));\n  }\n\n  private readChoice(): boolean | undefined {\n    try {\n      const saved = this.injector.get(NgDocStoreService).get(NG_DOC_STORE_SHORTCUTS_KEY);\n\n      return saved === '1' ? true : saved === '0' ? false : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  private registerDefaults(): void {\n    this.register({ key: 't', handler: () => this.toggleDarkTheme() });\n    this.register({ key: 'l', handler: () => this.copyLink() });\n    // Pager links: rel=\"prev\"/\"next\" is the standard marker; the classes are the NgDoc pager's.\n    this.register({ key: '[', handler: () => this.click('a[rel~=\"prev\"], a.ng-doc-prev-page') });\n    this.register({ key: ']', handler: () => this.click('a[rel~=\"next\"], a.ng-doc-next-page') });\n  }\n\n  private toggleDarkTheme(): void {\n    const themeService = this.injector.get(NgDocThemeService);\n    const theme = themeService.theme();\n    const toggle = this.themeToggle;\n\n    // A second T restores the theme the first one replaced (auto or a custom theme), unless the\n    // reader changed the theme in between.\n    if (toggle && toggle.set === theme) {\n      this.themeToggle = undefined;\n      themeService.set(toggle.previous ?? undefined);\n\n      return;\n    }\n\n    const dark =\n      theme === 'dark' ||\n      (theme === 'auto' &&\n        !!this.document.defaultView?.matchMedia?.('(prefers-color-scheme: dark)').matches);\n    const next = dark ? null : 'dark';\n\n    this.themeToggle = { previous: theme, set: next };\n    themeService.set(next ?? undefined);\n  }\n\n  private copyLink(): void {\n    void this.document.defaultView?.navigator.clipboard\n      ?.writeText(this.document.location.href)\n      .catch(() => undefined);\n  }\n\n  private click(selector: string): void {\n    this.document.querySelector<HTMLElement>(selector)?.click();\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-sidebar.mjs

@@ -1,42 +1,67 @@
+import { isPlatformBrowser } from '@angular/common';
 import * as i0 from '@angular/core';
-import { inject, DOCUMENT, Injectable } from '@angular/core';
-import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { inject, DOCUMENT, NgZone, PLATFORM_ID, DestroyRef, Service } from '@angular/core';
+import { toSignal, takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { Router, NavigationEnd } from '@angular/router';
-import { ngDocZoneOptimize } from '@ng-doc/ui-kit';
 import { NgDocScrollService } from '@ng-doc/ui-kit/services/scroll';
 import { WA_WINDOW } from '@ng-web-apis/common';
-import { BehaviorSubject, fromEvent, share } from 'rxjs';
-import { startWith, filter } from 'rxjs/operators';
+import { BehaviorSubject } from 'rxjs';
+import { filter } from 'rxjs/operators';
 
+/**
+ * The widest viewport, in CSS pixels, at which the sidebar is an overlay that the navbar's menu
+ * button opens. It matches the `max-width: 900px` media query of `ng-doc-sidenav`.
+ */
+const NG_DOC_SIDEBAR_COLLAPSE_WIDTH = 900;
 /**
  * Service for sidebar, it can be used to hide/show sidebar or to check if sidebar is collapsable.
+ *
+ * On wide screens the sidebar is always shown. At `NG_DOC_SIDEBAR_COLLAPSE_WIDTH` and below it is
+ * an overlay: `show()` opens it and blocks page scrolling, `hide()` closes it, and a navigation
+ * or a resize to a wide screen ends the overlay.
  */
 class NgDocSidebarService {
     constructor() {
-        this.expanded = new BehaviorSubject(false);
         this.document = inject(DOCUMENT);
         this.window = inject(WA_WINDOW);
         this.router = inject(Router);
         this.scroll = inject(NgDocScrollService);
-        const windowResize = fromEvent(this.window, 'resize').pipe(takeUntilDestroyed(), startWith(null), share());
-        windowResize
-            .pipe(filter(() => this.expanded.value && this.isMobile), ngDocZoneOptimize(), takeUntilDestroyed())
-            .subscribe(() => this.hide());
-        windowResize
-            .pipe(filter(() => !this.expanded.value && !this.isMobile), ngDocZoneOptimize(), takeUntilDestroyed())
-            .subscribe(() => this.show());
-        windowResize
-            .pipe(filter(() => this.expanded.value && !this.isMobile), ngDocZoneOptimize(), takeUntilDestroyed())
-            .subscribe(() => this.scroll.unblock());
+        this.expanded = new BehaviorSubject(false);
+        /**
+         * Whether the sidebar is shown, as a signal. It follows the same state as `isExpanded()`.
+         */
+        this.expandedState = toSignal(this.expanded, { requireSync: true });
+        this.ngZone = inject(NgZone);
+        // On the server the sidebar stays closed: the prerendered page must not show the overlay
+        // open on narrow screens. The browser opens it on wide screens once the app starts.
+        if (isPlatformBrowser(inject(PLATFORM_ID))) {
+            this.syncWithViewport();
+            const onResize = () => {
+                // Only a change of the open state re-enters the Angular zone, so `isExpanded()`
+                // subscribers run inside it; other resizes stay outside.
+                if (this.isMobile === this.expanded.value) {
+                    this.ngZone.run(() => this.syncWithViewport());
+                }
+                else if (this.expanded.value) {
+                    this.scroll.unblock();
+                }
+            };
+            this.ngZone.runOutsideAngular(() => this.window.addEventListener('resize', onResize));
+            inject(DestroyRef).onDestroy(() => this.window.removeEventListener('resize', onResize));
+        }
         this.router.events
             .pipe(filter((event) => event instanceof NavigationEnd && this.expanded.value && this.isMobile), takeUntilDestroyed())
             .subscribe(() => this.hide());
     }
+    /**
+     * Whether the viewport is narrow enough for the sidebar to be an overlay.
+     */
     get isMobile() {
-        return this.window.innerWidth < 1024;
+        return this.window.innerWidth <= NG_DOC_SIDEBAR_COLLAPSE_WIDTH;
     }
     /**
      * Indicates if sidebar is visible, based on the show/hide methods.
+     * Read `expandedState` for the same value as a signal.
      */
     isExpanded() {
         return this.expanded.asObservable();
@@ -65,19 +90,28 @@ class NgDocSidebarService {
     toggle() {
         this.expanded.value ? this.hide() : this.show();
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocSidebarService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocSidebarService, providedIn: 'root' }); }
+    syncWithViewport() {
+        if (this.isMobile) {
+            this.hide();
+        }
+        else if (this.expanded.value) {
+            // The overlay may have blocked scrolling before the viewport grew.
+            this.scroll.unblock();
+        }
+        else {
+            this.show();
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocSidebarService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.1", ngImport: i0, type: NgDocSidebarService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocSidebarService, decorators: [{
-            type: Injectable,
-            args: [{
-                    providedIn: 'root',
-                }]
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocSidebarService, decorators: [{
+            type: Service
         }], ctorParameters: () => [] });
 
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { NgDocSidebarService };
+export { NG_DOC_SIDEBAR_COLLAPSE_WIDTH, NgDocSidebarService };
 //# sourceMappingURL=ng-doc-app-services-sidebar.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-services-sidebar.mjs","sources":["../../../../libs/app/services/sidebar/sidebar.service.ts","../../../../libs/app/services/sidebar/ng-doc-app-services-sidebar.ts"],"sourcesContent":["import { DOCUMENT, inject, Injectable } from '@angular/core';\nimport { takeUntilDestroyed } from '@angular/core/rxjs-interop';\nimport { NavigationEnd, Router } from '@angular/router';\nimport { ngDocZoneOptimize } from '@ng-doc/ui-kit';\nimport { NgDocScrollService } from '@ng-doc/ui-kit/services/scroll';\nimport { WA_WINDOW } from '@ng-web-apis/common';\nimport { BehaviorSubject, fromEvent, Observable, share } from 'rxjs';\nimport { filter, startWith } from 'rxjs/operators';\n\n/**\n * Service for sidebar, it can be used to hide/show sidebar or to check if sidebar is collapsable.\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class NgDocSidebarService {\n  protected readonly expanded = new BehaviorSubject<boolean>(false);\n  protected readonly document = inject(DOCUMENT);\n  protected readonly window = inject(WA_WINDOW);\n  protected readonly router = inject(Router);\n  protected readonly scroll = inject(NgDocScrollService);\n\n  constructor() {\n    const windowResize = fromEvent(this.window, 'resize').pipe(\n      takeUntilDestroyed(),\n      startWith(null),\n      share(),\n    );\n\n    windowResize\n      .pipe(\n        filter(() => this.expanded.value && this.isMobile),\n        ngDocZoneOptimize(),\n        takeUntilDestroyed(),\n      )\n      .subscribe(() => this.hide());\n\n    windowResize\n      .pipe(\n        filter(() => !this.expanded.value && !this.isMobile),\n        ngDocZoneOptimize(),\n        takeUntilDestroyed(),\n      )\n      .subscribe(() => this.show());\n\n    windowResize\n      .pipe(\n        filter(() => this.expanded.value && !this.isMobile),\n        ngDocZoneOptimize(),\n        takeUntilDestroyed(),\n      )\n      .subscribe(() => this.scroll.unblock());\n\n    this.router.events\n      .pipe(\n        filter((event) => event instanceof NavigationEnd && this.expanded.value && this.isMobile),\n        takeUntilDestroyed(),\n      )\n      .subscribe(() => this.hide());\n  }\n\n  get isMobile(): boolean {\n    return this.window.innerWidth < 1024;\n  }\n\n  /**\n   * Indicates if sidebar is visible, based on the show/hide methods.\n   */\n  isExpanded(): Observable<boolean> {\n    return this.expanded.asObservable();\n  }\n\n  /**\n   * Show sidebar, and block scrolling.\n   */\n  show(): void {\n    if (!this.expanded.value) {\n      this.expanded.next(true);\n      this.isMobile && this.scroll.block();\n    }\n  }\n\n  /**\n   * Hide sidebar, and unblock scrolling.\n   */\n  hide(): void {\n    if (this.expanded.value) {\n      this.expanded.next(false);\n      this.isMobile && this.scroll.unblock();\n    }\n  }\n\n  /**\n   * Toggle sidebar visibility.\n   */\n  toggle(): void {\n    this.expanded.value ? this.hide() : this.show();\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-sidebar.mjs","sources":["../../../../libs/app/services/sidebar/sidebar.service.ts","../../../../libs/app/services/sidebar/ng-doc-app-services-sidebar.ts"],"sourcesContent":["import { isPlatformBrowser } from '@angular/common';\nimport { DestroyRef, DOCUMENT, inject, NgZone, PLATFORM_ID, Service, Signal } from '@angular/core';\nimport { takeUntilDestroyed, toSignal } from '@angular/core/rxjs-interop';\nimport { NavigationEnd, Router } from '@angular/router';\nimport { NgDocScrollService } from '@ng-doc/ui-kit/services/scroll';\nimport { WA_WINDOW } from '@ng-web-apis/common';\nimport { BehaviorSubject, Observable } from 'rxjs';\nimport { filter } from 'rxjs/operators';\n\n/**\n * The widest viewport, in CSS pixels, at which the sidebar is an overlay that the navbar's menu\n * button opens. It matches the `max-width: 900px` media query of `ng-doc-sidenav`.\n */\nexport const NG_DOC_SIDEBAR_COLLAPSE_WIDTH = 900;\n\n/**\n * Service for sidebar, it can be used to hide/show sidebar or to check if sidebar is collapsable.\n *\n * On wide screens the sidebar is always shown. At `NG_DOC_SIDEBAR_COLLAPSE_WIDTH` and below it is\n * an overlay: `show()` opens it and blocks page scrolling, `hide()` closes it, and a navigation\n * or a resize to a wide screen ends the overlay.\n */\n@Service()\nexport class NgDocSidebarService {\n  protected readonly document = inject(DOCUMENT);\n  protected readonly window = inject(WA_WINDOW);\n  protected readonly router = inject(Router);\n  protected readonly scroll = inject(NgDocScrollService);\n\n  protected readonly expanded = new BehaviorSubject<boolean>(false);\n\n  /**\n   * Whether the sidebar is shown, as a signal. It follows the same state as `isExpanded()`.\n   */\n  readonly expandedState: Signal<boolean> = toSignal(this.expanded, { requireSync: true });\n\n  private readonly ngZone = inject(NgZone);\n\n  constructor() {\n    // On the server the sidebar stays closed: the prerendered page must not show the overlay\n    // open on narrow screens. The browser opens it on wide screens once the app starts.\n    if (isPlatformBrowser(inject(PLATFORM_ID))) {\n      this.syncWithViewport();\n\n      const onResize = (): void => {\n        // Only a change of the open state re-enters the Angular zone, so `isExpanded()`\n        // subscribers run inside it; other resizes stay outside.\n        if (this.isMobile === this.expanded.value) {\n          this.ngZone.run(() => this.syncWithViewport());\n        } else if (this.expanded.value) {\n          this.scroll.unblock();\n        }\n      };\n\n      this.ngZone.runOutsideAngular(() => this.window.addEventListener('resize', onResize));\n      inject(DestroyRef).onDestroy(() => this.window.removeEventListener('resize', onResize));\n    }\n\n    this.router.events\n      .pipe(\n        filter((event) => event instanceof NavigationEnd && this.expanded.value && this.isMobile),\n        takeUntilDestroyed(),\n      )\n      .subscribe(() => this.hide());\n  }\n\n  /**\n   * Whether the viewport is narrow enough for the sidebar to be an overlay.\n   */\n  get isMobile(): boolean {\n    return this.window.innerWidth <= NG_DOC_SIDEBAR_COLLAPSE_WIDTH;\n  }\n\n  /**\n   * Indicates if sidebar is visible, based on the show/hide methods.\n   * Read `expandedState` for the same value as a signal.\n   */\n  isExpanded(): Observable<boolean> {\n    return this.expanded.asObservable();\n  }\n\n  /**\n   * Show sidebar, and block scrolling.\n   */\n  show(): void {\n    if (!this.expanded.value) {\n      this.expanded.next(true);\n      this.isMobile && this.scroll.block();\n    }\n  }\n\n  /**\n   * Hide sidebar, and unblock scrolling.\n   */\n  hide(): void {\n    if (this.expanded.value) {\n      this.expanded.next(false);\n      this.isMobile && this.scroll.unblock();\n    }\n  }\n\n  /**\n   * Toggle sidebar visibility.\n   */\n  toggle(): void {\n    this.expanded.value ? this.hide() : this.show();\n  }\n\n  private syncWithViewport(): void {\n    if (this.isMobile) {\n      this.hide();\n    } else if (this.expanded.value) {\n      // The overlay may have blocked scrolling before the viewport grew.\n      this.scroll.unblock();\n    } else {\n      this.show();\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-services-store.mjs

@@ -1,8 +1,11 @@
 import * as i0 from '@angular/core';
-import { inject, Injectable } from '@angular/core';
+import { inject, Service } from '@angular/core';
 import { WA_LOCAL_STORAGE } from '@ng-web-apis/common';
 
 const DEFAULT_SERIALIZE = (v) => String(v);
+/**
+ * Reads and writes NgDoc settings (for example the theme) in the browser's local storage.
+ */
 class NgDocStoreService {
     constructor() {
         this.localStorage = inject(WA_LOCAL_STORAGE);
@@ -15,14 +18,11 @@ class NgDocStoreService {
             ? deserialize(this.localStorage.getItem(key))
             : this.localStorage.getItem(key);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocStoreService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocStoreService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocStoreService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.1", ngImport: i0, type: NgDocStoreService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocStoreService, decorators: [{
-            type: Injectable,
-            args: [{
-                    providedIn: 'root',
-                }]
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocStoreService, decorators: [{
+            type: Service
         }] });
 
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-services-store.mjs","sources":["../../../../libs/app/services/store/store.service.ts","../../../../libs/app/services/store/ng-doc-app-services-store.ts"],"sourcesContent":["import { inject, Injectable } from '@angular/core';\nimport { WA_LOCAL_STORAGE } from '@ng-web-apis/common';\n\nconst DEFAULT_SERIALIZE: (v: unknown) => string = (v: unknown) => String(v);\n\n@Injectable({\n\tprovidedIn: 'root',\n})\nexport class NgDocStoreService {\n\tprotected readonly localStorage: Storage = inject(WA_LOCAL_STORAGE);\n\n\tset(key: string, data: string): void;\n\tset<T>(key: string, data: T, serialize: (v: T) => string): void;\n\tset<T>(key: string, data: T, serialize: (v: T) => string = DEFAULT_SERIALIZE): void {\n\t\treturn this.localStorage.setItem(key, serialize(data));\n\t}\n\n\tget(key: string): string | null;\n\tget<T>(key: string, deserialize: (v: string | null) => T): T;\n\tget<T>(key: string, deserialize?: (v: string | null) => T): T | string | null {\n\t\treturn deserialize\n\t\t\t? deserialize(this.localStorage.getItem(key))\n\t\t\t: this.localStorage.getItem(key);\n\t}\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAGA,MAAM,iBAAiB,GAA2B,CAAC,CAAU,KAAK,MAAM,CAAC,CAAC,CAAC;MAK9D,iBAAiB,CAAA;AAH9B,IAAA,WAAA,GAAA;AAIoB,QAAA,IAAA,CAAA,YAAY,GAAY,MAAM,CAAC,gBAAgB,CAAC;AAenE,IAAA;AAXA,IAAA,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,YAA8B,iBAAiB,EAAA;AAC3E,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACvD;IAIA,GAAG,CAAI,GAAW,EAAE,WAAqC,EAAA;AACxD,QAAA,OAAO;cACJ,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;cAC1C,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;IAClC;8GAfY,iBAAiB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAjB,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,iBAAiB,cAFjB,MAAM,EAAA,CAAA,CAAA;;2FAEN,iBAAiB,EAAA,UAAA,EAAA,CAAA;kBAH7B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACX,oBAAA,UAAU,EAAE,MAAM;AAClB,iBAAA;;;ACPD;;AAEG;;;;"}
+{"version":3,"file":"ng-doc-app-services-store.mjs","sources":["../../../../libs/app/services/store/store.service.ts","../../../../libs/app/services/store/ng-doc-app-services-store.ts"],"sourcesContent":["import { inject, Service } from '@angular/core';\nimport { WA_LOCAL_STORAGE } from '@ng-web-apis/common';\n\nconst DEFAULT_SERIALIZE: (v: unknown) => string = (v: unknown) => String(v);\n\n/**\n * Reads and writes NgDoc settings (for example the theme) in the browser's local storage.\n */\n@Service()\nexport class NgDocStoreService {\n  protected readonly localStorage: Storage = inject(WA_LOCAL_STORAGE);\n\n  /**\n   * Stores a string value.\n   * @param key - Storage key.\n   * @param data - The value to store.\n   */\n  set(key: string, data: string): void;\n  /**\n   * Stores a value after serializing it.\n   * @param key - Storage key.\n   * @param data - The value to store.\n   * @param serialize - Converts the value to a string.\n   */\n  set<T>(key: string, data: T, serialize: (v: T) => string): void;\n  set<T>(key: string, data: T, serialize: (v: T) => string = DEFAULT_SERIALIZE): void {\n    return this.localStorage.setItem(key, serialize(data));\n  }\n\n  /**\n   * Returns the stored string, or `null` when the key is not set.\n   * @param key - Storage key.\n   */\n  get(key: string): string | null;\n  /**\n   * Returns the stored value, deserialized.\n   * @param key - Storage key.\n   * @param deserialize - Converts the stored string (or `null`) to the value.\n   */\n  get<T>(key: string, deserialize: (v: string | null) => T): T;\n  get<T>(key: string, deserialize?: (v: string | null) => T): T | string | null {\n    return deserialize\n      ? deserialize(this.localStorage.getItem(key))\n      : this.localStorage.getItem(key);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAGA,MAAM,iBAAiB,GAA2B,CAAC,CAAU,KAAK,MAAM,CAAC,CAAC,CAAC;AAE3E;;AAEG;MAEU,iBAAiB,CAAA;AAD9B,IAAA,WAAA,GAAA;AAEqB,QAAA,IAAA,CAAA,YAAY,GAAY,MAAM,CAAC,gBAAgB,CAAC;AAmCpE,IAAA;AApBC,IAAA,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,YAA8B,iBAAiB,EAAA;AAC1E,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACxD;IAaA,GAAG,CAAI,GAAW,EAAE,WAAqC,EAAA;AACvD,QAAA,OAAO;cACH,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;cAC1C,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;IACpC;8GAnCW,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;;;ACRD;;AAEG;;;;"}

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

@@ -1,11 +1,14 @@
 import * as i0 from '@angular/core';
-import { inject, DOCUMENT, Injectable } from '@angular/core';
+import { inject, DOCUMENT, signal, Service } from '@angular/core';
 import { NG_DOC_STORE_THEME_KEY } from '@ng-doc/app/constants';
 import { NgDocStoreService } from '@ng-doc/app/services/store';
 import { Subject } from 'rxjs';
 
 /**
  * Service for managing themes.
+ *
+ * The theme is the `data-theme` attribute of the document element: `auto`, `dark`, the id of a
+ * custom theme, or no attribute for the light theme.
  */
 class NgDocThemeService {
     constructor() {
@@ -13,13 +16,25 @@ class NgDocThemeService {
         this.store = inject(NgDocStoreService);
         this.change$ = new Subject();
         this.documentElement = this.document.documentElement;
+        this.themeState = signal(this.readTheme(), /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "themeState" }] : /* istanbul ignore next */ []));
+        /**
+         * The current theme as a signal: the theme id, or `null` for the light theme.
+         *
+         * It starts with the document's `data-theme` attribute and follows every `set()` call.
+         */
+        this.theme = this.themeState.asReadonly();
     }
     /**
-     * Returns the current theme.
+     * Returns the current theme: the document's `data-theme` attribute, or `null` without one.
      */
     get currentTheme() {
-        return document.documentElement.getAttribute('data-theme');
+        return this.readTheme();
     }
+    /**
+     * Emits the theme after every `set()` call. Read `theme` for the current value as a
+     * signal.
+     */
     themeChanges() {
         return this.change$.asObservable();
     }
@@ -28,18 +43,23 @@ class NgDocThemeService {
      * @param id - Theme id. If not provided, the theme will be removed.
      */
     set(id) {
-        id
-            ? this.documentElement.setAttribute('data-theme', id)
+        // An empty id removes the attribute, so it is the light theme (`null`) everywhere.
+        const theme = id || null;
+        theme
+            ? this.documentElement.setAttribute('data-theme', theme)
             : this.documentElement.removeAttribute('data-theme');
-        this.store.set(NG_DOC_STORE_THEME_KEY, id ?? '');
-        this.change$.next(id ?? null);
+        this.store.set(NG_DOC_STORE_THEME_KEY, theme ?? '');
+        this.themeState.set(theme);
+        this.change$.next(theme);
+    }
+    readTheme() {
+        return this.documentElement.getAttribute('data-theme');
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocThemeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocThemeService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocThemeService, deps: [], target: i0.ɵɵFactoryTarget.Service }); }
+    static { this.ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.1", ngImport: i0, type: NgDocThemeService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: NgDocThemeService, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.1", ngImport: i0, type: NgDocThemeService, decorators: [{
+            type: Service
         }] });
 
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"ng-doc-app-services-theme.mjs","sources":["../../../../libs/app/services/theme/theme.service.ts","../../../../libs/app/services/theme/ng-doc-app-services-theme.ts"],"sourcesContent":["import { DOCUMENT, inject, Injectable } from '@angular/core';\nimport { NG_DOC_STORE_THEME_KEY } from '@ng-doc/app/constants';\nimport { NgDocStoreService } from '@ng-doc/app/services/store';\nimport { Observable, Subject } from 'rxjs';\n\n/**\n * Service for managing themes.\n */\n@Injectable({ providedIn: 'root' })\nexport class NgDocThemeService {\n  protected readonly document = inject(DOCUMENT);\n  protected readonly store = inject(NgDocStoreService);\n  protected readonly change$ = new Subject<string | null>();\n  protected readonly documentElement = this.document.documentElement;\n\n  /**\n   * Returns the current theme.\n   */\n  get currentTheme(): string | null {\n    return document.documentElement.getAttribute('data-theme');\n  }\n\n  themeChanges(): Observable<string | null> {\n    return this.change$.asObservable();\n  }\n\n  /**\n   * Sets the theme by id.\n   * @param id - Theme id. If not provided, the theme will be removed.\n   */\n  set(id?: string): void {\n    id\n      ? this.documentElement.setAttribute('data-theme', id)\n      : this.documentElement.removeAttribute('data-theme');\n\n    this.store.set(NG_DOC_STORE_THEME_KEY, id ?? '');\n    this.change$.next(id ?? null);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;AAKA;;AAEG;MAEU,iBAAiB,CAAA;AAD9B,IAAA,WAAA,GAAA;AAEqB,QAAA,IAAA,CAAA,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AAC3B,QAAA,IAAA,CAAA,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC;AACjC,QAAA,IAAA,CAAA,OAAO,GAAG,IAAI,OAAO,EAAiB;AACtC,QAAA,IAAA,CAAA,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe;AAyBnE,IAAA;AAvBC;;AAEG;AACH,IAAA,IAAI,YAAY,GAAA;QACd,OAAO,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,YAAY,CAAC;IAC5D;IAEA,YAAY,GAAA;AACV,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;IACpC;AAEA;;;AAGG;AACH,IAAA,GAAG,CAAC,EAAW,EAAA;QACb;cACI,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE;cAClD,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,YAAY,CAAC;QAEtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC;IAC/B;8GA5BW,iBAAiB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAjB,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,iBAAiB,cADJ,MAAM,EAAA,CAAA,CAAA;;2FACnB,iBAAiB,EAAA,UAAA,EAAA,CAAA;kBAD7B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;;ACRlC;;AAEG;;;;"}
+{"version":3,"file":"ng-doc-app-services-theme.mjs","sources":["../../../../libs/app/services/theme/theme.service.ts","../../../../libs/app/services/theme/ng-doc-app-services-theme.ts"],"sourcesContent":["import { DOCUMENT, inject, Service, Signal, signal } from '@angular/core';\nimport { NG_DOC_STORE_THEME_KEY } from '@ng-doc/app/constants';\nimport { NgDocStoreService } from '@ng-doc/app/services/store';\nimport { Observable, Subject } from 'rxjs';\n\n/**\n * Service for managing themes.\n *\n * The theme is the `data-theme` attribute of the document element: `auto`, `dark`, the id of a\n * custom theme, or no attribute for the light theme.\n */\n@Service()\nexport class NgDocThemeService {\n  protected readonly document = inject(DOCUMENT);\n  protected readonly store = inject(NgDocStoreService);\n  protected readonly change$ = new Subject<string | null>();\n  protected readonly documentElement = this.document.documentElement;\n\n  private readonly themeState = signal<string | null>(this.readTheme());\n\n  /**\n   * The current theme as a signal: the theme id, or `null` for the light theme.\n   *\n   * It starts with the document's `data-theme` attribute and follows every `set()` call.\n   */\n  readonly theme: Signal<string | null> = this.themeState.asReadonly();\n\n  /**\n   * Returns the current theme: the document's `data-theme` attribute, or `null` without one.\n   */\n  get currentTheme(): string | null {\n    return this.readTheme();\n  }\n\n  /**\n   * Emits the theme after every `set()` call. Read `theme` for the current value as a\n   * signal.\n   */\n  themeChanges(): Observable<string | null> {\n    return this.change$.asObservable();\n  }\n\n  /**\n   * Sets the theme by id.\n   * @param id - Theme id. If not provided, the theme will be removed.\n   */\n  set(id?: string): void {\n    // An empty id removes the attribute, so it is the light theme (`null`) everywhere.\n    const theme = id || null;\n\n    theme\n      ? this.documentElement.setAttribute('data-theme', theme)\n      : this.documentElement.removeAttribute('data-theme');\n\n    this.store.set(NG_DOC_STORE_THEME_KEY, theme ?? '');\n    this.themeState.set(theme);\n    this.change$.next(theme);\n  }\n\n  private readTheme(): string | null {\n    return this.documentElement.getAttribute('data-theme');\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;AAKA;;;;;AAKG;MAEU,iBAAiB,CAAA;AAD9B,IAAA,WAAA,GAAA;AAEqB,QAAA,IAAA,CAAA,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AAC3B,QAAA,IAAA,CAAA,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC;AACjC,QAAA,IAAA,CAAA,OAAO,GAAG,IAAI,OAAO,EAAiB;AACtC,QAAA,IAAA,CAAA,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe;AAEjD,QAAA,IAAA,CAAA,UAAU,GAAG,MAAM,CAAgB,IAAI,CAAC,SAAS,EAAE;uFAAC;AAErE;;;;AAIG;AACM,QAAA,IAAA,CAAA,KAAK,GAA0B,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE;AAqCrE,IAAA;AAnCC;;AAEG;AACH,IAAA,IAAI,YAAY,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,SAAS,EAAE;IACzB;AAEA;;;AAGG;IACH,YAAY,GAAA;AACV,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;IACpC;AAEA;;;AAGG;AACH,IAAA,GAAG,CAAC,EAAW,EAAA;;AAEb,QAAA,MAAM,KAAK,GAAG,EAAE,IAAI,IAAI;QAExB;cACI,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK;cACrD,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,YAAY,CAAC;QAEtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC;AACnD,QAAA,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IAC1B;IAEQ,SAAS,GAAA;QACf,OAAO,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,YAAY,CAAC;IACxD;8GAjDW,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;;;;"}