@decaf-ts/for-angular 0.0.17 → 0.0.18

package/helpers/utils.d.ts

@@ -152,22 +152,7 @@ export declare function isNotUndefined(prop: StringOrBoolean | undefined): boole
  * @function getLocaleFromClassName
  * @memberOf module:for-angular
  */
-export declare function getLocaleFromClassName(instance: string | FunctionLike | object, suffix?: string): string;
-/**
- * @description Generates a localized string by combining locale and phrase
- * @summary This utility function creates a properly formatted locale string by combining
- * a locale identifier with a phrase. It handles edge cases such as empty phrases,
- * missing locales, and phrases that already include the locale prefix. This function
- * is useful for ensuring consistent formatting of localized strings throughout the application.
- *
- * @param {string} locale - The locale identifier (e.g., 'en', 'fr')
- * @param {string | undefined} phrase - The phrase to localize
- * @return {string} The formatted locale string, or empty string if phrase is undefined
- *
- * @function generateLocaleFromString
- * @memberOf module:for-angular
- */
-export declare function generateLocaleFromString(locale: string, phrase: string | undefined): string;
+export declare function getLocaleFromClassName(instance: string | FunctionLike | KeyValue, suffix?: string): string;
 /**
  * @description Retrieves the current locale language
  * @summary This utility function gets the current locale language based on the user's browser settings.
@@ -250,5 +235,45 @@ export declare function itemMapper(item: KeyValue, mapper: KeyValue, props?: Key
  * the original item is returned instead.
  */
 export declare function dataMapper<T>(data: T[], mapper: KeyValue, props?: KeyValue): T[];
+/**
+ * @description Removes focus from the currently active DOM element
+ * @summary This utility function blurs the currently focused element in the document,
+ * effectively removing focus traps that might prevent proper navigation or keyboard
+ * interaction. It safely accesses the document's activeElement and calls blur() if
+ * an element is currently focused. This is useful for accessibility and user experience
+ * improvements, particularly when closing modals or dialogs.
+ *
+ * @return {void}
+ *
+ * @function removeFocusTrap
+ * @memberOf module:for-angular
+ */
 export declare function removeFocusTrap(): void;
-export declare function cleanSpaces(value: string, lowercase?: boolean): string;
+/**
+ * @description Cleans and normalizes whitespace in a string value
+ * @summary This utility function trims leading and trailing whitespace from a string
+ * and replaces multiple consecutive whitespace characters with a single space.
+ * Optionally converts the result to lowercase for consistent text processing.
+ * This is useful for normalizing user input, search terms, or data sanitization.
+ *
+ * @param {string} value - The string value to clean and normalize
+ * @param {boolean} [lowercase=false] - Whether to convert the result to lowercase
+ * @return {string} The cleaned and normalized string
+ *
+ * @function cleanSpaces
+ * @memberOf module:for-angular
+ */
+export declare function cleanSpaces(value?: string, lowercase?: boolean): string;
+/**
+ * @description Determines if the user's system is currently in dark mode
+ * @summary This function checks the user's color scheme preference using the CSS media query
+ * '(prefers-color-scheme: dark)'. It returns a boolean indicating whether the system is
+ * currently set to dark mode. This is useful for implementing theme-aware functionality
+ * and adjusting UI elements based on the user's preferred color scheme.
+ *
+ * @return {Promise<boolean>} True if the system is in dark mode, false otherwise
+ *
+ * @function isDarkMode
+ * @memberOf module:for-angular
+ */
+export declare function isDarkMode(): Promise<boolean>;

package/i18n/Loader.d.ts

@@ -0,0 +1,48 @@
+import { HttpClient } from '@angular/common/http';
+import { TranslateLoader, TranslationObject } from '@ngx-translate/core';
+import { Observable } from 'rxjs';
+import { I18nResourceConfig } from '../engine/interfaces';
+import { InjectionToken } from '@angular/core';
+import { FunctionLike } from '../engine';
+export declare class I18nLoader {
+    static loadFromHttp(http: HttpClient): TranslateLoader;
+}
+export declare function getLocaleContext(clazz: FunctionLike | object | string, suffix?: string): string;
+/**
+ * @description Generates a localized string by combining locale and phrase
+ * @summary This utility function creates a properly formatted locale string by combining
+ * a locale identifier with a phrase. It handles edge cases such as empty phrases,
+ * missing locales, and phrases that already include the locale prefix. This function
+ * is useful for ensuring consistent formatting of localized strings throughout the application.
+ *
+ * @param {string} locale - The locale identifier (e.g., 'en', 'fr')
+ * @param {string | undefined} phrase - The phrase to localize
+ * @return {string} The formatted locale string, or empty string if phrase is undefined
+ *
+ * @function generateLocaleFromString
+ * @memberOf module:for-angular
+ */
+export declare function getLocaleContextByKey(locale: string, phrase: string | undefined): string;
+export declare const I18N_CONFIG_TOKEN: InjectionToken<{
+    resources: I18nResourceConfig[];
+    versionedSuffix: false;
+}>;
+export declare function I18nLoaderFactory(http: HttpClient): TranslateLoader;
+export declare function getI18nLoaderFactoryProviderConfig(resources?: I18nResourceConfig | I18nResourceConfig[], versionedSuffix?: boolean): {
+    provide: InjectionToken<{
+        resources: I18nResourceConfig[];
+        versionedSuffix: false;
+    }>;
+    useValue: {
+        resources: I18nResourceConfig[];
+        versionedSuffix: boolean;
+    };
+};
+export declare class MultiI18nLoader implements I18nLoader {
+    private http;
+    private resources;
+    private versionedSuffix;
+    constructor(http: HttpClient, resources?: I18nResourceConfig[], versionedSuffix?: boolean);
+    private getSuffix;
+    getTranslation(lang: string): Observable<TranslationObject>;
+}

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@decaf-ts/for-angular",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "author": "Tiago Venceslau",
   "license": "AGPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/decaf-ts/for-angular.git"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  },
   "peerDependencies": {
     "@angular/animations": "^18.2.13",
     "@angular/cdk": "^18.2.14",
@@ -19,6 +27,7 @@
     "@decaf-ts/decorator-validation": "^1.6.4",
     "@decaf-ts/for-http": "latest",
     "@decaf-ts/reflection": "latest",
+    "@decaf-ts/styles": "^0.0.3",
     "@decaf-ts/ui-decorators": "latest",
     "@ionic/angular": "^8.5.5",
     "@ngx-translate/core": "^16.0.4",