valtech-components 2.0.418 → 2.0.420

package/lib/shared/utils/content.d.ts

@@ -1,199 +0,0 @@
-import { Observable } from 'rxjs';
-import { LangService } from '../../services/lang-provider/lang-provider.service';
-/**
- * Content utilities for reactive text binding in components.
- *
- * These utilities provide a convenient way to bind component properties
- * to language content that automatically updates when the language changes.
- */
-/**
- * Unified configuration for content binding with optional interpolation.
- * Supports both simple content retrieval and content with dynamic values.
- */
-export interface ContentConfig {
-    /**
-     * The component class name (used for content lookup).
-     * If omitted, searches in global content (_global namespace).
-     */
-    className?: string;
-    /** The content key to retrieve */
-    key: string;
-    /** Optional fallback text if content is not found */
-    fallback?: string;
-    /** Optional object with values to interpolate into the content string */
-    interpolation?: Record<string, string | number>;
-}
-/**
- * @deprecated Use ContentConfig with interpolation property instead.
- * This interface is kept for backward compatibility.
- */
-export interface InterpolatedContentConfig extends ContentConfig {
-    /** Object with values to interpolate into the content string */
-    interpolation?: Record<string, string | number>;
-}
-/**
- * Create a reactive content observable from a content key.
- * This is the primary utility for the `fromContent` pattern with unified support
- * for both simple content and content with interpolation.
- *
- * @param langService - The language service instance
- * @param config - Content configuration with optional interpolation
- * @returns Observable that emits the content string and updates on language change
- *
- * @example Simple content:
- * ```typescript
- * // Component-specific content
- * this.title$ = fromContent(this.langService, {
- *   className: 'HeaderComponent',
- *   key: 'title',
- *   fallback: 'Default Title'
- * });
- *
- * // Global content (no className needed)
- * this.saveButton$ = fromContent(this.langService, {
- *   key: 'save'
- * });
- * ```
- *
- * @example Content with interpolation:
- * ```typescript
- * // Content: "Hello {name}, you have {count} messages"
- * this.greeting$ = fromContent(this.langService, {
- *   className: 'WelcomeComponent',
- *   key: 'greeting',
- *   interpolation: { name: 'John', count: 5 }
- * });
- * // Results in: "Hello John, you have 5 messages"
- * ```
- */
-export declare function fromContent(langService: LangService, config: ContentConfig): Observable<string>;
-/**
- * Create a reactive content observable with interpolation support.
- *
- * @deprecated Use fromContent() with interpolation property instead.
- * This method is kept for backward compatibility.
- *
- * @param langService - The language service instance
- * @param config - Interpolated content configuration
- * @returns Observable that emits the interpolated content string
- *
- * @example Migration:
- * ```typescript
- * // OLD (deprecated):
- * this.greeting$ = fromContentWithInterpolation(this.langService, {
- *   className: 'WelcomeComponent',
- *   key: 'greeting',
- *   interpolation: { name: 'John', count: 5 }
- * });
- *
- * // NEW (recommended):
- * this.greeting$ = fromContent(this.langService, {
- *   className: 'WelcomeComponent',
- *   key: 'greeting',
- *   interpolation: { name: 'John', count: 5 }
- * });
- * ```
- */
-export declare function fromContentWithInterpolation(langService: LangService, config: InterpolatedContentConfig): Observable<string>;
-/**
- * Create multiple reactive content observables at once.
- * Useful when a component needs several content strings.
- *
- * @param langService - The language service instance
- * @param className - The component class name
- * @param keys - Array of content keys to retrieve
- * @returns Observable that emits an object with all requested content
- *
- * @example
- * ```typescript
- * this.content$ = fromMultipleContent(this.langService, 'FormComponent', [
- *   'title', 'submitButton', 'cancelButton'
- * ]);
- *
- * // In template
- * <ng-container *ngIf="content$ | async as content">
- *   <h2>{{ content.title }}</h2>
- *   <button>{{ content.submitButton }}</button>
- *   <button>{{ content.cancelButton }}</button>
- * </ng-container>
- * ```
- */
-export declare function fromMultipleContent(langService: LangService, className: string, keys: string[]): Observable<Record<string, string>>;
-/**
- * Helper function to interpolate values into a content string.
- * Replaces placeholders in the format {key} with corresponding values.
- *
- * @param content - The content string with placeholders
- * @param values - Object with values to interpolate
- * @returns The interpolated string
- *
- * @example
- * ```typescript
- * const result = interpolateContent("Hello {name}!", { name: "World" });
- * // Returns: "Hello World!"
- * ```
- */
-export declare function interpolateContent(content: string, values?: Record<string, string | number>): string;
-/**
- * Type-safe content key builder for better IDE support.
- * This is a utility type that can be used to ensure content keys exist.
- *
- * @example
- * ```typescript
- * // Define your component's content keys
- * interface MyComponentContent {
- *   title: string;
- *   description: string;
- *   submitButton: string;
- * }
- *
- * // Use with type safety
- * const titleKey: ContentKey<MyComponentContent> = 'title'; // ✓ Valid
- * const invalidKey: ContentKey<MyComponentContent> = 'invalid'; // ✗ Type error
- * ```
- */
-export type ContentKey<T> = keyof T & string;
-/**
- * Factory function to create a content helper bound to a specific component class.
- * This creates a more convenient API for components that need multiple content strings.
- *
- * @param langService - The language service instance
- * @param className - The component class name
- * @returns Object with convenient methods for content retrieval
- *
- * @example
- * ```typescript
- * export class MyComponent {
- *   private content = createContentHelper(this.langService, 'MyComponent');
- *
- *   constructor(private langService: LangService) {}
- *
- *   ngOnInit() {
- *     this.title$ = this.content.get('title');
- *     this.allContent$ = this.content.getMultiple(['title', 'description']);
- *   }
- * }
- * ```
- */
-export declare function createContentHelper(langService: LangService, className: string): {
-    /**
-     * Get a single content string reactively.
-     */
-    get(key: string, fallback?: string): Observable<string>;
-    /**
-     * Get multiple content strings reactively.
-     */
-    getMultiple(keys: string[]): Observable<Record<string, string>>;
-    /**
-     * Get content with interpolation.
-     */
-    getWithInterpolation(key: string, interpolation: Record<string, string | number>, fallback?: string): Observable<string>;
-    /**
-     * Get a single content string synchronously (current language only).
-     */
-    getText(key: string, fallback?: string): string;
-    /**
-     * Check if a content key exists.
-     */
-    hasContent(key: string): boolean;
-};

