smart-lifecycle 0.1.1

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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

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

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

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

package/dist/behaviors/initializer.js

@@ -0,0 +1,26 @@
+/**
+ * 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) {
+            return false;
+        }
+        try {
+            return await this.onInitialize(component);
+        }
+        catch (error) {
+            void error;
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=initializer.js.map

package/dist/behaviors/initializer.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,90 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,136 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,126 @@
+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

@@ -0,0 +1 @@
+{"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"}

package/dist/behaviors/lifecycle-manager-factory.js

@@ -0,0 +1,211 @@
+import { applyInjection } from './injection-helper.js';
+/**
+ * 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 class LifecycleManagerFactory {
+    serviceProvider;
+    factories = new Map();
+    /**
+     * Initializes a new instance of LifecycleManagerFactory.
+     *
+     * @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(token, factoryFn) {
+        if (!token) {
+            throw new Error('Lifecycle class token is required');
+        }
+        if (!factoryFn) {
+            throw new Error('Factory function is required');
+        }
+        this.factories.set(token, factoryFn);
+    }
+    create(lifecycleClass) {
+        if (!lifecycleClass) {
+            throw new Error('Lifecycle class is required');
+        }
+        // Check if custom factory is registered
+        const customFactory = this.factories.get(lifecycleClass);
+        if (customFactory) {
+            const instance = customFactory(this.serviceProvider);
+            this.applyDependencyInjection(instance, lifecycleClass);
+            return instance;
+        }
+        // Auto-discovery: Try to resolve common framework dependencies
+        let instance;
+        try {
+            instance = this.createWithAutodiscovery(lifecycleClass);
+        }
+        catch (error) {
+            // Fallback: try parameterless constructor
+            try {
+                instance = new lifecycleClass();
+                // 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 lifecycle manager ${lifecycleClass.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, lifecycleClass);
+        return instance;
+    }
+    /**
+     * 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
+     */
+    createWithAutodiscovery(lifecycleClass) {
+        // Try common dependency patterns in order of likelihood
+        const patterns = [
+            // Pattern 1: No dependencies
+            () => new lifecycleClass(),
+            // Pattern 2: IHostResolver only (most common)
+            () => {
+                const hostResolver = this.tryGet('IHostResolver');
+                return new lifecycleClass(hostResolver);
+            },
+            // Pattern 3: IHostResolver + ITemplateCompiler (SmartFor)
+            () => {
+                const hostResolver = this.tryGet('IHostResolver');
+                const templateCompiler = this.tryGet('ITemplateCompiler');
+                return new lifecycleClass(hostResolver, templateCompiler);
+            },
+            // Pattern 4: IHostResolver + ITemplateCompiler + IDomAdapter
+            () => {
+                const hostResolver = this.tryGet('IHostResolver');
+                const templateCompiler = this.tryGet('ITemplateCompiler');
+                const domAdapter = this.tryGet('IDomAdapter');
+                return new lifecycleClass(hostResolver, templateCompiler, domAdapter);
+            },
+            // Pattern 5: All framework services
+            () => {
+                const hostResolver = this.tryGet('IHostResolver');
+                const templateCompiler = this.tryGet('ITemplateCompiler');
+                const domAdapter = this.tryGet('IDomAdapter');
+                const bindingResolver = this.tryGet('IBindingResolver');
+                return new lifecycleClass(hostResolver, templateCompiler, domAdapter, bindingResolver);
+            }
+        ];
+        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 - Lifecycle manager instance
+     * @param lifecycleClass - Lifecycle manager class constructor
+     */
+    applyDependencyInjection(instance, lifecycleClass) {
+        const injectMap = lifecycleClass.inject;
+        if (!injectMap) {
+            return;
+        }
+        applyInjection(instance, injectMap, this.serviceProvider, {
+            kind: 'Lifecycle',
+            name: lifecycleClass.name
+        });
+    }
+}
+/**
+ * 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 function registerStandardLifecycleManagers(factory) {
+    // Import lifecycle managers lazily to avoid circular dependencies
+    import('../components/smart-for/smart-for.lifecycle-manager.js').then(({ SmartForLifecycleManager }) => {
+        factory.registerFactory(SmartForLifecycleManager, (provider) => {
+            const hostResolver = provider.get('IHostResolver');
+            const templateCompiler = provider.get('ITemplateCompiler');
+            const hostProjectionRegistry = provider.get('IHostProjectionRegistry');
+            return new SmartForLifecycleManager(hostResolver, templateCompiler, hostProjectionRegistry);
+        });
+    }).catch(() => {
+        // Lifecycle manager not available - skip
+    });
+    import('../components/smart-select/smart-select.lifecycle-manager.js').then(({ SmartSelectLifecycleManager }) => {
+        factory.registerFactory(SmartSelectLifecycleManager, (provider) => {
+            const hostResolver = provider.get('IHostResolver');
+            const hostProjectionRegistry = provider.get('IHostProjectionRegistry');
+            return new SmartSelectLifecycleManager(hostResolver, hostProjectionRegistry);
+        });
+    }).catch(() => {
+        // Lifecycle manager not available - skip
+    });
+}
+//# sourceMappingURL=lifecycle-manager-factory.js.map

package/dist/behaviors/lifecycle-manager-factory.js.map

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