smart-lifecycle 0.1.1 → 0.2.1

package/dist/behaviors/initializer-factory.js

@@ -1,183 +0,0 @@
-import { applyInjection } from './injection-helper.js';
-/**
- * Implements the responsibility of creating initializer instances with auto-discovery.
- *
- * @description
- * Centralizes initializer creation logic following the Factory Pattern.
- * Automatically discovers and resolves common framework dependencies.
- * Uses ServiceProvider to resolve dependencies and allows registration of
- * custom factory functions for complex cases.
- *
- * @architecture
- * **Design Decisions:**
- * - Auto-discovery for common dependency patterns (0-4 params)
- * - Strategy pattern via registerFactory for custom cases
- * - Resolves dependencies from ServiceProvider (DIP)
- * - Throws clear errors when dependencies are missing
- * - Allows zero-config for initializers without dependencies
- */
-export class InitializerFactory {
-    serviceProvider;
-    factories = new Map();
-    /**
-     * Initializes a new instance of InitializerFactory.
-     *
-     * @param serviceProvider - Service provider for dependency resolution
-     * @throws Error if serviceProvider is null or undefined
-     */
-    constructor(serviceProvider) {
-        this.serviceProvider = serviceProvider;
-        if (!serviceProvider) {
-            throw new Error('Service provider is required');
-        }
-    }
-    registerFactory(initializerClass, factoryFn) {
-        if (!initializerClass) {
-            throw new Error('Initializer class is required');
-        }
-        if (!factoryFn) {
-            throw new Error('Factory function is required');
-        }
-        this.factories.set(initializerClass, factoryFn);
-    }
-    create(initializerClass) {
-        if (!initializerClass) {
-            throw new Error('Initializer class is required');
-        }
-        // Check if custom factory is registered
-        const customFactory = this.factories.get(initializerClass);
-        if (customFactory) {
-            const instance = customFactory(this.serviceProvider);
-            this.applyDependencyInjection(instance, initializerClass);
-            return instance;
-        }
-        // Auto-discovery: Try to resolve common framework dependencies
-        let instance;
-        try {
-            instance = this.createWithAutodiscovery(initializerClass);
-        }
-        catch (error) {
-            // Fallback: try parameterless constructor
-            try {
-                instance = new initializerClass();
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (_fallbackError) {
-                const originalMessage = error instanceof Error ? error.message : String(error);
-                throw new Error(`Cannot create initializer ${initializerClass.name}. ` +
-                    `Dependencies could not be auto-discovered. ` +
-                    `Register a factory function using registerFactory() if it requires custom dependencies. ` +
-                    `Original error: ${originalMessage}`);
-            }
-        }
-        // Apply explicit dependency injection if static inject property exists
-        this.applyDependencyInjection(instance, initializerClass);
-        return instance;
-    }
-    /**
-     * Attempts to create initializer with auto-discovered dependencies.
-     *
-     * @description
-     * Tries common dependency patterns for initializers:
-     * - 0 params: new Initializer()
-     * - 1 param: new Initializer(IHttpService | ILogger | custom service)
-     * - 2 params: new Initializer(service1, service2)
-     * - etc.
-     *
-     * Common initializer dependencies:
-     * - HTTP services for data fetching
-     * - Logger services for initialization logging
-     * - Configuration services
-     * - User-defined application services
-     *
-     * @param initializerClass - Initializer class constructor
-     * @returns Instantiated initializer
-     * @throws Error if dependencies cannot be resolved
-     */
-    createWithAutodiscovery(initializerClass) {
-        // Try common dependency patterns in order of likelihood
-        const patterns = [
-            // Pattern 1: No dependencies (most common for simple initializers)
-            () => new initializerClass(),
-            // Pattern 2: Single service dependency
-            // Try common service tokens
-            () => {
-                const service = this.tryGet('IHttpService') ||
-                    this.tryGet('ILogger') ||
-                    this.tryGet('IConfigService');
-                if (service) {
-                    return new initializerClass(service);
-                }
-                throw new Error('No single service found');
-            },
-            // Pattern 3: HTTP + Logger (common pattern)
-            () => {
-                const http = this.tryGet('IHttpService');
-                const logger = this.tryGet('ILogger');
-                if (http && logger) {
-                    return new initializerClass(http, logger);
-                }
-                throw new Error('HTTP + Logger not found');
-            },
-            // Pattern 4: HTTP + Logger + Config
-            () => {
-                const http = this.tryGet('IHttpService');
-                const logger = this.tryGet('ILogger');
-                const config = this.tryGet('IConfigService');
-                if (http && logger && config) {
-                    return new initializerClass(http, logger, config);
-                }
-                throw new Error('HTTP + Logger + Config not found');
-            }
-        ];
-        let lastError = null;
-        for (const pattern of patterns) {
-            try {
-                return pattern();
-            }
-            catch (error) {
-                lastError = (error instanceof Error ? error : new Error(String(error)));
-                // Continue to next pattern
-            }
-        }
-        throw lastError || new Error('All dependency patterns failed');
-    }
-    /**
-     * Attempts to get a service from the provider without throwing.
-     *
-     * @param token - Service token
-     * @returns Service instance or undefined
-     */
-    tryGet(token) {
-        try {
-            if (this.serviceProvider.has(token)) {
-                return this.serviceProvider.get(token);
-            }
-            return undefined;
-        }
-        catch {
-            return undefined;
-        }
-    }
-    /**
-     * Applies explicit dependency injection using static inject property.
-     *
-     * @description
-     * If the class defines a static inject property, resolves the declared
-     * dependencies and assigns them to the instance properties.
-     *
-     * @param instance - Initializer instance
-     * @param initializerClass - Initializer class constructor
-     */
-    applyDependencyInjection(instance, initializerClass) {
-        const injectMap = initializerClass.inject;
-        if (!injectMap) {
-            return;
-        }
-        applyInjection(instance, injectMap, this.serviceProvider, {
-            kind: 'Initializer',
-            name: initializerClass.name
-        });
-    }
-}
-//# sourceMappingURL=initializer-factory.js.map

package/dist/behaviors/initializer-factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initializer-factory.js","sourceRoot":"","sources":["../../src/behaviors/initializer-factory.ts"],"names":[],"mappings":"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"}

package/dist/behaviors/initializer.base.d.ts

@@ -1,21 +0,0 @@
-import { IComponentInitializer } from '../types/interfaces.js';
-/**
- * Base class for component initializers
- * Handles initial setup and data loading for components
- */
-export declare abstract class SmartComponentInitializer<TComponent> implements IComponentInitializer<TComponent> {
-    /**
-     * Initializes the component with initial data and configuration
-     *
-     * @param component - Component instance to initialize
-     * @returns true if initialization succeeded, false if failed
-     * @throws Never - always catches and logs errors
-     */
-    initialize(component: TComponent): Promise<boolean>;
-    /**
-     * Hook for custom initialization logic
-     * Return true if initialization was successful, false otherwise
-     */
-    protected abstract onInitialize(component: TComponent): boolean | Promise<boolean>;
-}
-//# sourceMappingURL=initializer.base.d.ts.map

package/dist/behaviors/initializer.base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initializer.base.d.ts","sourceRoot":"","sources":["../../src/behaviors/initializer.base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,8BAAsB,yBAAyB,CAAC,UAAU,CAAE,YAAW,qBAAqB,CAAC,UAAU,CAAC;IACtG;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBzD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CACnF"}

package/dist/behaviors/initializer.base.js

@@ -1,32 +0,0 @@
-/**
- * Base class for component initializers
- * Handles initial setup and data loading for components
- */
-export class SmartComponentInitializer {
-    /**
-     * Initializes the component with initial data and configuration
-     *
-     * @param component - Component instance to initialize
-     * @returns true if initialization succeeded, false if failed
-     * @throws Never - always catches and logs errors
-     */
-    async initialize(component) {
-        if (!component) {
-            console.error('[SmartComponentInitializer] Component is required');
-            return false;
-        }
-        try {
-            return await this.onInitialize(component);
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                console.error('[SmartComponentInitializer] Initialization failed:', error.message, error);
-            }
-            else {
-                console.error('[SmartComponentInitializer] Initialization failed with unknown error:', error);
-            }
-            return false;
-        }
-    }
-}
-//# sourceMappingURL=initializer.base.js.map

