valtech-components 2.0.291 → 2.0.292

package/lib/examples/multi-language-demo.component.d.ts

@@ -0,0 +1,34 @@
+import { OnInit } from '@angular/core';
+import { ContentService } from '../services/content.service';
+import { LangService } from '../services/lang-provider/lang-provider.service';
+import * as i0 from "@angular/core";
+/**
+ * MultiLanguageDemoComponent - Demuestra el sistema de idiomas flexible.
+ *
+ * Este componente muestra cómo el sistema maneja múltiples idiomas,
+ * fallbacks automáticos y warnings por traducciones faltantes.
+ */
+export declare class MultiLanguageDemoComponent implements OnInit {
+    content: ContentService;
+    langService: LangService;
+    availableLanguages: string[];
+    analysisResults: {
+        availableLanguages: string[];
+        missingKeys: string[];
+    } | null;
+    okButton$: import("rxjs").Observable<string>;
+    cancelButton$: import("rxjs").Observable<string>;
+    saveButton$: import("rxjs").Observable<string>;
+    deleteButton$: import("rxjs").Observable<string>;
+    nextButton$: import("rxjs").Observable<string>;
+    finishButton$: import("rxjs").Observable<string>;
+    searchPlaceholder$: import("rxjs").Observable<string>;
+    noDataMessage$: import("rxjs").Observable<string>;
+    constructor(content: ContentService, langService: LangService);
+    ngOnInit(): void;
+    switchLanguage(lang: string): void;
+    getLanguageName(lang: string): string;
+    analyzeCurrentComponent(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MultiLanguageDemoComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MultiLanguageDemoComponent, "val-multi-language-demo", never, {}, {}, never, never, true, never>;
+}

package/lib/services/lang-provider/content.d.ts

@@ -5,7 +5,10 @@ export interface Provider {
 /**
  * Global content that can be used across all components.
  * These are common texts like buttons, actions, states, etc.
- * Structure: {es: {key1: 'value1', key2: 'value2'}, en: {key1: 'value1', key2: 'value2'}}
+ * Structure: {es: {key1: 'value1', key2: 'value2'}, en: {key1: 'value1', key2: 'value2'}, fr: {...}}
+ *
+ * Note: You can add any language code. The system will automatically detect available languages
+ * and provide intelligent fallbacks with warnings for missing translations.
  */
 declare const globalContentData: LanguagesContent;
 declare const GlobalContent: TextContent;

package/lib/services/lang-provider/lang-provider.service.d.ts

@@ -8,6 +8,9 @@ import * as i0 from "@angular/core";
  * This service provides reactive content management with Observable-based language switching.
  * Components can subscribe to content changes and automatically update when the language changes.
  *
+ * The service automatically detects available languages from the content configuration
+ * and provides intelligent fallbacks with console warnings for missing translations.
+ *
  * @example Basic usage:
  * ```typescript
  * constructor(private langService: LangService) {}
@@ -27,10 +30,30 @@ import * as i0 from "@angular/core";
  */
 export declare class LangService {
     private content;
-    private default;
+    private defaultLang;
+    private availableLanguages;
     private selectedLang;
     private config;
+    private warnedMissingLanguages;
     constructor(config: ValtechConfig);
+    /**
+     * Detect available languages from the content configuration.
+     * Scans all component content to find which languages are actually configured.
+     */
+    private detectAvailableLanguages;
+    /**
+     * Determine the best default language based on available content.
+     */
+    private determineDefaultLanguage;
+    /**
+     * Validate if a language is available in the content.
+     */
+    private validateLanguage;
+    /**
+     * Get the best available language for a component and key.
+     * Provides intelligent fallback with warnings.
+     */
+    private getBestAvailableContent;
     /**
      * Observable that emits the current language whenever it changes.
      * Use this to subscribe to language changes in components.
@@ -40,10 +63,20 @@ export declare class LangService {
      * Get the current language synchronously.
      */
     get currentLang(): LangOption;
+    /**
+     * Get array of available languages detected from content.
+     */
+    get availableLangs(): LangOption[];
+    /**
+     * Get the default language.
+     */
+    get defaultLanguage(): LangOption;
     /**
      * Set the current language and persist it to localStorage.
      * This will trigger updates in all reactive content subscriptions.
      *
+     * Validates that the language is available and warns if not.
+     *
      * @param lang - The language to set
      */
     setLang(lang: LangOption): void;
@@ -55,6 +88,7 @@ export declare class LangService {
     Text(className: string): LanguageText;
     /**
      * Get a single content string synchronously for the current language.
+     * Provides intelligent fallback with warnings for missing translations.
      *
      * @param className - The component class name
      * @param key - The text key
@@ -65,6 +99,7 @@ export declare class LangService {
     /**
      * Get a reactive Observable for a specific text key that updates when language changes.
      * This is the recommended method for components that need reactive content.
+     * Provides intelligent fallback with warnings for missing translations.
      *
      * @param className - The component class name
      * @param key - The text key
@@ -74,6 +109,7 @@ export declare class LangService {
     getContent(className: string, key: string, fallback?: string): Observable<string>;
     /**
      * Get reactive content for multiple keys at once.
+     * Provides intelligent fallback with warnings for missing translations.
      *
      * @param className - The component class name
      * @param keys - Array of text keys to retrieve
@@ -81,13 +117,39 @@ export declare class LangService {
      */
     getMultipleContent(className: string, keys: string[]): Observable<Record<string, string>>;
     /**
-     * Check if a content key exists for a component.
+     * Check if a content key exists for a component in any available language.
      *
      * @param className - The component class name
      * @param key - The text key
      * @returns True if the key exists in any language
      */
     hasContent(className: string, key: string): boolean;
+    /**
+     * Check if a content key exists for a component in a specific language.
+     *
+     * @param className - The component class name
+     * @param key - The text key
+     * @param lang - The language to check (defaults to current language)
+     * @returns True if the key exists in the specified language
+     */
+    hasContentInLanguage(className: string, key: string, lang?: LangOption): boolean;
+    /**
+     * Get available languages for a specific component.
+     *
+     * @param className - The component class name
+     * @returns Array of language codes available for the component
+     */
+    getAvailableLanguagesForComponent(className: string): LangOption[];
+    /**
+     * Get missing content keys for a component in a specific language.
+     * Useful for identifying incomplete translations.
+     *
+     * @param className - The component class name
+     * @param lang - The language to check
+     * @param referenceLang - The reference language to compare against (defaults to default language)
+     * @returns Array of missing keys
+     */
+    getMissingContentKeys(className: string, lang: LangOption, referenceLang?: LangOption): string[];
     get Lang(): LangOption;
     set Lang(lang: LangOption);
     static ɵfac: i0.ɵɵFactoryDeclaration<LangService, never>;

package/lib/services/lang-provider/types.d.ts

@@ -9,7 +9,22 @@ export declare class TextContent {
     constructor(text: LanguagesContent);
     get Content(): LanguagesContent;
 }
-export declare enum LangOption {
-    ES = "es",
-    EN = "en"
-}
+/**
+ * Language code type - supports any valid language code string.
+ * Common examples: 'es', 'en', 'fr', 'de', 'pt', 'it', 'zh', 'ja', etc.
+ */
+export type LangOption = string;
+/**
+ * Common language constants for convenience.
+ * Users can still use any language code string directly.
+ */
+export declare const LANGUAGES: {
+    readonly ES: "es";
+    readonly EN: "en";
+    readonly FR: "fr";
+    readonly DE: "de";
+    readonly PT: "pt";
+    readonly IT: "it";
+    readonly ZH: "zh";
+    readonly JA: "ja";
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.291",
+  "version": "2.0.292",
   "peerDependencies": {
     "@angular/common": "^18.0.0",
     "@angular/core": "^18.0.0",

package/public-api.d.ts

@@ -82,6 +82,7 @@ export * from './lib/components/templates/simple/types';
 export * from './lib/examples/comprehensive-link-test.component';
 export * from './lib/examples/custom-content-demo.component';
 export * from './lib/examples/link-processing-example.component';
+export * from './lib/examples/multi-language-demo.component';
 export * from './lib/services/content.service';
 export * from './lib/services/download.service';
 export * from './lib/services/icons.service';