smart-lifecycle 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 janmbaco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,275 @@
+# SmartComponents
+
+> A lightweight, reactive web components framework for TypeScript.  
+> Business logic stays in services. Components are pure presentation.
+
+[![npm](https://img.shields.io/npm/v/smart-lifecycle)](https://www.npmjs.com/package/smart-lifecycle)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue)](https://www.typescriptlang.org/)
+
+---
+
+## Features
+
+- **Signal-based reactivity** — Per-property observables; only affected DOM nodes update.
+- **No virtual DOM** — Surgical DOM updates via direct subscriptions.
+- **Two authoring styles** — Inline `@Smart` for quick components; class-based `@SmartRender` for full control.
+- **Native slot projection** — Named and default `<slot>` elements for composable layouts via Shadow DOM.
+- **Factory-first DI** — Explicit dependency injection through factory functions; no auto-wiring magic.
+- **Security-first expression evaluator** — Deterministic AST pipeline; no `eval` or `new Function`. Whitelisted method calls only.
+- **Tiny footprint** — Zero runtime dependencies.
+
+---
+
+## Installation
+
+```bash
+npm install smart-lifecycle
+```
+
+---
+
+## Bootstrap
+
+Call `bootstrapFramework()` once in your entry point before any component is used:
+
+```typescript
+import { bootstrapFramework, Services } from "smart-lifecycle";
+
+bootstrapFramework(Services);
+```
+
+---
+
+## Usage
+
+### Presentational Component (Slot Projection)
+
+Components that wrap child content in a styled layout using native Shadow DOM slots. No state, no logic.
+
+```typescript
+import { Smart } from "smart-lifecycle";
+
+@Smart("card-container", (ctx) => {
+  ctx.html(`
+    <div class="card">
+      <div class="card-header">
+        <slot name="header">Default Header</slot>
+      </div>
+      <div class="card-body">
+        <slot>Default Content</slot>
+      </div>
+    </div>
+  `);
+})
+export class CardContainer {}
+```
+
+```html
+<card-container>
+  <h2 slot="header">Card Title</h2>
+  <p>Card body content goes here.</p>
+</card-container>
+```
+
+---
+
+### Data Display Component (Reactive Props)
+
+Components that receive data via attributes and render it reactively.
+
+```typescript
+import { Smart } from "smart-lifecycle";
+
+@Smart("user-badge", (ctx) => {
+  ctx.props<{ name: string; role: string }>();
+
+  ctx.html(`
+    <div class="badge">
+      <span class="name">{{name}}</span>
+      <span class="role">{{role}}</span>
+    </div>
+  `);
+})
+export class UserBadge {}
+```
+
+```html
+<user-badge name="Alice" role="Engineer"></user-badge>
+```
+
+---
+
+### Interactive Component (Local State + Events)
+
+Components with local state that responds to user interactions.
+
+```typescript
+import { Smart } from "smart-lifecycle";
+
+@Smart("simple-counter", (ctx) => {
+  ctx.state({ count: 0 });
+
+  ctx.on({
+    increment() {
+      this.count++;
+    },
+    decrement() {
+      this.count--;
+    },
+    reset() {
+      this.count = 0;
+    },
+  });
+
+  ctx.html(`
+    <div class="counter">
+      <smart-action name="decrement"><button type="button">−</button></smart-action>
+      <span>{{count}}</span>
+      <smart-action name="increment"><button type="button">+</button></smart-action>
+      <smart-action name="reset"><button type="button">Reset</button></smart-action>
+    </div>
+  `);
+})
+export class SimpleCounter {}
+```
+
+---
+
+### Class-Based Component (`@SmartRender`)
+
+For components that need async initialization or a lifecycle manager to wire
+external services.
+
+```typescript
+import {
+  SmartRender,
+  SmartComponent,
+  SmartComponentInitializer,
+  SmartLifecycleManager,
+} from "smart-lifecycle";
+
+class TodoInitializer extends SmartComponentInitializer<TodoList> {
+  protected async onInitialize(component: TodoList): Promise<boolean> {
+    component.items = await fetch("/api/todos").then((r) => r.json());
+    return true;
+  }
+}
+
+class TodoLifecycle extends SmartLifecycleManager<TodoList> {
+  protected onComponentReady(component: TodoList): void {
+    this.addSubscription(
+      todoService.onUpdate$.subscribe((items) => {
+        component.items = items;
+      }),
+    );
+  }
+}
+
+@SmartRender({
+  selector: "todo-list",
+  template: `
+    <ul>
+      <smart-for from="items" let="item">
+        <li class="{{item.done ? 'done' : ''}}">{{item.text}}</li>
+      </smart-for>
+    </ul>
+  `,
+  initializer: () => new TodoInitializer(),
+  lifecycle: () => new TodoLifecycle(),
+})
+export class TodoList extends SmartComponent {
+  @Reactive accessor items: Todo[] = [];
+}
+```
+
+---
+
+## Template Syntax
+
+| Syntax              | Description                                               |
+| ------------------- | --------------------------------------------------------- |
+| `{{expression}}`    | Reactive binding — re-evaluates on property change        |
+| `[[Namespace.KEY]]` | Static constant — inlined at compile time                 |
+| `[[RULES.field]]`   | Validation rules — expands to HTML5 validation attributes |
+| `<slot>`            | Default projection slot (native Shadow DOM)               |
+| `<slot name="X">`   | Named projection slot (native Shadow DOM)                 |
+
+---
+
+## Commands
+
+| Command                    | Description                                       |
+| -------------------------- | ------------------------------------------------- |
+| `npm install`              | Install dependencies                              |
+| `npm run build:lib`        | Compile library to `dist/`                        |
+| `npm run build`            | Compile library + examples                        |
+| `npm run serve:dev`        | Start dev server on `http://localhost:3000`        |
+| `npm run serve:dist`       | Serve production build on `http://localhost:8080`  |
+| `npm test`                 | Run full test suite (unit + integration)           |
+| `npm run test:unit`        | Unit tests only                                   |
+| `npm run test:integration` | Integration tests only                            |
+| `npm run lint`             | Lint source files                                 |
+| `npm run format`           | Format source files                               |
+
+---
+
+## Interactive Playground
+
+The project ships with 13 interactive examples that run in the browser via a
+TypeScript playground with live preview. Each example has an editable code panel
+(CodeMirror) and an iframe sandbox that re-transpiles and re-executes on every
+change.
+
+### Running the playground
+
+```bash
+npm install
+npm run build        # builds library + example bundles
+npm run serve:dev    # http://localhost:3000
+```
+
+### Examples
+
+| #  | Tab              | Category      | Description                                  |
+| -- | ---------------- | ------------- | -------------------------------------------- |
+| 01 | Hello World      | Basics        | Minimal `@Smart` component                   |
+| 02 | Counter          | Basics        | Local state + `<smart-action>` events        |
+| 03 | Bindings         | Basics        | Reactive attribute and text bindings          |
+| 04 | Events           | Basics        | DOM event listeners via `@Listen`             |
+| 05 | Composition      | Data & State  | Parent → child attribute projection           |
+| 06 | Forms            | Data & State  | Two-way form bindings with validation rules   |
+| 07 | Lists            | Data & State  | `<smart-for>` iteration                       |
+| 08 | Conditionals     | Data & State  | Conditional rendering with ternary bindings   |
+| 09 | DI Injection     | Advanced      | Factory-first dependency injection            |
+| 10 | Lifecycle        | Advanced      | Initializer + lifecycle manager hooks         |
+| 11 | Real API         | Advanced      | Async data fetching with initializer          |
+| 12 | Dashboard        | Advanced      | Multi-service DI with `@Injectable` auto-wire |
+| 13 | @Smart Advanced  | Advanced      | Full `@Smart` component with services & state |
+
+### Docker deployment
+
+```bash
+docker build -t smart-components .
+docker run -p 8080:8080 smart-components
+# Playground available at http://localhost:8080
+```
+
+---
+
+## Documentation
+
+| Document                                                                      | Description                                                  |
+| ----------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| [docs/DEPENDENCY-INJECTION.md](docs/DEPENDENCY-INJECTION.md)                  | DI architecture and service registry                         |
+| [docs/SMART-VS-SMARTRENDER.md](docs/SMART-VS-SMARTRENDER.md)                  | When to use `@Smart` vs `@SmartRender`                       |
+| [docs/RENDERING-ARCHITECTURE.md](docs/RENDERING-ARCHITECTURE.md)              | Rendering pipeline overview                                  |
+| [docs/RENDERING-PIPELINE-DEEP-DIVE.md](docs/RENDERING-PIPELINE-DEEP-DIVE.md) | Expression parsing, binding resolution, reactivity internals |
+| [docs/templates.md](docs/templates.md)                                        | Template system reference                                    |
+| [docs/BABEL-TO-TYPESCRIPT-MIGRATION.md](docs/BABEL-TO-TYPESCRIPT-MIGRATION.md)| Migration from Babel to TypeScript standalone transpiler      |
+
+---
+
+## License
+
+[MIT](LICENSE) © janmbaco

package/dist/behaviors/initializer-factory.d.ts

@@ -0,0 +1,101 @@
+import type { SmartComponent } from '../core/smart-component.js';
+import type { SmartComponentInitializer } from './initializer.base.js';
+import type { IServiceProvider } from '../providers/service-provider.interface.js';
+/**
+ * Defines the responsibility of creating initializer instances.
+ */
+export interface IInitializerFactory {
+    /**
+     * Creates an initializer instance for the given class.
+     *
+     * @param initializerClass - Initializer class constructor
+     * @returns Fully initialized initializer instance
+     * @throws Error if required dependencies are not available
+     */
+    create<T extends SmartComponent>(initializerClass: new (...args: unknown[]) => SmartComponentInitializer<T>): SmartComponentInitializer<T>;
+    /**
+     * Registers a custom factory function for a specific initializer type.
+     *
+     * @param initializerClass - Initializer class to register
+     * @param factoryFn - Factory function that creates the instance
+     *
+     * @example
+     * ```typescript
+     * factory.registerFactory(CustomInitializer, (resolver) => {
+     *   const http = resolver.get('IHttpService');
+     *   return new CustomInitializer(http);
+     * });
+     * ```
+     */
+    registerFactory<T extends SmartComponent>(initializerClass: new (...args: unknown[]) => SmartComponentInitializer<T>, factoryFn: (serviceProvider: IServiceProvider) => SmartComponentInitializer<T>): void;
+}
+/**
+ * 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 declare class InitializerFactory implements IInitializerFactory {
+    private readonly serviceProvider;
+    private readonly factories;
+    /**
+     * Initializes a new instance of InitializerFactory.
+     *
+     * @param serviceProvider - Service provider for dependency resolution
+     * @throws Error if serviceProvider is null or undefined
+     */
+    constructor(serviceProvider: IServiceProvider);
+    registerFactory<T extends SmartComponent>(initializerClass: new (...args: unknown[]) => SmartComponentInitializer<T>, factoryFn: (serviceProvider: IServiceProvider) => SmartComponentInitializer<T>): void;
+    create<T extends SmartComponent>(initializerClass: new (...args: unknown[]) => SmartComponentInitializer<T>): SmartComponentInitializer<T>;
+    /**
+     * 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
+     */
+    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 - Initializer instance
+     * @param initializerClass - Initializer class constructor
+     */
+    private applyDependencyInjection;
+}
+//# sourceMappingURL=initializer-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initializer-factory.d.ts","sourceRoot":"","sources":["../../src/behaviors/initializer-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAGnF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAC7B,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,yBAAyB,CAAC,CAAC,CAAC,GACzE,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CAAC,SAAS,cAAc,EACtC,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,yBAAyB,CAAC,CAAC,CAAC,EAC1E,SAAS,EAAE,CAAC,eAAe,EAAE,gBAAgB,KAAK,yBAAyB,CAAC,CAAC,CAAC,GAC7E,IAAI,CAAC;CACT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAShD,OAAO,CAAC,QAAQ,CAAC,eAAe;IAR5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+F;IAEzH;;;;;OAKG;gBAC0B,eAAe,EAAE,gBAAgB;IAM9D,eAAe,CAAC,CAAC,SAAS,cAAc,EACtC,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,yBAAyB,CAAC,CAAC,CAAC,EAC1E,SAAS,EAAE,CAAC,eAAe,EAAE,gBAAgB,KAAK,yBAAyB,CAAC,CAAC,CAAC,GAC7E,IAAI;IAWP,MAAM,CAAC,CAAC,SAAS,cAAc,EAC7B,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,yBAAyB,CAAC,CAAC,CAAC,GACzE,yBAAyB,CAAC,CAAC,CAAC;IAuC/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,uBAAuB;IAwD/B;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IAWd;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;CAejC"}

package/dist/behaviors/initializer-factory.js

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

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

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

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

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

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

@@ -0,0 +1,21 @@
+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.d.ts.map