package/lib/shared/utils/simple-content.d.ts

@@ -1,120 +0,0 @@
-/**
- * Simplified content utilities for the new LangService-only system.
- * This replaces the old reactive-content.ts with a much simpler approach.
- */
-/**
- * Base metadata for components that support reactive content.
- * Simplified version that works directly with LangService.
- */
-export interface ReactiveContentMetadata {
-    /** Static content text (takes precedence over reactive content) */
-    content?: string;
-    /** Content key for reactive content from LangService */
-    contentKey?: string;
-    /** Component class name for content lookup */
-    contentClass?: string;
-    /** Fallback text if content is not found */
-    contentFallback?: string;
-}
-/**
- * Extended metadata for text-based components with reactive content support.
- */
-export interface ReactiveTextMetadata extends ReactiveContentMetadata {
-    /** Static content text */
-    content?: string;
-    /** Content key for reactive lookup */
-    contentKey?: string;
-    /** Component class name */
-    contentClass?: string;
-    /** Fallback text */
-    contentFallback?: string;
-}
-/**
- * Extended metadata for components that support content interpolation.
- */
-export interface ReactiveContentWithInterpolation extends ReactiveContentMetadata {
-    /** Interpolation data for parameterized content */
-    contentInterpolation?: Record<string, string | number>;
-}
-/**
- * Helper function to determine if component should use reactive content.
- * @param metadata Component metadata
- * @returns True if component should use reactive content
- */
-export declare function shouldUseReactiveContent(metadata: ReactiveContentMetadata): boolean;
-/**
- * Extract content configuration from metadata.
- * @param metadata Component metadata
- * @returns Content configuration for LangService
- */
-export declare function extractContentConfig(metadata: ReactiveContentMetadata): {
-    className: string;
-    key: string;
-    fallback: string;
-};
-/**
- * Create reactive content metadata with defaults.
- * @param config Partial content configuration
- * @returns Complete reactive content metadata
- */
-export declare function createReactiveContentMetadata(config: Partial<ReactiveContentMetadata>): ReactiveContentMetadata;
-/**
- * Interpolate content string with values.
- * Replaces placeholders like {{key}} or {key} with actual values.
- *
- * @param content - Content string with placeholders
- * @param values - Values to interpolate
- * @returns Interpolated string
- *
- * @example
- * ```typescript
- * interpolateContent('Hello {{name}}!', { name: 'World' })
- * // Returns: 'Hello World!'
- * ```
- */
-export declare function interpolateContent(content: string, values?: Record<string, string | number>): string;
-/**
- * Check if component should use reactive content with interpolation.
- * @param metadata Component metadata with interpolation
- * @returns True if component should use reactive content with interpolation
- */
-export declare function shouldUseReactiveContentWithInterpolation(metadata: ReactiveContentWithInterpolation): boolean;
-/**
- * Extract content configuration with interpolation from metadata.
- * @param metadata Component metadata with interpolation
- * @returns Content configuration for LangService with interpolation data
- */
-export declare function extractContentConfigWithInterpolation(metadata: ReactiveContentWithInterpolation): {
-    className: string;
-    key: string;
-    fallback: string;
-    interpolation: Record<string, string | number>;
-};
-/**
- * Helper function to get reactive content with interpolation using LangService.
- * This provides a unified way to get reactive, interpolated content.
- *
- * @param langService - The LangService instance
- * @param metadata - Component metadata with interpolation
- * @returns Observable that emits interpolated content
- *
- * @example
- * ```typescript
- * const content$ = fromContentWithInterpolation(this.langService, {
- *   contentClass: 'MyComponent',
- *   contentKey: 'greeting',
- *   contentInterpolation: { name: 'World' }
- * });
- * ```
- */
-export declare function fromContentWithInterpolation(langService: any, // LangService type would cause circular dependency
-metadata: ReactiveContentWithInterpolation): any;
-/**
- * Helper function to get static content with interpolation.
- * This provides interpolation for static content strings.
- *
- * @param content - Static content string
- * @param interpolationData - Values to interpolate
- * @returns Interpolated string
- */
-export declare function interpolateStaticContent(content: string, interpolationData?: Record<string, string | number>): string;