angular-toolbox 0.0.2 → 0.0.6

package/esm2020/lib/angular-toolbox.module.mjs

@@ -1,20 +1,26 @@
 import { NgModule } from '@angular/core';
 import { SafeHtmlPipe } from './pipe/safe/safe-html.pipe';
+import { DARK_MODE_CONFIG } from './service/ui/dark-mode.service';
 import * as i0 from "@angular/core";
 export class AngularToolboxModule {
 }
 AngularToolboxModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
 AngularToolboxModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, declarations: [SafeHtmlPipe], exports: [SafeHtmlPipe] });
-AngularToolboxModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule });
+AngularToolboxModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, providers: [
+        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }
+    ] });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, decorators: [{
             type: NgModule,
             args: [{
                     declarations: [
                         SafeHtmlPipe
                     ],
+                    providers: [
+                        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }
+                    ],
                     exports: [
                         SafeHtmlPipe
                     ]
                 }]
         }] });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYW5ndWxhci10b29sYm94Lm1vZHVsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3Byb2plY3RzL2FuZ3VsYXItdG9vbGJveC9zcmMvbGliL2FuZ3VsYXItdG9vbGJveC5tb2R1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7O0FBVTFELE1BQU0sT0FBTyxvQkFBb0I7O2lIQUFwQixvQkFBb0I7a0hBQXBCLG9CQUFvQixpQkFOekIsWUFBWSxhQUdaLFlBQVk7a0hBR1Asb0JBQW9COzJGQUFwQixvQkFBb0I7a0JBUmhDLFFBQVE7bUJBQUM7b0JBQ04sWUFBWSxFQUFFO3dCQUNWLFlBQVk7cUJBQ2Y7b0JBQ0QsT0FBTyxFQUFFO3dCQUNMLFlBQVk7cUJBQ2Y7aUJBQ0oiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBOZ01vZHVsZSB9IGZyb20gJ0Bhbmd1bGFyL2NvcmUnO1xyXG5pbXBvcnQgeyBTYWZlSHRtbFBpcGUgfSBmcm9tICcuL3BpcGUvc2FmZS9zYWZlLWh0bWwucGlwZSc7XHJcblxyXG5ATmdNb2R1bGUoe1xyXG4gICAgZGVjbGFyYXRpb25zOiBbXHJcbiAgICAgICAgU2FmZUh0bWxQaXBlXHJcbiAgICBdLFxyXG4gICAgZXhwb3J0czogW1xyXG4gICAgICAgIFNhZmVIdG1sUGlwZVxyXG4gICAgXVxyXG59KVxyXG5leHBvcnQgY2xhc3MgQW5ndWxhclRvb2xib3hNb2R1bGUgeyB9Il19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYW5ndWxhci10b29sYm94Lm1vZHVsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3Byb2plY3RzL2FuZ3VsYXItdG9vbGJveC9zcmMvbGliL2FuZ3VsYXItdG9vbGJveC5tb2R1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDMUQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7O0FBYWxFLE1BQU0sT0FBTyxvQkFBb0I7O2lIQUFwQixvQkFBb0I7a0hBQXBCLG9CQUFvQixpQkFUekIsWUFBWSxhQU1aLFlBQVk7a0hBR1Asb0JBQW9CLGFBUGxCO1FBQ1AsRUFBRSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsUUFBUSxFQUFFLGdCQUFnQixFQUFFO0tBQzFEOzJGQUtNLG9CQUFvQjtrQkFYaEMsUUFBUTttQkFBQztvQkFDTixZQUFZLEVBQUU7d0JBQ1YsWUFBWTtxQkFDZjtvQkFDRCxTQUFTLEVBQUU7d0JBQ1AsRUFBRSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsUUFBUSxFQUFFLGdCQUFnQixFQUFFO3FCQUMxRDtvQkFDSCxPQUFPLEVBQUU7d0JBQ0wsWUFBWTtxQkFDZjtpQkFDSiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IE5nTW9kdWxlIH0gZnJvbSAnQGFuZ3VsYXIvY29yZSc7XHJcbmltcG9ydCB7IFNhZmVIdG1sUGlwZSB9IGZyb20gJy4vcGlwZS9zYWZlL3NhZmUtaHRtbC5waXBlJztcclxuaW1wb3J0IHsgREFSS19NT0RFX0NPTkZJRyB9IGZyb20gJy4vc2VydmljZS91aS9kYXJrLW1vZGUuc2VydmljZSc7XHJcblxyXG5ATmdNb2R1bGUoe1xyXG4gICAgZGVjbGFyYXRpb25zOiBbXHJcbiAgICAgICAgU2FmZUh0bWxQaXBlXHJcbiAgICBdLFxyXG4gICAgcHJvdmlkZXJzOiBbXHJcbiAgICAgICAgeyBwcm92aWRlOiBEQVJLX01PREVfQ09ORklHLCB1c2VWYWx1ZTogREFSS19NT0RFX0NPTkZJRyB9XHJcbiAgICAgIF0sXHJcbiAgICBleHBvcnRzOiBbXHJcbiAgICAgICAgU2FmZUh0bWxQaXBlXHJcbiAgICBdXHJcbn0pXHJcbmV4cG9ydCBjbGFzcyBBbmd1bGFyVG9vbGJveE1vZHVsZSB7IH0iXX0=

package/esm2020/lib/service/index.mjs

@@ -1,2 +1,3 @@
 export * from './subscription/subscription.service';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9wcm9qZWN0cy9hbmd1bGFyLXRvb2xib3gvc3JjL2xpYi9zZXJ2aWNlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMscUNBQXFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL3N1YnNjcmlwdGlvbi9zdWJzY3JpcHRpb24uc2VydmljZSc7Il19
+export * from './ui/dark-mode.service';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9wcm9qZWN0cy9hbmd1bGFyLXRvb2xib3gvc3JjL2xpYi9zZXJ2aWNlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMscUNBQXFDLENBQUM7QUFDcEQsY0FBYyx3QkFBd0IsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gJy4vc3Vic2NyaXB0aW9uL3N1YnNjcmlwdGlvbi5zZXJ2aWNlJztcclxuZXhwb3J0ICogZnJvbSAnLi91aS9kYXJrLW1vZGUuc2VydmljZSc7Il19

package/esm2020/lib/service/ui/dark-mode.service.mjs