package/dist/behaviors/initializer.base.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initializer.base.js","sourceRoot":"","sources":["../../src/behaviors/initializer.base.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAgB,yBAAyB;IAC7C;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,SAAqB;QACpC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACnE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,oDAAoD,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5F,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,uEAAuE,EAAE,KAAK,CAAC,CAAC;YAChG,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CAOF"}

package/dist/behaviors/initializer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initializer.d.ts","sourceRoot":"","sources":["../../src/behaviors/initializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,8BAAsB,yBAAyB,CAC7C,UAAU,CACV,YAAW,qBAAqB,CAAC,UAAU,CAAC;IAC5C;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAazD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC7B,SAAS,EAAE,UAAU,GACpB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAC9B"}

package/dist/behaviors/initializer.interface.d.ts

@@ -1,2 +0,0 @@
-export { IComponentInitializer } from '../types/interfaces.js';
-//# sourceMappingURL=initializer.interface.d.ts.map

package/dist/behaviors/initializer.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initializer.interface.d.ts","sourceRoot":"","sources":["../../src/behaviors/initializer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/behaviors/initializer.interface.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=initializer.interface.js.map

package/dist/behaviors/initializer.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initializer.interface.js","sourceRoot":"","sources":["../../src/behaviors/initializer.interface.ts"],"names":[],"mappings":""}

package/dist/behaviors/initializer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initializer.js","sourceRoot":"","sources":["../../src/behaviors/initializer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAgB,yBAAyB;IAG7C;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,SAAqB;QACpC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,KAAK,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CASF"}

package/dist/behaviors/injection-helper.d.ts

@@ -1,90 +0,0 @@
-import type { IServiceProvider, ServiceToken } from '../providers/service-provider.interface.js';
-export type { ServiceToken } from '../providers/service-provider.interface.js';
-/**
- * Injection map for declaring dependencies explicitly.
- * Maps property names to service tokens.
- *
- * @example
- * ```typescript
- * const inject: InjectMap = {
- *   logger: Logger,
- *   api: 'IApiClient',
- *   config: Symbol.for('IConfig')
- * };
- * ```
- */
-export type InjectMap = Record<string, ServiceToken>;
-/**
- * Context information for error messages.
- */
-export interface InjectionContext {
-    /**
-     * Type of the entity being injected (Initializer, Lifecycle, Effect)
-     */
-    kind: 'Initializer' | 'Lifecycle' | 'Effect';
-    /**
-     * Name of the class or effect
-     */
-    name: string;
-    /**
-     * Component selector (optional)
-     */
-    componentName?: string;
-}
-/**
- * Applies dependency injection to an instance using property assignment.
- *
- * @description
- * Resolves services from the provider and assigns them to instance properties.
- * User declares properties with `declare` keyword for IntelliSense:
- * ```typescript
- * class MyLifecycle extends SmartLifecycleManager {
- *   static inject = { logger: Logger, api: ApiService };
- *   declare logger: Logger;
- *   declare api: ApiService;
- * }
- * ```
- *
- * @param instance - Target instance to inject dependencies into
- * @param injectMap - Map of property names to service tokens
- * @param provider - Service provider for dependency resolution
- * @param context - Context information for error messages
- * @throws Error if a required service is not registered
- *
- * @example
- * ```typescript
- * const lifecycle = new MyLifecycle();
- * applyInjection(lifecycle, MyLifecycle.inject, Services, {
- *   kind: 'Lifecycle',
- *   name: 'MyLifecycle',
- *   componentName: 'my-component'
- * });
- * ```
- */
-export declare function applyInjection(instance: unknown, injectMap: InjectMap | undefined, provider: IServiceProvider, context: InjectionContext): void;
-/**
- * Resolves dependencies from inject map and returns them as an object.
- *
- * @description
- * Used for effects and other scenarios where dependencies are passed
- * as function parameters instead of property assignment.
- *
- * @param injectMap - Map of property names to service tokens
- * @param provider - Service provider for dependency resolution
- * @param context - Context information for error messages
- * @returns Object with resolved dependencies
- * @throws Error if a required service is not registered
- *
- * @example
- * ```typescript
- * const deps = resolveDeps(
- *   { logger: Logger, api: ApiService },
- *   Services,
- *   { kind: 'Effect', name: 'loadData' }
- * );
- * // deps = { logger: LoggerInstance, api: ApiServiceInstance }
- * effectFn(component, deps);
- * ```
- */
-export declare function resolveDeps(injectMap: InjectMap | undefined, provider: IServiceProvider, context: InjectionContext): Record<string, unknown>;
-//# sourceMappingURL=injection-helper.d.ts.map