@@ -0,0 +1,153 @@
+import { Inject, Injectable, EventEmitter } from '@angular/core';
+import { DOCUMENT } from '@angular/common';
+import * as i0 from "@angular/core";
+// --> Internal constants
+const STORAGE_KEY = "dark-mode-key";
+const CSS_PROP = "dark-mode";
+const ADD_ACTION = "add";
+const REMOVE_ACTION = "remove";
+/**
+ * The default provider for the DarkModeService configuration. You typically define
+ * the custom properties in the main NgModule declaration to initialize the app dark mode:
+ *
+ * @NgModule({
+ * ...
+ * providers: [
+ *   { provide: DARK_MODE_CONFIG, useValue: { enableDarkMode: true} }
+ * ],
+ * ...
+ * s);
+ */
+export const DARK_MODE_CONFIG = {
+    /**
+     * Indicates whether the dark mode uses browser settings (true), or not (false).
+     * Default value is false.
+     */
+    darkModeEnbled: false,
+    /**
+     * Indicates whether the dark mode uses browser settings (true), or not (false).
+     * Default value is false.
+     */
+    detectBrowserSettings: false,
+    /**
+     * CSS property name used to set the dark mode look and feel.
+     * Default value is 'dark-mode'.
+     */
+    cssProperty: CSS_PROP,
+    /**
+     * Reference to the key value used to persist the dark mode state to local storage.
+     * Default value is 'dark-mode-key'.
+     */
+    storageKey: STORAGE_KEY
+};
+/**
+ * A lightweight service that provides Dark Mode implementation for your Angular application.
+ */
+export class DarkModeService {
+    /**
+     * Creates a new DarkModeService instance.
+     * @param _document the reference to the Document singleton.
+     * @param config the reference to the DarkModeConfig provider.
+     */
+    constructor(_document, config) {
+        this._document = _document;
+        // --> Private properties
+        this._darkModeEnbled = false;
+        this._cssProperty = CSS_PROP;
+        this._storageKey = STORAGE_KEY;
+        /**
+         * The callback function that is triggered when the dark mode changes.
+         * @typeParam EventEmitter<boolean> the value returned by the darkModeEnabled() property.
+         */
+        this.change = new EventEmitter(true);
+        this.initDarkMode(config);
+    }
+    /**
+     * Toogles the dark mode state.
+     */
+    toggleDarkMode() {
+        this._darkModeEnbled ? this.disableDarkMode() : this.enableDarkMode();
+    }
+    /**
+     * Sets the dark mode state to active.
+     */
+    enableDarkMode() {
+        this.setDarkMode(ADD_ACTION);
+        this.setStoredDarkMode();
+    }
+    /**
+     * Sets the dark mode state to inactive.
+     */
+    disableDarkMode() {
+        this.setDarkMode(REMOVE_ACTION);
+        this.setStoredDarkMode();
+    }
+    /**
+     * Returns a boolean value that indicates the dark mode state is active (true), or not (false).
+     * @returns true whether the dark mode state is active; false otherwise.
+     */
+    darkModeEnabled() {
+        return this._darkModeEnbled;
+    }
+    /**
+     * Removes the dark mode information from local storage.
+     */
+    invalidateStorage() {
+        localStorage.removeItem(this._storageKey);
+    }
+    // --> Private methods
+    initDarkMode(config) {
+        this._darkModeEnbled = config.darkModeEnbled || false;
+        this._cssProperty = config.cssProperty || CSS_PROP;
+        this._storageKey = config.storageKey || STORAGE_KEY;
+        if (this._darkModeEnbled) {
+            this.enableDarkMode();
+        }
+        else {
+            this.initStoredDarkMode();
+        }
+        if (config.detectBrowserSettings)
+            this.initBrowserMode();
+    }
+    initStoredDarkMode() {
+        const result = localStorage.getItem(this._storageKey);
+        if (result === "true")
+            this.enableDarkMode();
+    }
+    setStoredDarkMode() {
+        const data = String(this._darkModeEnbled);
+        localStorage.setItem(this._storageKey, data);
+    }
+    setDarkMode(action) {
+        const classList = this._document.body.classList;
+        if (action === ADD_ACTION) {
+            classList.add(this._cssProperty);
+            this._darkModeEnbled = true;
+        }
+        else if (action === REMOVE_ACTION) {
+            classList.remove(this._cssProperty);
+            this._darkModeEnbled = false;
+        }
+        this.change.emit(this._darkModeEnbled);
+    }
+    initBrowserMode() {
+        if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {
+            this.enableDarkMode();
+        }
+    }
+}
+DarkModeService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, deps: [{ token: DOCUMENT }, { token: DARK_MODE_CONFIG }], target: i0.ɵɵFactoryTarget.Injectable });
+DarkModeService.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, providedIn: 'root' });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: function () { return [{ type: Document, decorators: [{
+                    type: Inject,
+                    args: [DOCUMENT]
+                }] }, { type: undefined, decorators: [{
+                    type: Inject,
+                    args: [DARK_MODE_CONFIG]
+                }] }]; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGFyay1tb2RlLnNlcnZpY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9wcm9qZWN0cy9hbmd1bGFyLXRvb2xib3gvc3JjL2xpYi9zZXJ2aWNlL3VpL2RhcmstbW9kZS5zZXJ2aWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxNQUFNLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUNqRSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0saUJBQWlCLENBQUM7O0FBRTNDLHlCQUF5QjtBQUN6QixNQUFNLFdBQVcsR0FBVyxlQUFlLENBQUM7QUFDNUMsTUFBTSxRQUFRLEdBQVcsV0FBVyxDQUFDO0FBQ3JDLE1BQU0sVUFBVSxHQUFXLEtBQUssQ0FBQztBQUNqQyxNQUFNLGFBQWEsR0FBVyxRQUFRLENBQUM7QUE2QnZDOzs7Ozs7Ozs7OztHQVdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQW1CO0lBRTVDOzs7T0FHRztJQUNILGNBQWMsRUFBRSxLQUFLO0lBRXJCOzs7T0FHRztJQUNILHFCQUFxQixFQUFFLEtBQUs7SUFFNUI7OztPQUdHO0lBQ0gsV0FBVyxFQUFFLFFBQVE7SUFFckI7OztPQUdHO0lBQ0gsVUFBVSxFQUFFLFdBQVc7Q0FDMUIsQ0FBQztBQUtGOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGVBQWU7SUFheEI7Ozs7T0FJRztJQUNILFlBQXNDLFNBQW1CLEVBQTRCLE1BQXNCO1FBQXJFLGNBQVMsR0FBVCxTQUFTLENBQVU7UUFoQnpELHlCQUF5QjtRQUNqQixvQkFBZSxHQUFZLEtBQUssQ0FBQztRQUNqQyxpQkFBWSxHQUFXLFFBQVEsQ0FBQztRQUNoQyxnQkFBVyxHQUFXLFdBQVcsQ0FBQztRQUUxQzs7O1dBR0c7UUFDYSxXQUFNLEdBQTBCLElBQUksWUFBWSxDQUFVLElBQUksQ0FBQyxDQUFDO1FBUTVFLElBQUksQ0FBQyxZQUFZLENBQUMs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bUJBQUM7b0JBQ1IsVUFBVSxFQUFFLE1BQU07aUJBQ3JCOzswQkFzQmdCLE1BQU07MkJBQUMsUUFBUTs7MEJBQWdDLE1BQU07MkJBQUMsZ0JBQWdCIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgSW5qZWN0LCBJbmplY3RhYmxlLCBFdmVudEVtaXR0ZXIgfSBmcm9tICdAYW5ndWxhci9jb3JlJztcbmltcG9ydCB7IERPQ1VNRU5UIH0gZnJvbSAnQGFuZ3VsYXIvY29tbW9uJztcblxuLy8gLS0+IEludGVybmFsIGNvbnN0YW50c1xuY29uc3QgU1RPUkFHRV9LRVk6IHN0cmluZyA9IFwiZGFyay1tb2RlLWtleVwiO1xuY29uc3QgQ1NTX1BST1A6IHN0cmluZyA9IFwiZGFyay1tb2RlXCI7XG5jb25zdCBBRERfQUNUSU9OOiBzdHJpbmcgPSBcImFkZFwiO1xuY29uc3QgUkVNT1ZFX0FDVElPTjogc3RyaW5nID0gXCJyZW1vdmVcIjtcblxuLyoqXG4gKiBEZWZpbmVzIHByb3BlcnRpZXMgZm9yIHRoZSBEYXJrTW9kZVNlcnZpY2UgY29uZmlndXJhdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBEYXJrTW9kZUNvbmZpZyB7XG5cbiAgICAvKipcbiAgICAgKiBJbmRpY2F0ZXMgd2hldGhlciB0aGUgZGFyayBtb2RlIGlzIGFjdGl2YXRlZCBieSBkZWZhdWx0ICh0cnVlKSwgb3Igbm90IChmYWxzZSkuXG4gICAgICovXG4gICAgZGFya01vZGVFbmJsZWQ/OiBib29sZWFuO1xuICAgIFxuICAgIC8qKlxuICAgICAqIEluZGljYXRlcyB3aGV0aGVyIHRoZSBkYXJrIG1vZGUgdXNlcyBicm93c2VyIHNldHRpbmdzICh0cnVlKSwgb3Igbm90IChmYWxzZSkuXG4gICAgICogV2hlbiB0cnVlLCB0aGlzIHByb3BlcnR5IG92ZXJyaWRlcyB0aGUgZGFya01vZGVFbmJsZWQgcHJvcGVydHkuXG4gICAgICovXG4gICAgZGV0ZWN0QnJvd3NlclNldHRpbmdzPzogYm9vbGVhbjtcblxuICAgIC8qKlxuICAgICAqIENTUyBwcm9wZXJ0eSBuYW1lIHVzZWQgdG8gc2V0IHRoZSBkYXJrIG1vZGUgbG9vayBhbmQgZmVlbC5cbiAgICAgKi9cbiAgICBjc3NQcm9wZXJ0eT86IHN0cmluZztcblxuICAgIC8qKlxuICAgICAqIFJlZmVyZW5jZSB0byB0aGUga2V5IHZhbHVlIHVzZWQgdG8gcGVyc2lzdCB0aGUgZGFyayBtb2RlIHN0YXRlIHRvIGxvY2FsIHN0b3JhZ2UuXG4gICAgICovXG4gICAgc3RvcmFnZUtleT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBUaGUgZGVmYXVsdCBwcm92aWRlciBmb3IgdGhlIERhcmtNb2RlU2VydmljZSBjb25maWd1cmF0aW9uLiBZb3UgdHlwaWNhbGx5IGRlZmluZVxuICogdGhlIGN1c3RvbSBwcm9wZXJ0aWVzIGluIHRoZSBtYWluIE5nTW9kdWxlIGRlY2xhcmF0aW9uIHRvIGluaXRpYWxpemUgdGhlIGFwcCBkYXJrIG1vZGU6XG4gKiBcbiAqIEBOZ01vZHVsZSh7XG4gKiAuLi5cbiAqIHByb3ZpZGVyczogW1xuICogICB7IHByb3ZpZGU6IERBUktfTU9ERV9DT05GSUcsIHVzZVZhbHVlOiB7IGVuYWJsZURhcmtNb2RlOiB0cnVlfSB9XG4gKiBdLFxuICogLi4uXG4gKiBzKTtcbiAqL1xuZXhwb3J0IGNvbnN0IERBUktfTU9ERV9DT05GSUc6IERhcmtNb2RlQ29uZmlnID0ge1xuICAgIFxuICAgIC8qKlxuICAgICAqIEluZGljYXRlcyB3aGV0aGVyIHRoZSBkYXJrIG1vZGUgdXNlcyBicm93c2VyIHNldHRpbmdzICh0cnVlKSwgb3Igbm90IChmYWxzZSkuXG4gICAgICogRGVmYXVsdCB2YWx1ZSBpcyBmYWxzZS5cbiAgICAgKi9cbiAgICBkYXJrTW9kZUVuYmxlZDogZmFsc2UsXG4gICAgXG4gICAgLyoqXG4gICAgICogSW5kaWNhdGVzIHdoZXRoZXIgdGhlIGRhcmsgbW9kZSB1c2VzIGJyb3dzZXIgc2V0dGluZ3MgKHRydWUpLCBvciBub3QgKGZhbHNlKS5cbiAgICAgKiBEZWZhdWx0IHZhbHVlIGlzIGZhbHNlLlxuICAgICAqL1xuICAgIGRldGVjdEJyb3dzZXJTZXR0aW5nczogZmFsc2UsXG4gICAgXG4gICAgLyoqXG4gICAgICogQ1NTIHByb3BlcnR5IG5hbWUgdXNlZCB0byBzZXQgdGhlIGRhcmsgbW9kZSBsb29rIGFuZCBmZWVsLlxuICAgICAqIERlZmF1bHQgdmFsdWUgaXMgJ2RhcmstbW9kZScuXG4gICAgICovXG4gICAgY3NzUHJvcGVydHk6IENTU19QUk9QLFxuICAgIFxuICAgIC8qKlxuICAgICAqIFJlZmVyZW5jZSB0byB0aGUga2V5IHZhbHVlIHVzZWQgdG8gcGVyc2lzdCB0aGUgZGFyayBtb2RlIHN0YXRlIHRvIGxvY2FsIHN0b3JhZ2UuXG4gICAgICogRGVmYXVsdCB2YWx1ZSBpcyAnZGFyay1tb2RlLWtleScuXG4gICAgICovXG4gICAgc3RvcmFnZUtleTogU1RPUkFHRV9LRVlcbn07XG5cbkBJbmplY3RhYmxlKHtcbiAgICBwcm92aWRlZEluOiAncm9vdCdcbn0pXG4vKipcbiAqIEEgbGlnaHR3ZWlnaHQgc2VydmljZSB0aGF0IHByb3ZpZGVzIERhcmsgTW9kZSBpbXBsZW1lbnRhdGlvbiBmb3IgeW91ciBBbmd1bGFyIGFwcGxpY2F0aW9uLlxuICovXG5leHBvcnQgY2xhc3MgRGFya01vZGVTZXJ2aWNlIHtcblxuICAgIC8vIC0tPiBQcml2YXRlIHByb3BlcnRpZXNcbiAgICBwcml2YXRlIF9kYXJrTW9kZUVuYmxlZDogYm9vbGVhbiA9IGZhbHNlO1xuICAgIHByaXZhdGUgX2Nzc1Byb3BlcnR5OiBzdHJpbmcgPSBDU1NfUFJPUDtcbiAgICBwcml2YXRlIF9zdG9yYWdlS2V5OiBzdHJpbmcgPSBTVE9SQUdFX0tFWTtcblxuICAgIC8qKlxuICAgICAqIFRoZSBjYWxsYmFjayBmdW5jdGlvbiB0aGF0IGlzIHRyaWdnZXJlZCB3aGVuIHRoZSBkYXJrIG1vZGUgY2hhbmdlcy5cbiAgICAgKiBAdHlwZVBhcmFtIEV2ZW50RW1pdHRlcjxib29sZWFuPiB0aGUgdmFsdWUgcmV0dXJuZWQgYnkgdGhlIGRhcmtNb2RlRW5hYmxlZCgpIHByb3BlcnR5LlxuICAgICAqL1xuICAgIHB1YmxpYyByZWFkb25seSBjaGFuZ2U6IEV2ZW50RW1pdHRlcjxib29sZWFuPiA9IG5ldyBFdmVudEVtaXR0ZXI8Ym9vbGVhbj4odHJ1ZSk7XG5cbiAgICAvKipcbiAgICAgKiBDcmVhdGVzIGEgbmV3IERhcmtNb2RlU2VydmljZSBpbnN0YW5jZS5cbiAgICAgKiBAcGFyYW0gX2RvY3VtZW50IHRoZSByZWZlcmVuY2UgdG8gdGhlIERvY3VtZW50IHNpbmdsZXRvbi5cbiAgICAgKiBAcGFyYW0gY29uZmlnIHRoZSByZWZlcmVuY2UgdG8gdGhlIERhcmtNb2RlQ29uZmlnIHByb3ZpZGVyLlxuICAgICAqL1xuICAgIGNvbnN0cnVjdG9yKEBJbmplY3QoRE9DVU1FTlQpIHByaXZhdGUgX2RvY3VtZW50OiBEb2N1bWVudCwgQEluamVjdChEQVJLX01PREVfQ09ORklHKSBjb25maWc6IERhcmtNb2RlQ29uZmlnKSB7XG4gICAgICAgIHRoaXMuaW5pdERhcmtNb2RlKGNvbmZpZyk7XG4gICAgfVxuXG4gICAgLyoqXG4gICAgICogVG9vZ2xlcyB0aGUgZGFyayBtb2RlIHN0YXRlLlxuICAgICAqL1xuICAgIHB1YmxpYyB0b2dnbGVEYXJrTW9kZSgpOiB2b2lkIHtcbiAgICAgICAgdGhpcy5fZGFya01vZGVFbmJsZWQgPyB0aGlzLmRpc2FibGVEYXJrTW9kZSgpIDogdGhpcy5lbmFibGVEYXJrTW9kZSgpO1xuICAgIH1cblxuICAgIC8qKlxuICAgICAqIFNldHMgdGhlIGRhcmsgbW9kZSBzdGF0ZSB0byBhY3RpdmUuXG4gICAgICovXG4gICAgcHVibGljIGVuYWJsZURhcmtNb2RlKCk6IHZvaWQge1xuICAgICAgICB0aGlzLnNldERhcmtNb2RlKEFERF9BQ1RJT04pO1xuICAgICAgICB0aGlzLnNldFN0b3JlZERhcmtNb2RlKCk7XG4gICAgfVxuXG4gICAgLyoqXG4gICAgICogU2V0cyB0aGUgZGFyayBtb2RlIHN0YXRlIHRvIGluYWN0aXZlLlxuICAgICAqL1xuICAgIHB1YmxpYyBkaXNhYmxlRGFya01vZGUoKTogdm9pZCB7XG4gICAgICAgIHRoaXMuc2V0RGFya01vZGUoUkVNT1ZFX0FDVElPTik7XG4gICAgICAgIHRoaXMuc2V0U3RvcmVkRGFya01vZGUoKTtcbiAgICB9XG5cbiAgICAvKipcbiAgICAgKiBSZXR1cm5zIGEgYm9vbGVhbiB2YWx1ZSB0aGF0IGluZGljYXRlcyB0aGUgZGFyayBtb2RlIHN0YXRlIGlzIGFjdGl2ZSAodHJ1ZSksIG9yIG5vdCAoZmFsc2UpLlxuICAgICAqIEByZXR1cm5zIHRydWUgd2hldGhlciB0aGUgZGFyayBtb2RlIHN0YXRlIGlzIGFjdGl2ZTsgZmFsc2Ugb3RoZXJ3aXNlLlxuICAgICAqL1xuICAgIHB1YmxpYyBkYXJrTW9kZUVuYWJsZWQoKTogYm9vbGVhbiB7XG4gICAgICAgIHJldHVybiB0aGlzLl9kYXJrTW9kZUVuYmxlZDtcbiAgICB9XG5cbiAgICAvKipcbiAgICAgKiBSZW1vdmVzIHRoZSBkYXJrIG1vZGUgaW5mb3JtYXRpb24gZnJvbSBsb2NhbCBzdG9yYWdlLlxuICAgICAqL1xuICAgIHB1YmxpYyBpbnZhbGlkYXRlU3RvcmFnZSgpOiB2b2lkIHtcbiAgICAgICAgbG9jYWxTdG9yYWdlLnJlbW92ZUl0ZW0odGhpcy5fc3RvcmFnZUtleSk7XG4gICAgfVxuXG4gICAgLy8gLS0+IFByaXZhdGUgbWV0aG9kc1xuICAgIHByaXZhdGUgaW5pdERhcmtNb2RlKGNvbmZpZzogRGFya01vZGVDb25maWcpOiB2b2lkIHtcbiAgICAgICAgdGhpcy5fZGFya01vZGVFbmJsZWQgPSBjb25maWcuZGFya01vZGVFbmJsZWQgfHwgZmFsc2U7XG4gICAgICAgIHRoaXMuX2Nzc1Byb3BlcnR5ID0gY29uZmlnLmNzc1Byb3BlcnR5IHx8IENTU19QUk9QO1xuICAgICAgICB0aGlzLl9zdG9yYWdlS2V5ID0gY29uZmlnLnN0b3JhZ2VLZXkgfHwgU1RPUkFHRV9LRVk7XG4gICAgICAgIGlmICh0aGlzLl9kYXJrTW9kZUVuYmxlZCkge1xuICAgICAgICAgICAgdGhpcy5lbmFibGVEYXJrTW9kZSgpO1xuICAgICAgICB9IGVsc2Uge1xuICAgICAgICAgICAgdGhpcy5pbml0U3RvcmVkRGFya01vZGUoKTtcbiAgICAgICAgfVxuICAgICAgICBpZiAoY29uZmlnLmRldGVjdEJyb3dzZXJTZXR0aW5ncykgdGhpcy5pbml0QnJvd3Nlck1vZGUoKTtcbiAgICB9XG4gICAgXG4gICAgcHJpdmF0ZSBpbml0U3RvcmVkRGFya01vZGUoKTogdm9pZCB7XG4gICAgICAgIGNvbnN0IHJlc3VsdDogc3RyaW5nIHwgbnVsbCA9IGxvY2FsU3RvcmFnZS5nZXRJdGVtKHRoaXMuX3N0b3JhZ2VLZXkpO1xuICAgICAgICBpZiAocmVzdWx0ID09PSBcInRydWVcIikgdGhpcy5lbmFibGVEYXJrTW9kZSgpO1xuICAgIH1cblxuICAgIHByaXZhdGUgc2V0U3RvcmVkRGFya01vZGUoKTogdm9pZCB7XG4gICAgICAgIGNvbnN0IGRhdGE6IHN0cmluZyA9IFN0cmluZyh0aGlzLl9kYXJrTW9kZUVuYmxlZCk7XG4gICAgICAgIGxvY2FsU3RvcmFnZS5zZXRJdGVtKHRoaXMuX3N0b3JhZ2VLZXksIGRhdGEpO1xuICAgIH1cblxuICAgIHByaXZhdGUgc2V0RGFya01vZGUoYWN0aW9uOiBzdHJpbmcpOiB2b2lkIHtcbiAgICAgICAgY29uc3QgY2xhc3NMaXN0OiBET01Ub2tlbkxpc3QgPSB0aGlzLl9kb2N1bWVudC5ib2R5LmNsYXNzTGlzdDtcbiAgICAgICAgaWYgKGFjdGlvbiA9PT0gQUREX0FDVElPTikge1xuICAgICAgICAgICAgY2xhc3NMaXN0LmFkZCh0aGlzLl9jc3NQcm9wZXJ0eSk7XG4gICAgICAgICAgICB0aGlzLl9kYXJrTW9kZUVuYmxlZCA9IHRydWU7XG4gICAgICAgIH0gZWxzZSBpZiAoYWN0aW9uID09PSBSRU1PVkVfQUNUSU9OKSB7XG4gICAgICAgICAgICBjbGFzc0xpc3QucmVtb3ZlKHRoaXMuX2Nzc1Byb3BlcnR5KTtcbiAgICAgICAgICAgIHRoaXMuX2RhcmtNb2RlRW5ibGVkID0gZmFsc2U7XG4gICAgICAgIH1cbiAgICAgICAgdGhpcy5jaGFuZ2UuZW1pdCh0aGlzLl9kYXJrTW9kZUVuYmxlZCk7XG4gICAgfVxuXG4gICAgcHJpdmF0ZSBpbml0QnJvd3Nlck1vZGUoKTogdm9pZCB7XG4gICAgICAgIGlmICh3aW5kb3cubWF0Y2hNZWRpYSAmJiB3aW5kb3cubWF0Y2hNZWRpYSgnKHByZWZlcnMtY29sb3Itc2NoZW1lOiBkYXJrKScpLm1hdGNoZXMpIHtcbiAgICAgICAgICAgIHRoaXMuZW5hYmxlRGFya01vZGUoKTtcbiAgICAgICAgfVxuICAgIH1cbn1cblxuIl19

package/fesm2015/angular-toolbox.mjs

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
-import { Pipe, NgModule, Injectable } from '@angular/core';
+import { Pipe, EventEmitter, Injectable, Inject, NgModule } from '@angular/core';
 import * as i1 from '@angular/platform-browser';
+import { DOCUMENT } from '@angular/common';
 
 class SafeHtmlPipe {
     constructor(_sanitizer) {
@@ -17,17 +18,174 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImpor
             args: [{ name: 'safeHtml' }]
         }], ctorParameters: function () { return [{ type: i1.DomSanitizer }]; } });
 