package/dist/behaviors/injection-helper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"injection-helper.d.ts","sourceRoot":"","sources":["../../src/behaviors/injection-helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AACjG,YAAY,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAgCN;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB"}

package/dist/behaviors/injection-helper.js

@@ -1,136 +0,0 @@
-/**
- * Applies dependency injection to an instance using property assignment.
- *
- * @description
- * Resolves services from the provider and assigns them to instance properties.
- * User declares properties with `declare` keyword for IntelliSense:
- * ```typescript
- * class MyLifecycle extends SmartLifecycleManager {
- *   static inject = { logger: Logger, api: ApiService };
- *   declare logger: Logger;
- *   declare api: ApiService;
- * }
- * ```
- *
- * @param instance - Target instance to inject dependencies into
- * @param injectMap - Map of property names to service tokens
- * @param provider - Service provider for dependency resolution
- * @param context - Context information for error messages
- * @throws Error if a required service is not registered
- *
- * @example
- * ```typescript
- * const lifecycle = new MyLifecycle();
- * applyInjection(lifecycle, MyLifecycle.inject, Services, {
- *   kind: 'Lifecycle',
- *   name: 'MyLifecycle',
- *   componentName: 'my-component'
- * });
- * ```
- */
-export function applyInjection(instance, injectMap, provider, context) {
-    if (!injectMap) {
-        return;
-    }
-    if (!instance || typeof instance !== 'object') {
-        throw new Error(`[DI] Cannot apply injection: instance is null or undefined`);
-    }
-    if (!provider) {
-        throw new Error(`[DI] Cannot apply injection: provider is null or undefined`);
-    }
-    const target = instance;
-    for (const [propName, token] of Object.entries(injectMap)) {
-        try {
-            const service = provider.get(token);
-            target[propName] = service;
-        }
-        catch (error) {
-            const tokenName = getTokenName(token);
-            const contextInfo = formatContext(context);
-            throw new Error(`[DI] Missing dependency for ${context.kind} '${context.name}'.${propName} -> Token '${tokenName}'\n` +
-                `${contextInfo}\n` +
-                `Solution: Register the service in your Composition Root:\n` +
-                `  Services.register(${tokenName}, () => new ${tokenName}());\n` +
-                `Original error: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-}
-/**
- * Resolves dependencies from inject map and returns them as an object.
- *
- * @description
- * Used for effects and other scenarios where dependencies are passed
- * as function parameters instead of property assignment.
- *
- * @param injectMap - Map of property names to service tokens
- * @param provider - Service provider for dependency resolution
- * @param context - Context information for error messages
- * @returns Object with resolved dependencies
- * @throws Error if a required service is not registered
- *
- * @example
- * ```typescript
- * const deps = resolveDeps(
- *   { logger: Logger, api: ApiService },
- *   Services,
- *   { kind: 'Effect', name: 'loadData' }
- * );
- * // deps = { logger: LoggerInstance, api: ApiServiceInstance }
- * effectFn(component, deps);
- * ```
- */
-export function resolveDeps(injectMap, provider, context) {
-    if (!injectMap) {
-        return {};
-    }
-    if (!provider) {
-        throw new Error(`[DI] Cannot resolve dependencies: provider is null or undefined`);
-    }
-    const resolved = {};
-    for (const [propName, token] of Object.entries(injectMap)) {
-        try {
-            resolved[propName] = provider.get(token);
-        }
-        catch (error) {
-            const tokenName = getTokenName(token);
-            const contextInfo = formatContext(context);
-            throw new Error(`[DI] Missing dependency for ${context.kind} '${context.name}'.${propName} -> Token '${tokenName}'\n` +
-                `${contextInfo}\n` +
-                `Solution: Register the service in your Composition Root:\n` +
-                `  Services.register(${tokenName}, () => new ${tokenName}());\n` +
-                `Original error: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    return resolved;
-}
-/**
- * Gets a human-readable name from a service token.
- *
- * @param token - Service token (class, string, or symbol)
- * @returns Token name for display
- */
-function getTokenName(token) {
-    if (typeof token === 'string') {
-        return token;
-    }
-    if (typeof token === 'symbol') {
-        return token.toString();
-    }
-    // Constructor function
-    return token.name || token.toString();
-}
-/**
- * Formats context information for error messages.
- *
- * @param context - Injection context
- * @returns Formatted context string
- */
-function formatContext(context) {
-    const parts = [];
-    if (context.componentName) {
-        parts.push(`Component: <${context.componentName}>`);
-    }
-    parts.push(`${context.kind}: ${context.name}`);
-    return `Context: ${parts.join(' | ')}`;
-}
-//# sourceMappingURL=injection-helper.js.map

package/dist/behaviors/injection-helper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"injection-helper.js","sourceRoot":"","sources":["../../src/behaviors/injection-helper.ts"],"names":[],"mappings":"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"}

package/dist/behaviors/lifecycle-manager-factory.d.ts

@@ -1,126 +0,0 @@
-import type { SmartComponent } from '../core/smart-component.js';
-import type { SmartLifecycleManager } from './lifecycle-manager.base.js';
-import type { IServiceProvider } from '../providers/service-provider.interface.js';
-import type { IHostResolver } from '../rendering/host-resolver/host-resolver.interface.js';
-import type { ITemplateCompiler } from '../rendering/templates/template-compiler.interface.js';
-import { type ServiceToken } from './injection-helper.js';
-/**
- * Constructor type for lifecycle managers supporting common dependency patterns.
- */
-interface LifecycleCtor<T extends SmartComponent> {
-    new (): SmartLifecycleManager<T>;
-    new (hostResolver: IHostResolver): SmartLifecycleManager<T>;
-    new (hostResolver: IHostResolver, templateCompiler: ITemplateCompiler): SmartLifecycleManager<T>;
-    new (...args: unknown[]): SmartLifecycleManager<T>;
-}
-/**
- * Defines the responsibility of creating lifecycle manager instances.
- */
-export interface ILifecycleManagerFactory {
-    /**
-     * Creates a lifecycle manager instance for the given class.
-     *
-     * @param lifecycleClass - Lifecycle manager class constructor
-     * @returns Fully initialized lifecycle manager instance
-     * @throws Error if required dependencies are not available
-     */
-    create<T extends SmartComponent>(lifecycleClass: LifecycleCtor<T>): SmartLifecycleManager<T>;
-    /**
-     * Registers a custom factory function for a specific lifecycle manager type.
-     *
-     * @param lifecycleClass - Lifecycle manager class to register
-     * @param factoryFn - Factory function that creates the instance
-     *
-     * @example
-     * ```typescript
-     * factory.registerFactory(CustomLifecycleManager, (resolver) => {
-     *   const dep1 = resolver.get('IDependency1');
-     *   const dep2 = resolver.get('IDependency2');
-     *   return new CustomLifecycleManager(dep1, dep2);
-     * });
-     * ```
-     */
-    registerFactory(token: ServiceToken, factoryFn: (serviceProvider: IServiceProvider) => SmartLifecycleManager<unknown>): void;
-}
-/**
- * Implements the responsibility of creating lifecycle manager instances with proper DI.
- *
- * @description
- * Centralizes lifecycle manager creation logic following the Factory Pattern.
- * Uses ServiceProvider to resolve dependencies and allows registration of
- * custom factory functions for extensibility.
- *
- * @architecture
- * **Design Decisions:**
- * - Uses strategy pattern via registerFactory for extensibility
- * - Resolves dependencies from ServiceProvider (DIP)
- * - Throws clear errors when dependencies are missing
- * - Allows zero-config for lifecycle managers without dependencies
- */
-export declare class LifecycleManagerFactory implements ILifecycleManagerFactory {
-    private readonly serviceProvider;
-    private readonly factories;
-    /**
-     * Initializes a new instance of LifecycleManagerFactory.
-     *
-     * @param serviceProvider - Service provider for dependency resolution
-     * @throws Error if serviceProvider is null or undefined
-     */
-    constructor(serviceProvider: IServiceProvider);
-    registerFactory(token: ServiceToken, factoryFn: (serviceProvider: IServiceProvider) => SmartLifecycleManager<unknown>): void;
-    create<T extends SmartComponent>(lifecycleClass: LifecycleCtor<T>): SmartLifecycleManager<T>;
-    /**
-     * Attempts to create lifecycle manager with auto-discovered dependencies.
-     *
-     * @description
-     * Tries common dependency patterns:
-     * - 0 params: new Lifecycle()
-     * - 1 param: new Lifecycle(IHostResolver)
-     * - 2 params: new Lifecycle(IHostResolver, ITemplateCompiler)
-     * - 3 params: new Lifecycle(IHostResolver, ITemplateCompiler, IDomAdapter)
-     * - 4 params: new Lifecycle(IHostResolver, ITemplateCompiler, IDomAdapter, IBindingResolver)
-     *
-     * @param lifecycleClass - Lifecycle manager class constructor
-     * @returns Instantiated lifecycle manager
-     * @throws Error if dependencies cannot be resolved
-     */
-    private createWithAutodiscovery;
-    /**
-     * Attempts to get a service from the provider without throwing.
-     *
-     * @param token - Service token
-     * @returns Service instance or undefined
-     */
-    private tryGet;
-    /**
-     * Applies explicit dependency injection using static inject property.
-     *
-     * @description
-     * If the class defines a static inject property, resolves the declared
-     * dependencies and assigns them to the instance properties.
-     *
-     * @param instance - Lifecycle manager instance
-     * @param lifecycleClass - Lifecycle manager class constructor
-     */
-    private applyDependencyInjection;
-}
-/**
- * Registers standard SmartComponents lifecycle managers in the factory.
- *
- * @description
- * This function is called during bootstrap to register the built-in
- * lifecycle managers (SmartFor, SmartAction, etc.) with their dependency
- * resolution logic.
- *
- * @param factory - Lifecycle manager factory instance
- *
- * @example
- * ```typescript
- * const factory = new LifecycleManagerFactory(Services);
- * registerStandardLifecycleManagers(factory);
- * Services.register('ILifecycleManagerFactory', () => factory);
- * ```
- */
-export declare function registerStandardLifecycleManagers(factory: ILifecycleManagerFactory): void;
-export {};
-//# sourceMappingURL=lifecycle-manager-factory.d.ts.map

package/dist/behaviors/lifecycle-manager-factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lifecycle-manager-factory.d.ts","sourceRoot":"","sources":["../../src/behaviors/lifecycle-manager-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAE/F,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1F;;GAEG;AACH,UAAU,aAAa,CAAC,CAAC,SAAS,cAAc;IAC9C,QAAQ,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACjC,KAAK,YAAY,EAAE,aAAa,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC5D,KAAK,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACjG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAC7B,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,GAC/B,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,eAAe,CACb,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,CAAC,eAAe,EAAE,gBAAgB,KAAK,qBAAqB,CAAC,OAAO,CAAC,GAC/E,IAAI,CAAC;CACT;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAwB,YAAW,wBAAwB;IAS1D,OAAO,CAAC,QAAQ,CAAC,eAAe;IAR5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2F;IAErH;;;;;OAKG;gBAC0B,eAAe,EAAE,gBAAgB;IAM9D,eAAe,CACb,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,CAAC,eAAe,EAAE,gBAAgB,KAAK,qBAAqB,CAAC,OAAO,CAAC,GAC/E,IAAI;IAWP,MAAM,CAAC,CAAC,SAAS,cAAc,EAC7B,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,GAC/B,qBAAqB,CAAC,CAAC,CAAC;IAuC3B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IAWd;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;CAejC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAsBzF"}