+// --> Internal constants
+const STORAGE_KEY = "dark-mode-key";
+const CSS_PROP = "dark-mode";
+const ADD_ACTION = "add";
+const REMOVE_ACTION = "remove";
+/**
+ * The default provider for the DarkModeService configuration. You typically define
+ * the custom properties in the main NgModule declaration to initialize the app dark mode:
+ *
+ * @NgModule({
+ * ...
+ * providers: [
+ *   { provide: DARK_MODE_CONFIG, useValue: { enableDarkMode: true} }
+ * ],
+ * ...
+ * s);
+ */
+const DARK_MODE_CONFIG = {
+    /**
+     * Indicates whether the dark mode uses browser settings (true), or not (false).
+     * Default value is false.
+     */
+    darkModeEnbled: false,
+    /**
+     * Indicates whether the dark mode uses browser settings (true), or not (false).
+     * Default value is false.
+     */
+    detectBrowserSettings: false,
+    /**
+     * CSS property name used to set the dark mode look and feel.
+     * Default value is 'dark-mode'.
+     */
+    cssProperty: CSS_PROP,
+    /**
+     * Reference to the key value used to persist the dark mode state to local storage.
+     * Default value is 'dark-mode-key'.
+     */
+    storageKey: STORAGE_KEY
+};
+/**
+ * A lightweight service that provides Dark Mode implementation for your Angular application.
+ */
+class DarkModeService {
+    /**
+     * Creates a new DarkModeService instance.
+     * @param _document the reference to the Document singleton.
+     * @param config the reference to the DarkModeConfig provider.
+     */
+    constructor(_document, config) {
+        this._document = _document;
+        // --> Private properties
+        this._darkModeEnbled = false;
+        this._cssProperty = CSS_PROP;
+        this._storageKey = STORAGE_KEY;
+        /**
+         * The callback function that is triggered when the dark mode changes.
+         * @typeParam EventEmitter<boolean> the value returned by the darkModeEnabled() property.
+         */
+        this.change = new EventEmitter(true);
+        this.initDarkMode(config);
+    }
+    /**
+     * Toogles the dark mode state.
+     */
+    toggleDarkMode() {
+        this._darkModeEnbled ? this.disableDarkMode() : this.enableDarkMode();
+    }
+    /**
+     * Sets the dark mode state to active.
+     */
+    enableDarkMode() {
+        this.setDarkMode(ADD_ACTION);
+        this.setStoredDarkMode();
+    }
+    /**
+     * Sets the dark mode state to inactive.
+     */
+    disableDarkMode() {
+        this.setDarkMode(REMOVE_ACTION);
+        this.setStoredDarkMode();
+    }
+    /**
+     * Returns a boolean value that indicates the dark mode state is active (true), or not (false).
+     * @returns true whether the dark mode state is active; false otherwise.
+     */
+    darkModeEnabled() {
+        return this._darkModeEnbled;
+    }
+    /**
+     * Removes the dark mode information from local storage.
+     */
+    invalidateStorage() {
+        localStorage.removeItem(this._storageKey);
+    }
+    // --> Private methods
+    initDarkMode(config) {
+        this._darkModeEnbled = config.darkModeEnbled || false;
+        this._cssProperty = config.cssProperty || CSS_PROP;
+        this._storageKey = config.storageKey || STORAGE_KEY;
+        if (this._darkModeEnbled) {
+            this.enableDarkMode();
+        }
+        else {
+            this.initStoredDarkMode();
+        }
+        if (config.detectBrowserSettings)
+            this.initBrowserMode();
+    }
+    initStoredDarkMode() {
+        const result = localStorage.getItem(this._storageKey);
+        if (result === "true")
+            this.enableDarkMode();
+    }
+    setStoredDarkMode() {
+        const data = String(this._darkModeEnbled);
+        localStorage.setItem(this._storageKey, data);
+    }
+    setDarkMode(action) {
+        const classList = this._document.body.classList;
+        if (action === ADD_ACTION) {
+            classList.add(this._cssProperty);
+            this._darkModeEnbled = true;
+        }
+        else if (action === REMOVE_ACTION) {
+            classList.remove(this._cssProperty);
+            this._darkModeEnbled = false;
+        }
+        this.change.emit(this._darkModeEnbled);
+    }
+    initBrowserMode() {
+        if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {
+            this.enableDarkMode();
+        }
+    }
+}
+DarkModeService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, deps: [{ token: DOCUMENT }, { token: DARK_MODE_CONFIG }], target: i0.ɵɵFactoryTarget.Injectable });
+DarkModeService.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, providedIn: 'root' });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: function () {
+        return [{ type: Document, decorators: [{
+                        type: Inject,
+                        args: [DOCUMENT]
+                    }] }, { type: undefined, decorators: [{
+                        type: Inject,
+                        args: [DARK_MODE_CONFIG]
+                    }] }];
+    } });
+
 class AngularToolboxModule {
 }
 AngularToolboxModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
 AngularToolboxModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, declarations: [SafeHtmlPipe], exports: [SafeHtmlPipe] });
-AngularToolboxModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule });
+AngularToolboxModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, providers: [
+        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }
+    ] });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, decorators: [{
             type: NgModule,
             args: [{
                     declarations: [
                         SafeHtmlPipe
                     ],
+                    providers: [
+                        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }
+                    ],
                     exports: [
                         SafeHtmlPipe
                     ]
@@ -102,5 +260,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AngularToolboxModule, SafeHtmlPipe, SubscriptionService };
+export { AngularToolboxModule, DARK_MODE_CONFIG, DarkModeService, SafeHtmlPipe, SubscriptionService };
 //# sourceMappingURL=angular-toolbox.mjs.map

package/fesm2015/angular-toolbox.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"angular-toolbox.mjs","sources":["../../../projects/angular-toolbox/src/lib/pipe/safe/safe-html.pipe.ts","../../../projects/angular-toolbox/src/lib/angular-toolbox.module.ts","../../../projects/angular-toolbox/src/lib/service/subscription/subscription.service.ts","../../../projects/angular-toolbox/src/public-api.ts","../../../projects/angular-toolbox/src/angular-toolbox.ts"],"sourcesContent":["import { DomSanitizer, SafeHtml } from '@angular/platform-browser'\r\nimport { PipeTransform, Pipe } from \"@angular/core\";\r\n\r\n@Pipe({ name: 'safeHtml'})\r\nexport class SafeHtmlPipe implements PipeTransform  {\r\n\r\n  constructor(private _sanitizer: DomSanitizer) {}\r\n\r\n  public transform(value: string): SafeHtml {\r\n    return this._sanitizer.bypassSecurityTrustHtml(value);\r\n  }\r\n}","import { NgModule } from '@angular/core';\r\nimport { SafeHtmlPipe } from './pipe/safe/safe-html.pipe';\r\n\r\n@NgModule({\r\n    declarations: [\r\n        SafeHtmlPipe\r\n    ],\r\n    exports: [\r\n        SafeHtmlPipe\r\n    ]\r\n})\r\nexport class AngularToolboxModule { }","import { Injectable } from '@angular/core';\nimport { Subscription } from 'rxjs';\n\n@Injectable({\n    providedIn: 'root'\n})\n/**\n * A lightweight service that helps to manage unregistration issues of Angular subscriptions.\n */\nexport class SubscriptionService {\n\n    /**\n     * The internal Subscription instances storage.\n     */\n    private _subMap: Map<String, Array<Subscription>> = new Map<String, Array<Subscription>>();\n\n    /**\n     * Stores a new Subscription instance associated with the specified reference.\n     * \n     * @param ref the reference for which to store a new Subscription instance.\n     * @param subscription the Subscription instance to register.\n     * @returns a reference to this SubscriptionService instance.\n     */\n    public register(ref: String, subscription: Subscription): SubscriptionService {\n        if (!this._subMap.has(ref)) this._subMap.set(ref, []);\n        this._subMap.get(ref)?.push(subscription);\n        return this;\n    }\n \n    /**\n     * Unsubscribes and removes all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove all Subscription instances.\n     * @returns true whether the specified reference exists; false otherwise.\n     */\n    public clearAll(ref: String): boolean {\n        let result: boolean = false;\n        if (this._subMap.has(ref)) {\n            this._subMap.get(ref)?.forEach(subscription => subscription.unsubscribe());\n            this._subMap.delete(ref);\n            result = true;\n        }\n        return result;\n    }\n\n    /**\n     * Returns all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove get Subscription instances.\n     * @returns all Subscription instances associated with the specified reference, or whether\n     *          the specified reference does not exists.\n     */\n    public get(ref: String): Array<Subscription> | null {\n        return this._subMap.get(ref) || null;\n    }\n}\n","/*\n * Public API Surface of angular-toolbox\n */\n\nexport * from './lib/angular-toolbox.module';\nexport * from './lib/pipe';\nexport * from './lib/service';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;MAIa,YAAY,CAAA;AAEvB,IAAA,WAAA,CAAoB,UAAwB,EAAA;AAAxB,QAAA,IAAU,CAAA,UAAA,GAAV,UAAU,CAAc;KAAI;AAEzC,IAAA,SAAS,CAAC,KAAa,EAAA;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;KACvD;;yGANU,YAAY,EAAA,IAAA,EAAA,CAAA,EAAA,KAAA,EAAA,EAAA,CAAA,YAAA,EAAA,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,IAAA,EAAA,CAAA,CAAA;uGAAZ,YAAY,EAAA,IAAA,EAAA,UAAA,EAAA,CAAA,CAAA;2FAAZ,YAAY,EAAA,UAAA,EAAA,CAAA;kBADxB,IAAI;mBAAC,EAAE,IAAI,EAAE,UAAU,EAAC,CAAA;;;MCQZ,oBAAoB,CAAA;;iHAApB,oBAAoB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,QAAA,EAAA,CAAA,CAAA;kHAApB,oBAAoB,EAAA,YAAA,EAAA,CANzB,YAAY,CAAA,EAAA,OAAA,EAAA,CAGZ,YAAY,CAAA,EAAA,CAAA,CAAA;kHAGP,oBAAoB,EAAA,CAAA,CAAA;2FAApB,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBARhC,QAAQ;AAAC,YAAA,IAAA,EAAA,CAAA;AACN,oBAAA,YAAY,EAAE;wBACV,YAAY;AACf,qBAAA;AACD,oBAAA,OAAO,EAAE;wBACL,YAAY;AACf,qBAAA;iBACJ,CAAA;;;ACJD;;AAEG;MACU,mBAAmB,CAAA;AANhC,IAAA,WAAA,GAAA;AAQI;;AAEG;AACK,QAAA,IAAA,CAAA,OAAO,GAAqC,IAAI,GAAG,EAA+B,CAAC;KAyC9F;AAvCG;;;;;;AAMG;IACI,QAAQ,CAAC,GAAW,EAAE,YAA0B,EAAA;;QACnD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACtD,QAAA,CAAA,EAAA,GAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAE,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,IAAI,CAAC,YAAY,CAAC,CAAC;AAC1C,QAAA,OAAO,IAAI,CAAC;KACf;AAED;;;;;AAKG;AACI,IAAA,QAAQ,CAAC,GAAW,EAAA;;QACvB,IAAI,MAAM,GAAY,KAAK,CAAC;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACvB,CAAA,EAAA,GAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAE,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,OAAO,CAAC,YAAY,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3E,YAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,MAAM,GAAG,IAAI,CAAC;AACjB,SAAA;AACD,QAAA,OAAO,MAAM,CAAC;KACjB;AAED;;;;;;AAMG;AACI,IAAA,GAAG,CAAC,GAAW,EAAA;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;KACxC;;gHA7CQ,mBAAmB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAnB,mBAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,mBAAmB,cALhB,MAAM,EAAA,CAAA,CAAA;2FAKT,mBAAmB,EAAA,UAAA,EAAA,CAAA;kBAN/B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACR,oBAAA,UAAU,EAAE,MAAM;iBACrB,CAAA;;;ACLD;;AAEG;;ACFH;;AAEG;;;;"}
+{"version":3,"file":"angular-toolbox.mjs","sources":["../../../projects/angular-toolbox/src/lib/pipe/safe/safe-html.pipe.ts","../../../projects/angular-toolbox/src/lib/service/ui/dark-mode.service.ts","../../../projects/angular-toolbox/src/lib/angular-toolbox.module.ts","../../../projects/angular-toolbox/src/lib/service/subscription/subscription.service.ts","../../../projects/angular-toolbox/src/public-api.ts","../../../projects/angular-toolbox/src/angular-toolbox.ts"],"sourcesContent":["import { DomSanitizer, SafeHtml } from '@angular/platform-browser'\r\nimport { PipeTransform, Pipe } from \"@angular/core\";\r\n\r\n@Pipe({ name: 'safeHtml'})\r\nexport class SafeHtmlPipe implements PipeTransform  {\r\n\r\n  constructor(private _sanitizer: DomSanitizer) {}\r\n\r\n  public transform(value: string): SafeHtml {\r\n    return this._sanitizer.bypassSecurityTrustHtml(value);\r\n  }\r\n}","import { Inject, Injectable, EventEmitter } from '@angular/core';\nimport { DOCUMENT } from '@angular/common';\n\n// --> Internal constants\nconst STORAGE_KEY: string = \"dark-mode-key\";\nconst CSS_PROP: string = \"dark-mode\";\nconst ADD_ACTION: string = \"add\";\nconst REMOVE_ACTION: string = \"remove\";\n\n/**\n * Defines properties for the DarkModeService configuration.\n */\nexport interface DarkModeConfig {\n\n    /**\n     * Indicates whether the dark mode is activated by default (true), or not (false).\n     */\n    darkModeEnbled?: boolean;\n    \n    /**\n     * Indicates whether the dark mode uses browser settings (true), or not (false).\n     * When true, this property overrides the darkModeEnbled property.\n     */\n    detectBrowserSettings?: boolean;\n\n    /**\n     * CSS property name used to set the dark mode look and feel.\n     */\n    cssProperty?: string;\n\n    /**\n     * Reference to the key value used to persist the dark mode state to local storage.\n     */\n    storageKey?: string;\n}\n\n/**\n * The default provider for the DarkModeService configuration. You typically define\n * the custom properties in the main NgModule declaration to initialize the app dark mode:\n * \n * @NgModule({\n * ...\n * providers: [\n *   { provide: DARK_MODE_CONFIG, useValue: { enableDarkMode: true} }\n * ],\n * ...\n * s);\n */\nexport const DARK_MODE_CONFIG: DarkModeConfig = {\n    \n    /**\n     * Indicates whether the dark mode uses browser settings (true), or not (false).\n     * Default value is false.\n     */\n    darkModeEnbled: false,\n    \n    /**\n     * Indicates whether the dark mode uses browser settings (true), or not (false).\n     * Default value is false.\n     */\n    detectBrowserSettings: false,\n    \n    /**\n     * CSS property name used to set the dark mode look and feel.\n     * Default value is 'dark-mode'.\n     */\n    cssProperty: CSS_PROP,\n    \n    /**\n     * Reference to the key value used to persist the dark mode state to local storage.\n     * Default value is 'dark-mode-key'.\n     */\n    storageKey: STORAGE_KEY\n};\n\n@Injectable({\n    providedIn: 'root'\n})\n/**\n * A lightweight service that provides Dark Mode implementation for your Angular application.\n */\nexport class DarkModeService {\n\n    // --> Private properties\n    private _darkModeEnbled: boolean = false;\n    private _cssProperty: string = CSS_PROP;\n    private _storageKey: string = STORAGE_KEY;\n\n    /**\n     * The callback function that is triggered when the dark mode changes.\n     * @typeParam EventEmitter<boolean> the value returned by the darkModeEnabled() property.\n     */\n    public readonly change: EventEmitter<boolean> = new EventEmitter<boolean>(true);\n\n    /**\n     * Creates a new DarkModeService instance.\n     * @param _document the reference to the Document singleton.\n     * @param config the reference to the DarkModeConfig provider.\n     */\n    constructor(@Inject(DOCUMENT) private _document: Document, @Inject(DARK_MODE_CONFIG) config: DarkModeConfig) {\n        this.initDarkMode(config);\n    }\n\n    /**\n     * Toogles the dark mode state.\n     */\n    public toggleDarkMode(): void {\n        this._darkModeEnbled ? this.disableDarkMode() : this.enableDarkMode();\n    }\n\n    /**\n     * Sets the dark mode state to active.\n     */\n    public enableDarkMode(): void {\n        this.setDarkMode(ADD_ACTION);\n        this.setStoredDarkMode();\n    }\n\n    /**\n     * Sets the dark mode state to inactive.\n     */\n    public disableDarkMode(): void {\n        this.setDarkMode(REMOVE_ACTION);\n        this.setStoredDarkMode();\n    }\n\n    /**\n     * Returns a boolean value that indicates the dark mode state is active (true), or not (false).\n     * @returns true whether the dark mode state is active; false otherwise.\n     */\n    public darkModeEnabled(): boolean {\n        return this._darkModeEnbled;\n    }\n\n    /**\n     * Removes the dark mode information from local storage.\n     */\n    public invalidateStorage(): void {\n        localStorage.removeItem(this._storageKey);\n    }\n\n    // --> Private methods\n    private initDarkMode(config: DarkModeConfig): void {\n        this._darkModeEnbled = config.darkModeEnbled || false;\n        this._cssProperty = config.cssProperty || CSS_PROP;\n        this._storageKey = config.storageKey || STORAGE_KEY;\n        if (this._darkModeEnbled) {\n            this.enableDarkMode();\n        } else {\n            this.initStoredDarkMode();\n        }\n        if (config.detectBrowserSettings) this.initBrowserMode();\n    }\n    \n    private initStoredDarkMode(): void {\n        const result: string | null = localStorage.getItem(this._storageKey);\n        if (result === \"true\") this.enableDarkMode();\n    }\n\n    private setStoredDarkMode(): void {\n        const data: string = String(this._darkModeEnbled);\n        localStorage.setItem(this._storageKey, data);\n    }\n\n    private setDarkMode(action: string): void {\n        const classList: DOMTokenList = this._document.body.classList;\n        if (action === ADD_ACTION) {\n            classList.add(this._cssProperty);\n            this._darkModeEnbled = true;\n        } else if (action === REMOVE_ACTION) {\n            classList.remove(this._cssProperty);\n            this._darkModeEnbled = false;\n        }\n        this.change.emit(this._darkModeEnbled);\n    }\n\n    private initBrowserMode(): void {\n        if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {\n            this.enableDarkMode();\n        }\n    }\n}\n\n","import { NgModule } from '@angular/core';\r\nimport { SafeHtmlPipe } from './pipe/safe/safe-html.pipe';\r\nimport { DARK_MODE_CONFIG } from './service/ui/dark-mode.service';\r\n\r\n@NgModule({\r\n    declarations: [\r\n        SafeHtmlPipe\r\n    ],\r\n    providers: [\r\n        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }\r\n      ],\r\n    exports: [\r\n        SafeHtmlPipe\r\n    ]\r\n})\r\nexport class AngularToolboxModule { }","import { Injectable } from '@angular/core';\nimport { Subscription } from 'rxjs';\n\n@Injectable({\n    providedIn: 'root'\n})\n/**\n * A lightweight service that helps to manage unregistration issues of Angular subscriptions.\n */\nexport class SubscriptionService {\n\n    /**\n     * The internal Subscription instances storage.\n     */\n    private _subMap: Map<String, Array<Subscription>> = new Map<String, Array<Subscription>>();\n\n    /**\n     * Stores a new Subscription instance associated with the specified reference.\n     * \n     * @param ref the reference for which to store a new Subscription instance.\n     * @param subscription the Subscription instance to register.\n     * @returns a reference to this SubscriptionService instance.\n     */\n    public register(ref: String, subscription: Subscription): SubscriptionService {\n        if (!this._subMap.has(ref)) this._subMap.set(ref, []);\n        this._subMap.get(ref)?.push(subscription);\n        return this;\n    }\n \n    /**\n     * Unsubscribes and removes all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove all Subscription instances.\n     * @returns true whether the specified reference exists; false otherwise.\n     */\n    public clearAll(ref: String): boolean {\n        let result: boolean = false;\n        if (this._subMap.has(ref)) {\n            this._subMap.get(ref)?.forEach(subscription => subscription.unsubscribe());\n            this._subMap.delete(ref);\n            result = true;\n        }\n        return result;\n    }\n\n    /**\n     * Returns all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove get Subscription instances.\n     * @returns all Subscription instances associated with the specified reference, or whether\n     *          the specified reference does not exists.\n     */\n    public get(ref: String): Array<Subscription> | null {\n        return this._subMap.get(ref) || null;\n    }\n}\n","/*\n * Public API Surface of angular-toolbox\n */\n\nexport * from './lib/angular-toolbox.module';\nexport * from './lib/pipe';\nexport * from './lib/service';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2020/angular-toolbox.mjs

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
-import { Pipe, NgModule, Injectable } from '@angular/core';
+import { Pipe, EventEmitter, Injectable, Inject, NgModule } from '@angular/core';
 import * as i1 from '@angular/platform-browser';
+import { DOCUMENT } from '@angular/common';
 
 class SafeHtmlPipe {
     constructor(_sanitizer) {
@@ -17,17 +18,172 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImpor
             args: [{ name: 'safeHtml' }]
         }], ctorParameters: function () { return [{ type: i1.DomSanitizer }]; } });
 
+// --> Internal constants
+const STORAGE_KEY = "dark-mode-key";
+const CSS_PROP = "dark-mode";
+const ADD_ACTION = "add";
+const REMOVE_ACTION = "remove";
+/**
+ * The default provider for the DarkModeService configuration. You typically define
+ * the custom properties in the main NgModule declaration to initialize the app dark mode:
+ *
+ * @NgModule({
+ * ...
+ * providers: [
+ *   { provide: DARK_MODE_CONFIG, useValue: { enableDarkMode: true} }
+ * ],
+ * ...
+ * s);
+ */
+const DARK_MODE_CONFIG = {
+    /**
+     * Indicates whether the dark mode uses browser settings (true), or not (false).
+     * Default value is false.
+     */
+    darkModeEnbled: false,
+    /**
+     * Indicates whether the dark mode uses browser settings (true), or not (false).
+     * Default value is false.
+     */
+    detectBrowserSettings: false,
+    /**
+     * CSS property name used to set the dark mode look and feel.
+     * Default value is 'dark-mode'.
+     */
+    cssProperty: CSS_PROP,
+    /**
+     * Reference to the key value used to persist the dark mode state to local storage.
+     * Default value is 'dark-mode-key'.
+     */
+    storageKey: STORAGE_KEY
+};
+/**
+ * A lightweight service that provides Dark Mode implementation for your Angular application.
+ */
+class DarkModeService {
+    /**
+     * Creates a new DarkModeService instance.
+     * @param _document the reference to the Document singleton.
+     * @param config the reference to the DarkModeConfig provider.
+     */
+    constructor(_document, config) {
+        this._document = _document;
+        // --> Private properties
+        this._darkModeEnbled = false;
+        this._cssProperty = CSS_PROP;
+        this._storageKey = STORAGE_KEY;
+        /**
+         * The callback function that is triggered when the dark mode changes.
+         * @typeParam EventEmitter<boolean> the value returned by the darkModeEnabled() property.
+         */
+        this.change = new EventEmitter(true);
+        this.initDarkMode(config);
+    }
+    /**
+     * Toogles the dark mode state.
+     */
+    toggleDarkMode() {
+        this._darkModeEnbled ? this.disableDarkMode() : this.enableDarkMode();
+    }
+    /**
+     * Sets the dark mode state to active.
+     */
+    enableDarkMode() {
+        this.setDarkMode(ADD_ACTION);
+        this.setStoredDarkMode();
+    }
+    /**
+     * Sets the dark mode state to inactive.
+     */
+    disableDarkMode() {
+        this.setDarkMode(REMOVE_ACTION);
+        this.setStoredDarkMode();
+    }
+    /**
+     * Returns a boolean value that indicates the dark mode state is active (true), or not (false).
+     * @returns true whether the dark mode state is active; false otherwise.
+     */
+    darkModeEnabled() {
+        return this._darkModeEnbled;
+    }
+    /**
+     * Removes the dark mode information from local storage.
+     */
+    invalidateStorage() {
+        localStorage.removeItem(this._storageKey);
+    }
+    // --> Private methods
+    initDarkMode(config) {
+        this._darkModeEnbled = config.darkModeEnbled || false;
+        this._cssProperty = config.cssProperty || CSS_PROP;
+        this._storageKey = config.storageKey || STORAGE_KEY;
+        if (this._darkModeEnbled) {
+            this.enableDarkMode();
+        }
+        else {
+            this.initStoredDarkMode();
+        }
+        if (config.detectBrowserSettings)
+            this.initBrowserMode();
+    }
+    initStoredDarkMode() {
+        const result = localStorage.getItem(this._storageKey);
+        if (result === "true")
+            this.enableDarkMode();
+    }
+    setStoredDarkMode() {
+        const data = String(this._darkModeEnbled);
+        localStorage.setItem(this._storageKey, data);
+    }
+    setDarkMode(action) {
+        const classList = this._document.body.classList;
+        if (action === ADD_ACTION) {
+            classList.add(this._cssProperty);
+            this._darkModeEnbled = true;
+        }
+        else if (action === REMOVE_ACTION) {
+            classList.remove(this._cssProperty);
+            this._darkModeEnbled = false;
+        }
+        this.change.emit(this._darkModeEnbled);
+    }
+    initBrowserMode() {
+        if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {
+            this.enableDarkMode();
+        }
+    }
+}
+DarkModeService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, deps: [{ token: DOCUMENT }, { token: DARK_MODE_CONFIG }], target: i0.ɵɵFactoryTarget.Injectable });
+DarkModeService.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, providedIn: 'root' });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: DarkModeService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: function () { return [{ type: Document, decorators: [{
+                    type: Inject,
+                    args: [DOCUMENT]
+                }] }, { type: undefined, decorators: [{
+                    type: Inject,
+                    args: [DARK_MODE_CONFIG]
+                }] }]; } });
+
 class AngularToolboxModule {
 }
 AngularToolboxModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
 AngularToolboxModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, declarations: [SafeHtmlPipe], exports: [SafeHtmlPipe] });
-AngularToolboxModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule });
+AngularToolboxModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, providers: [
+        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }
+    ] });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImport: i0, type: AngularToolboxModule, decorators: [{
             type: NgModule,
             args: [{
                     declarations: [
                         SafeHtmlPipe
                     ],
+                    providers: [
+                        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }
+                    ],
                     exports: [
                         SafeHtmlPipe
                     ]
@@ -100,5 +256,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.9", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AngularToolboxModule, SafeHtmlPipe, SubscriptionService };
+export { AngularToolboxModule, DARK_MODE_CONFIG, DarkModeService, SafeHtmlPipe, SubscriptionService };
 //# sourceMappingURL=angular-toolbox.mjs.map

package/fesm2020/angular-toolbox.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"angular-toolbox.mjs","sources":["../../../projects/angular-toolbox/src/lib/pipe/safe/safe-html.pipe.ts","../../../projects/angular-toolbox/src/lib/angular-toolbox.module.ts","../../../projects/angular-toolbox/src/lib/service/subscription/subscription.service.ts","../../../projects/angular-toolbox/src/public-api.ts","../../../projects/angular-toolbox/src/angular-toolbox.ts"],"sourcesContent":["import { DomSanitizer, SafeHtml } from '@angular/platform-browser'\r\nimport { PipeTransform, Pipe } from \"@angular/core\";\r\n\r\n@Pipe({ name: 'safeHtml'})\r\nexport class SafeHtmlPipe implements PipeTransform  {\r\n\r\n  constructor(private _sanitizer: DomSanitizer) {}\r\n\r\n  public transform(value: string): SafeHtml {\r\n    return this._sanitizer.bypassSecurityTrustHtml(value);\r\n  }\r\n}","import { NgModule } from '@angular/core';\r\nimport { SafeHtmlPipe } from './pipe/safe/safe-html.pipe';\r\n\r\n@NgModule({\r\n    declarations: [\r\n        SafeHtmlPipe\r\n    ],\r\n    exports: [\r\n        SafeHtmlPipe\r\n    ]\r\n})\r\nexport class AngularToolboxModule { }","import { Injectable } from '@angular/core';\nimport { Subscription } from 'rxjs';\n\n@Injectable({\n    providedIn: 'root'\n})\n/**\n * A lightweight service that helps to manage unregistration issues of Angular subscriptions.\n */\nexport class SubscriptionService {\n\n    /**\n     * The internal Subscription instances storage.\n     */\n    private _subMap: Map<String, Array<Subscription>> = new Map<String, Array<Subscription>>();\n\n    /**\n     * Stores a new Subscription instance associated with the specified reference.\n     * \n     * @param ref the reference for which to store a new Subscription instance.\n     * @param subscription the Subscription instance to register.\n     * @returns a reference to this SubscriptionService instance.\n     */\n    public register(ref: String, subscription: Subscription): SubscriptionService {\n        if (!this._subMap.has(ref)) this._subMap.set(ref, []);\n        this._subMap.get(ref)?.push(subscription);\n        return this;\n    }\n \n    /**\n     * Unsubscribes and removes all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove all Subscription instances.\n     * @returns true whether the specified reference exists; false otherwise.\n     */\n    public clearAll(ref: String): boolean {\n        let result: boolean = false;\n        if (this._subMap.has(ref)) {\n            this._subMap.get(ref)?.forEach(subscription => subscription.unsubscribe());\n            this._subMap.delete(ref);\n            result = true;\n        }\n        return result;\n    }\n\n    /**\n     * Returns all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove get Subscription instances.\n     * @returns all Subscription instances associated with the specified reference, or whether\n     *          the specified reference does not exists.\n     */\n    public get(ref: String): Array<Subscription> | null {\n        return this._subMap.get(ref) || null;\n    }\n}\n","/*\n * Public API Surface of angular-toolbox\n */\n\nexport * from './lib/angular-toolbox.module';\nexport * from './lib/pipe';\nexport * from './lib/service';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"angular-toolbox.mjs","sources":["../../../projects/angular-toolbox/src/lib/pipe/safe/safe-html.pipe.ts","../../../projects/angular-toolbox/src/lib/service/ui/dark-mode.service.ts","../../../projects/angular-toolbox/src/lib/angular-toolbox.module.ts","../../../projects/angular-toolbox/src/lib/service/subscription/subscription.service.ts","../../../projects/angular-toolbox/src/public-api.ts","../../../projects/angular-toolbox/src/angular-toolbox.ts"],"sourcesContent":["import { DomSanitizer, SafeHtml } from '@angular/platform-browser'\r\nimport { PipeTransform, Pipe } from \"@angular/core\";\r\n\r\n@Pipe({ name: 'safeHtml'})\r\nexport class SafeHtmlPipe implements PipeTransform  {\r\n\r\n  constructor(private _sanitizer: DomSanitizer) {}\r\n\r\n  public transform(value: string): SafeHtml {\r\n    return this._sanitizer.bypassSecurityTrustHtml(value);\r\n  }\r\n}","import { Inject, Injectable, EventEmitter } from '@angular/core';\nimport { DOCUMENT } from '@angular/common';\n\n// --> Internal constants\nconst STORAGE_KEY: string = \"dark-mode-key\";\nconst CSS_PROP: string = \"dark-mode\";\nconst ADD_ACTION: string = \"add\";\nconst REMOVE_ACTION: string = \"remove\";\n\n/**\n * Defines properties for the DarkModeService configuration.\n */\nexport interface DarkModeConfig {\n\n    /**\n     * Indicates whether the dark mode is activated by default (true), or not (false).\n     */\n    darkModeEnbled?: boolean;\n    \n    /**\n     * Indicates whether the dark mode uses browser settings (true), or not (false).\n     * When true, this property overrides the darkModeEnbled property.\n     */\n    detectBrowserSettings?: boolean;\n\n    /**\n     * CSS property name used to set the dark mode look and feel.\n     */\n    cssProperty?: string;\n\n    /**\n     * Reference to the key value used to persist the dark mode state to local storage.\n     */\n    storageKey?: string;\n}\n\n/**\n * The default provider for the DarkModeService configuration. You typically define\n * the custom properties in the main NgModule declaration to initialize the app dark mode:\n * \n * @NgModule({\n * ...\n * providers: [\n *   { provide: DARK_MODE_CONFIG, useValue: { enableDarkMode: true} }\n * ],\n * ...\n * s);\n */\nexport const DARK_MODE_CONFIG: DarkModeConfig = {\n    \n    /**\n     * Indicates whether the dark mode uses browser settings (true), or not (false).\n     * Default value is false.\n     */\n    darkModeEnbled: false,\n    \n    /**\n     * Indicates whether the dark mode uses browser settings (true), or not (false).\n     * Default value is false.\n     */\n    detectBrowserSettings: false,\n    \n    /**\n     * CSS property name used to set the dark mode look and feel.\n     * Default value is 'dark-mode'.\n     */\n    cssProperty: CSS_PROP,\n    \n    /**\n     * Reference to the key value used to persist the dark mode state to local storage.\n     * Default value is 'dark-mode-key'.\n     */\n    storageKey: STORAGE_KEY\n};\n\n@Injectable({\n    providedIn: 'root'\n})\n/**\n * A lightweight service that provides Dark Mode implementation for your Angular application.\n */\nexport class DarkModeService {\n\n    // --> Private properties\n    private _darkModeEnbled: boolean = false;\n    private _cssProperty: string = CSS_PROP;\n    private _storageKey: string = STORAGE_KEY;\n\n    /**\n     * The callback function that is triggered when the dark mode changes.\n     * @typeParam EventEmitter<boolean> the value returned by the darkModeEnabled() property.\n     */\n    public readonly change: EventEmitter<boolean> = new EventEmitter<boolean>(true);\n\n    /**\n     * Creates a new DarkModeService instance.\n     * @param _document the reference to the Document singleton.\n     * @param config the reference to the DarkModeConfig provider.\n     */\n    constructor(@Inject(DOCUMENT) private _document: Document, @Inject(DARK_MODE_CONFIG) config: DarkModeConfig) {\n        this.initDarkMode(config);\n    }\n\n    /**\n     * Toogles the dark mode state.\n     */\n    public toggleDarkMode(): void {\n        this._darkModeEnbled ? this.disableDarkMode() : this.enableDarkMode();\n    }\n\n    /**\n     * Sets the dark mode state to active.\n     */\n    public enableDarkMode(): void {\n        this.setDarkMode(ADD_ACTION);\n        this.setStoredDarkMode();\n    }\n\n    /**\n     * Sets the dark mode state to inactive.\n     */\n    public disableDarkMode(): void {\n        this.setDarkMode(REMOVE_ACTION);\n        this.setStoredDarkMode();\n    }\n\n    /**\n     * Returns a boolean value that indicates the dark mode state is active (true), or not (false).\n     * @returns true whether the dark mode state is active; false otherwise.\n     */\n    public darkModeEnabled(): boolean {\n        return this._darkModeEnbled;\n    }\n\n    /**\n     * Removes the dark mode information from local storage.\n     */\n    public invalidateStorage(): void {\n        localStorage.removeItem(this._storageKey);\n    }\n\n    // --> Private methods\n    private initDarkMode(config: DarkModeConfig): void {\n        this._darkModeEnbled = config.darkModeEnbled || false;\n        this._cssProperty = config.cssProperty || CSS_PROP;\n        this._storageKey = config.storageKey || STORAGE_KEY;\n        if (this._darkModeEnbled) {\n            this.enableDarkMode();\n        } else {\n            this.initStoredDarkMode();\n        }\n        if (config.detectBrowserSettings) this.initBrowserMode();\n    }\n    \n    private initStoredDarkMode(): void {\n        const result: string | null = localStorage.getItem(this._storageKey);\n        if (result === \"true\") this.enableDarkMode();\n    }\n\n    private setStoredDarkMode(): void {\n        const data: string = String(this._darkModeEnbled);\n        localStorage.setItem(this._storageKey, data);\n    }\n\n    private setDarkMode(action: string): void {\n        const classList: DOMTokenList = this._document.body.classList;\n        if (action === ADD_ACTION) {\n            classList.add(this._cssProperty);\n            this._darkModeEnbled = true;\n        } else if (action === REMOVE_ACTION) {\n            classList.remove(this._cssProperty);\n            this._darkModeEnbled = false;\n        }\n        this.change.emit(this._darkModeEnbled);\n    }\n\n    private initBrowserMode(): void {\n        if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {\n            this.enableDarkMode();\n        }\n    }\n}\n\n","import { NgModule } from '@angular/core';\r\nimport { SafeHtmlPipe } from './pipe/safe/safe-html.pipe';\r\nimport { DARK_MODE_CONFIG } from './service/ui/dark-mode.service';\r\n\r\n@NgModule({\r\n    declarations: [\r\n        SafeHtmlPipe\r\n    ],\r\n    providers: [\r\n        { provide: DARK_MODE_CONFIG, useValue: DARK_MODE_CONFIG }\r\n      ],\r\n    exports: [\r\n        SafeHtmlPipe\r\n    ]\r\n})\r\nexport class AngularToolboxModule { }","import { Injectable } from '@angular/core';\nimport { Subscription } from 'rxjs';\n\n@Injectable({\n    providedIn: 'root'\n})\n/**\n * A lightweight service that helps to manage unregistration issues of Angular subscriptions.\n */\nexport class SubscriptionService {\n\n    /**\n     * The internal Subscription instances storage.\n     */\n    private _subMap: Map<String, Array<Subscription>> = new Map<String, Array<Subscription>>();\n\n    /**\n     * Stores a new Subscription instance associated with the specified reference.\n     * \n     * @param ref the reference for which to store a new Subscription instance.\n     * @param subscription the Subscription instance to register.\n     * @returns a reference to this SubscriptionService instance.\n     */\n    public register(ref: String, subscription: Subscription): SubscriptionService {\n        if (!this._subMap.has(ref)) this._subMap.set(ref, []);\n        this._subMap.get(ref)?.push(subscription);\n        return this;\n    }\n \n    /**\n     * Unsubscribes and removes all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove all Subscription instances.\n     * @returns true whether the specified reference exists; false otherwise.\n     */\n    public clearAll(ref: String): boolean {\n        let result: boolean = false;\n        if (this._subMap.has(ref)) {\n            this._subMap.get(ref)?.forEach(subscription => subscription.unsubscribe());\n            this._subMap.delete(ref);\n            result = true;\n        }\n        return result;\n    }\n\n    /**\n     * Returns all Subscription instances associated with the specified reference.\n     * \n     * @param ref the reference for which to remove get Subscription instances.\n     * @returns all Subscription instances associated with the specified reference, or whether\n     *          the specified reference does not exists.\n     */\n    public get(ref: String): Array<Subscription> | null {\n        return this._subMap.get(ref) || null;\n    }\n}\n","/*\n * Public API Surface of angular-toolbox\n */\n\nexport * from './lib/angular-toolbox.module';\nexport * from './lib/pipe';\nexport * from './lib/service';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;MAIa,YAAY,CAAA;AAEvB,IAAA,WAAA,CAAoB,UAAwB,EAAA;QAAxB,IAAU,CAAA,UAAA,GAAV,UAAU,CAAc;KAAI;AAEzC,IAAA,SAAS,CAAC,KAAa,EAAA;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;KACvD;;yGANU,YAAY,EAAA,IAAA,EAAA,CAAA,EAAA,KAAA,EAAA,EAAA,CAAA,YAAA,EAAA,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,IAAA,EAAA,CAAA,CAAA;uGAAZ,YAAY,EAAA,IAAA,EAAA,UAAA,EAAA,CAAA,CAAA;2FAAZ,YAAY,EAAA,UAAA,EAAA,CAAA;kBADxB,IAAI;mBAAC,EAAE,IAAI,EAAE,UAAU,EAAC,CAAA;;;ACAzB;AACA,MAAM,WAAW,GAAW,eAAe,CAAC;AAC5C,MAAM,QAAQ,GAAW,WAAW,CAAC;AACrC,MAAM,UAAU,GAAW,KAAK,CAAC;AACjC,MAAM,aAAa,GAAW,QAAQ,CAAC;AA6BvC;;;;;;;;;;;AAWG;AACU,MAAA,gBAAgB,GAAmB;AAE5C;;;AAGG;AACH,IAAA,cAAc,EAAE,KAAK;AAErB;;;AAGG;AACH,IAAA,qBAAqB,EAAE,KAAK;AAE5B;;;AAGG;AACH,IAAA,WAAW,EAAE,QAAQ;AAErB;;;AAGG;AACH,IAAA,UAAU,EAAE,WAAW;EACzB;AAKF;;AAEG;MACU,eAAe,CAAA;AAaxB;;;;AAIG;IACH,WAAsC,CAAA,SAAmB,EAA4B,MAAsB,EAAA;QAArE,IAAS,CAAA,SAAA,GAAT,SAAS,CAAU;;QAfjD,IAAe,CAAA,eAAA,GAAY,KAAK,CAAC;QACjC,IAAY,CAAA,YAAA,GAAW,QAAQ,CAAC;QAChC,IAAW,CAAA,WAAA,GAAW,WAAW,CAAC;AAE1C;;;AAGG;AACa,QAAA,IAAA,CAAA,MAAM,GAA0B,IAAI,YAAY,CAAU,IAAI,CAAC,CAAC;AAQ5E,QAAA,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;KAC7B;AAED;;AAEG;IACI,cAAc,GAAA;AACjB,QAAA,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;KACzE;AAED;;AAEG;IACI,cAAc,GAAA;AACjB,QAAA,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,CAAC,iBAAiB,EAAE,CAAC;KAC5B;AAED;;AAEG;IACI,eAAe,GAAA;AAClB,QAAA,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAChC,IAAI,CAAC,iBAAiB,EAAE,CAAC;KAC5B;AAED;;;AAGG;IACI,eAAe,GAAA;QAClB,OAAO,IAAI,CAAC,eAAe,CAAC;KAC/B;AAED;;AAEG;IACI,iBAAiB,GAAA;AACpB,QAAA,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;KAC7C;;AAGO,IAAA,YAAY,CAAC,MAAsB,EAAA;QACvC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,IAAI,KAAK,CAAC;QACtD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,IAAI,WAAW,CAAC;QACpD,IAAI,IAAI,CAAC,eAAe,EAAE;YACtB,IAAI,CAAC,cAAc,EAAE,CAAC;AACzB,SAAA;AAAM,aAAA;YACH,IAAI,CAAC,kBAAkB,EAAE,CAAC;AAC7B,SAAA;QACD,IAAI,MAAM,CAAC,qBAAqB;YAAE,IAAI,CAAC,eAAe,EAAE,CAAC;KAC5D;IAEO,kBAAkB,GAAA;QACtB,MAAM,MAAM,GAAkB,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrE,IAAI,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,cAAc,EAAE,CAAC;KAChD;IAEO,iBAAiB,GAAA;QACrB,MAAM,IAAI,GAAW,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClD,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;KAChD;AAEO,IAAA,WAAW,CAAC,MAAc,EAAA;QAC9B,MAAM,SAAS,GAAiB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;QAC9D,IAAI,MAAM,KAAK,UAAU,EAAE;AACvB,YAAA,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACjC,YAAA,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;AAC/B,SAAA;aAAM,IAAI,MAAM,KAAK,aAAa,EAAE;AACjC,YAAA,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACpC,YAAA,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;AAChC,SAAA;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;KAC1C;IAEO,eAAe,GAAA;AACnB,QAAA,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,EAAE;YAChF,IAAI,CAAC,cAAc,EAAE,CAAC;AACzB,SAAA;KACJ;;4GAnGQ,eAAe,EAAA,IAAA,EAAA,CAAA,EAAA,KAAA,EAkBJ,QAAQ,EAAA,EAAA,EAAA,KAAA,EAAuC,gBAAgB,EAAA,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAlB1E,eAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,eAAe,cALZ,MAAM,EAAA,CAAA,CAAA;2FAKT,eAAe,EAAA,UAAA,EAAA,CAAA;kBAN3B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACR,oBAAA,UAAU,EAAE,MAAM;AACrB,iBAAA,CAAA;;0BAsBgB,MAAM;2BAAC,QAAQ,CAAA;;0BAAgC,MAAM;2BAAC,gBAAgB,CAAA;;;MCpF1E,oBAAoB,CAAA;;iHAApB,oBAAoB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,QAAA,EAAA,CAAA,CAAA;kHAApB,oBAAoB,EAAA,YAAA,EAAA,CATzB,YAAY,CAAA,EAAA,OAAA,EAAA,CAMZ,YAAY,CAAA,EAAA,CAAA,CAAA;AAGP,oBAAA,CAAA,IAAA,GAAA,EAAA,CAAA,mBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,oBAAoB,EAPlB,SAAA,EAAA;AACP,QAAA,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE;AAC1D,KAAA,EAAA,CAAA,CAAA;2FAKM,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBAXhC,QAAQ;AAAC,YAAA,IAAA,EAAA,CAAA;AACN,oBAAA,YAAY,EAAE;wBACV,YAAY;AACf,qBAAA;AACD,oBAAA,SAAS,EAAE;AACP,wBAAA,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE;AAC1D,qBAAA;AACH,oBAAA,OAAO,EAAE;wBACL,YAAY;AACf,qBAAA;AACJ,iBAAA,CAAA;;;ACRD;;AAEG;MACU,mBAAmB,CAAA;AANhC,IAAA,WAAA,GAAA;AAQI;;AAEG;AACK,QAAA,IAAA,CAAA,OAAO,GAAqC,IAAI,GAAG,EAA+B,CAAC;AAyC9F,KAAA;AAvCG;;;;;;AAMG;IACI,QAAQ,CAAC,GAAW,EAAE,YAA0B,EAAA;QACnD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACtD,QAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;AAC1C,QAAA,OAAO,IAAI,CAAC;KACf;AAED;;;;;AAKG;AACI,IAAA,QAAQ,CAAC,GAAW,EAAA;QACvB,IAAI,MAAM,GAAY,KAAK,CAAC;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACvB,YAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3E,YAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,MAAM,GAAG,IAAI,CAAC;AACjB,SAAA;AACD,QAAA,OAAO,MAAM,CAAC;KACjB;AAED;;;;;;AAMG;AACI,IAAA,GAAG,CAAC,GAAW,EAAA;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;KACxC;;gHA7CQ,mBAAmB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAnB,mBAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,mBAAmB,cALhB,MAAM,EAAA,CAAA,CAAA;2FAKT,mBAAmB,EAAA,UAAA,EAAA,CAAA;kBAN/B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACR,oBAAA,UAAU,EAAE,MAAM;AACrB,iBAAA,CAAA;;;ACLD;;AAEG;;ACFH;;AAEG;;;;"}

package/lib/service/index.d.ts

@@ -1 +1,2 @@
 export * from './subscription/subscription.service';
+export * from './ui/dark-mode.service';

package/lib/service/ui/dark-mode.service.d.ts

@@ -0,0 +1,82 @@
+import { EventEmitter } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Defines properties for the DarkModeService configuration.
+ */
+export interface DarkModeConfig {
+    /**
+     * Indicates whether the dark mode is activated by default (true), or not (false).
+     */
+    darkModeEnbled?: boolean;
+    /**
+     * Indicates whether the dark mode uses browser settings (true), or not (false).
+     * When true, this property overrides the darkModeEnbled property.
+     */
+    detectBrowserSettings?: boolean;
+    /**
+     * CSS property name used to set the dark mode look and feel.
+     */
+    cssProperty?: string;
+    /**
+     * Reference to the key value used to persist the dark mode state to local storage.
+     */
+    storageKey?: string;
+}
+/**
+ * The default provider for the DarkModeService configuration. You typically define
+ * the custom properties in the main NgModule declaration to initialize the app dark mode:
+ *
+ * @NgModule({
+ * ...
+ * providers: [
+ *   { provide: DARK_MODE_CONFIG, useValue: { enableDarkMode: true} }
+ * ],
+ * ...
+ * s);
+ */
+export declare const DARK_MODE_CONFIG: DarkModeConfig;
+export declare class DarkModeService {
+    private _document;
+    private _darkModeEnbled;
+    private _cssProperty;
+    private _storageKey;
+    /**
+     * The callback function that is triggered when the dark mode changes.
+     * @typeParam EventEmitter<boolean> the value returned by the darkModeEnabled() property.
+     */
+    readonly change: EventEmitter<boolean>;
+    /**
+     * Creates a new DarkModeService instance.
+     * @param _document the reference to the Document singleton.
+     * @param config the reference to the DarkModeConfig provider.
+     */
+    constructor(_document: Document, config: DarkModeConfig);
+    /**
+     * Toogles the dark mode state.
+     */
+    toggleDarkMode(): void;
+    /**
+     * Sets the dark mode state to active.
+     */
+    enableDarkMode(): void;
+    /**
+     * Sets the dark mode state to inactive.
+     */
+    disableDarkMode(): void;
+    /**
+     * Returns a boolean value that indicates the dark mode state is active (true), or not (false).
+     * @returns true whether the dark mode state is active; false otherwise.
+     */
+    darkModeEnabled(): boolean;
+    /**
+     * Removes the dark mode information from local storage.
+     */
+    invalidateStorage(): void;
+    private initDarkMode;
+    private initStoredDarkMode;
+    private setStoredDarkMode;
+    private setDarkMode;
+    private initBrowserMode;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DarkModeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DarkModeService>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-toolbox",
-  "version": "0.0.2",
+  "version": "0.0.6",
   "peerDependencies": {
     "@angular/common": "^15.1.0",
     "@angular/core": "^15.1.0"