smart-lifecycle 0.1.1

package/dist/decorators/smart/smart-component-factory.js

@@ -0,0 +1,271 @@
+import { SmartComponent } from "../../core/smart-component.js";
+import { SmartComponentInitializer } from "../../behaviors/initializer.js";
+import { SmartLifecycleManager } from "../../behaviors/lifecycle-manager.js";
+import { Services } from "../../providers/service-provider.js";
+/**
+ * Tracks which state properties are accessed during a computed getter invocation.
+ * Set to a `Set<string>` while a getter is being profiled for dependencies; null otherwise.
+ */
+let activeComputedTracker = null;
+/**
+ * Implements the responsibility of building the dynamic class hierarchy for a `@Smart` component.
+ *
+ * @description
+ * Single composition-root implementation of `ISmartComponentFactory`.
+ * Contains all dynamic class construction logic for enhanced base class,
+ * initializer, and lifecycle manager — previously spread across three utility modules.
+ *
+ * Registered in the service container under `'ISmartComponentFactory'` by
+ * `bootstrapFramework`, so the `@Smart` decorator never references concrete construction directly.
+ */
+export class DefaultSmartComponentFactory {
+    /**
+     * Resolves dependencies from a factory, returning a shallow copy or empty object if no factory provided.
+     *
+     * @param createDeps - Optional factory that creates dependency values for current execution
+     * @returns Shallow copy of the dependency bag, or empty object
+     * @throws Error if the factory does not return an object
+     */
+    resolveDeps(createDeps) {
+        if (!createDeps)
+            return {};
+        const deps = createDeps();
+        if (!deps || typeof deps !== "object")
+            throw new Error("[DI] createDeps must return an object");
+        return { ...deps };
+    }
+    /**
+     * Captures the configuration produced by executing the setup function against an InlineContext.
+     *
+     * @param setup - Setup function receiving InlineContext
+     * @returns Captured configuration object
+     * @throws Error if setup is null or undefined
+     */
+    captureConfig(setup) {
+        if (!setup)
+            throw new Error("setup is required");
+        const config = {};
+        const context = {
+            state(initial) {
+                config.state = initial;
+            },
+            on(handlers) {
+                config.methods = handlers;
+            },
+            computed(computed) {
+                config.computed = computed;
+            },
+            lifecycle(hooks, createDeps) {
+                config.lifecycle = {
+                    onInit: hooks.onInit,
+                    onDestroy: hooks.onDestroy,
+                    createDeps: createDeps,
+                };
+            },
+            rules(rules) {
+                config.rules = rules;
+            },
+            html(template) {
+                config.template = template;
+            },
+            skeleton(template) {
+                config.skeleton = template;
+            },
+            errorTemplate(template) {
+                config.errorTemplate = template;
+            },
+            css(styles) {
+                config.styles = styles;
+            },
+            constants(registry) {
+                config.constants = registry;
+            },
+            initializer(fn, createDeps) {
+                config.initializer = fn;
+                config.initializerCreateDeps = createDeps;
+            },
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            props() {
+                config.propsTyped = true;
+            },
+            ref(name) {
+                if (!config.refs) {
+                    config.refs = new Set();
+                }
+                config.refs.add(name);
+            },
+        };
+        setup(context);
+        return config;
+    }
+    /**
+     * Creates the enhanced SmartComponent class with reactive state and handlers from the setup config.
+     *
+     * @param target - Original class decorated by `@Smart`
+     * @param config - Captured setup configuration
+     * @returns Constructor extending SmartComponent
+     * @throws Error if target or config is null or undefined
+     */
+    createEnhancedClass(target, config) {
+        if (!target)
+            throw new Error("target is required");
+        if (!config)
+            throw new Error("config is required");
+        class Enhanced extends SmartComponent {
+            refs = {};
+            props = {};
+            constructor() {
+                super();
+                if (config.state) {
+                    Object.keys(config.state).forEach((key) => {
+                        const initialValue = config.state[key];
+                        let value = initialValue;
+                        Object.defineProperty(this, key, {
+                            get() {
+                                if (activeComputedTracker)
+                                    activeComputedTracker.add(key);
+                                return value;
+                            },
+                            set(newValue) {
+                                if (value !== newValue) {
+                                    value = newValue;
+                                    this.getPropertyObservable(key).notify();
+                                }
+                            },
+                            enumerable: true,
+                            configurable: true,
+                        });
+                    });
+                }
+                if (config.computed) {
+                    Object.keys(config.computed).forEach((key) => {
+                        const getter = config.computed[key];
+                        Object.defineProperty(this, key, {
+                            get() {
+                                return getter.call(this);
+                            },
+                            enumerable: true,
+                            configurable: true,
+                        });
+                        const deps = new Set();
+                        activeComputedTracker = deps;
+                        try {
+                            getter.call(this);
+                        }
+                        finally {
+                            activeComputedTracker = null;
+                        }
+                        deps.forEach((dep) => {
+                            this
+                                .getPropertyObservable(dep)
+                                .subscribe(() => {
+                                this.getPropertyObservable(key).notify();
+                            });
+                        });
+                    });
+                }
+                if (config.rules) {
+                    this.rules =
+                        config.rules;
+                }
+            }
+        }
+        if (config.methods) {
+            Object.keys(config.methods).forEach((key) => {
+                Enhanced.prototype[key] = config.methods[key];
+                Services.get("IListenerMetadataRegistry").register(Enhanced.prototype, {
+                    methodName: key,
+                    eventName: key,
+                    selector: null,
+                });
+            });
+        }
+        const targetPrototype = target
+            .prototype;
+        if (targetPrototype) {
+            Object.getOwnPropertyNames(targetPrototype).forEach((name) => {
+                const value = targetPrototype[name];
+                if (name !== "constructor" && typeof value === "function") {
+                    Enhanced.prototype[name] =
+                        value;
+                }
+            });
+        }
+        Object.getOwnPropertyNames(target).forEach((name) => {
+            if (name !== "prototype" && name !== "length" && name !== "name") {
+                Enhanced[name] = target[name];
+            }
+        });
+        Object.defineProperty(Enhanced, "name", {
+            value: target.name || "SmartComponent",
+            configurable: true,
+        });
+        return Enhanced;
+    }
+    /**
+     * Creates an initializer class from the captured config, or `undefined` if no initializer was configured.
+     *
+     * @param config - Captured setup configuration
+     * @returns Initializer constructor, or `undefined`
+     * @throws Error if initializer function is present but null
+     */
+    createInitializerClass(config) {
+        if (!config.initializer)
+            return undefined;
+        const initFn = config.initializer;
+        const createDeps = config.initializerCreateDeps;
+        const resolveDeps = this.resolveDeps.bind(this);
+        if (!initFn)
+            throw new Error("initFn is required");
+        return class DynamicInitializer extends SmartComponentInitializer {
+            async onInitialize(component) {
+                const deps = createDeps ? resolveDeps(createDeps) : undefined;
+                await initFn.call(component, component, deps);
+                return true;
+            }
+        };
+    }
+    /**
+     * Creates a lifecycle manager class from the captured config, or `undefined` if no lifecycle was configured.
+     *
+     * @param config - Captured setup configuration
+     * @returns Lifecycle manager constructor, or `undefined`
+     */
+    createLifecycleClass(config) {
+        const needsLifecycle = !!(config.lifecycle ||
+            (config.refs && config.refs.size > 0));
+        if (!needsLifecycle)
+            return undefined;
+        const lifecycle = config.lifecycle;
+        const resolveDeps = this.resolveDeps.bind(this);
+        if (!lifecycle) {
+            return class DynamicLifecycle extends SmartLifecycleManager {
+            };
+        }
+        return class DynamicLifecycle extends SmartLifecycleManager {
+            onComponentReady(component) {
+                if (!lifecycle.onInit)
+                    return;
+                const deps = lifecycle.createDeps
+                    ? resolveDeps(lifecycle.createDeps)
+                    : undefined;
+                const subs = {
+                    addSubscription: this.addSubscription.bind(this),
+                };
+                lifecycle.onInit(component, subs, deps);
+            }
+            onComponentDestroy(component) {
+                if (!lifecycle.onDestroy)
+                    return;
+                const deps = lifecycle.createDeps
+                    ? resolveDeps(lifecycle.createDeps)
+                    : undefined;
+                const subs = {
+                    addSubscription: this.addSubscription.bind(this),
+                };
+                lifecycle.onDestroy(component, subs, deps);
+            }
+        };
+    }
+}
+//# sourceMappingURL=smart-component-factory.js.map

package/dist/decorators/smart/smart-component-factory.js.map

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

package/dist/decorators/smart/types.d.ts

@@ -0,0 +1,81 @@
+import type { SmartComponent } from "../../core/smart-component.js";
+import type { Unsubscribe } from "../../reactive/signal.js";
+/**
+ * Defines the responsibility of describing concrete dependencies used by dynamic components.
+ */
+export type DependencyBag = Record<string, unknown>;
+/**
+ * Defines the responsibility of creating a dependency bag for each execution.
+ */
+export type DependencyBagFactory<TDeps extends DependencyBag = DependencyBag> = () => TDeps;
+/**
+ * Defines the minimal surface exposed to inline lifecycle hooks for subscription cleanup.
+ */
+export interface ISubscriptionManager {
+    addSubscription(unsubscribe: Unsubscribe): void;
+}
+/**
+ * Defines the responsibility of carrying a generic type without runtime impact.
+ * Used to mark generic usage and satisfy lint rules while returning `void`.
+ */
+export type TypeHint<T> = T extends unknown ? void : void;
+/**
+ * Defines the responsibility of providing the functional setup API for Smart components.
+ *
+ * @template TState - Type of the component state object
+ */
+export interface InlineContext<TState = unknown> {
+    /** Define reactive state properties */
+    state(initial: TState): void;
+    /** Define event handlers (reactions to component events) */
+    on(handlers: Record<string, (this: SmartComponent & TState, ...args: unknown[]) => unknown>): void;
+    /** Define computed (derived) properties */
+    computed(computed: Record<string, (this: SmartComponent & TState) => unknown>): void;
+    /** Define lifecycle hooks (onInit / onDestroy) with an optional dependency factory */
+    lifecycle<TDeps extends DependencyBag = DependencyBag>(hooks: {
+        onInit?: (component: SmartComponent & TState, subs: ISubscriptionManager, deps: TDeps | undefined) => void;
+        onDestroy?: (component: SmartComponent & TState, subs: ISubscriptionManager, deps: TDeps | undefined) => void;
+    }, createDeps?: DependencyBagFactory<TDeps>): void;
+    /** Set component HTML template */
+    html(template: string): void;
+    /** Set skeleton loading template */
+    skeleton(template: string): void;
+    /** Set error fallback template */
+    errorTemplate(template: string): void;
+    /** Set component scoped CSS styles */
+    css(styles: string): void;
+    /** Register static constants for [[BINDING]] syntax, or a function that resolves constants per instance */
+    constants(registry: Record<string, Record<string, string | number | boolean>> | ((component: HTMLElement) => Record<string, Record<string, string | number | boolean>>)): void;
+    /** Define async initialization logic with an optional dependency factory */
+    initializer<TDeps extends DependencyBag = DependencyBag>(fn: (this: SmartComponent & TState, component: SmartComponent & TState, deps?: TDeps) => Promise<void>, createDeps?: DependencyBagFactory<TDeps>): void;
+    /** Define validation rules or business configuration */
+    rules(config: Record<string, unknown>): void;
+    /** Access typed props */
+    props<TProps = unknown>(): TypeHint<TProps>;
+    /** Register template element reference */
+    ref(name: string): void;
+}
+/**
+ * Defines the responsibility of capturing setup data from InlineContext calls.
+ */
+export interface CapturedConfig<TState = unknown> {
+    state?: TState;
+    methods?: Record<string, (this: SmartComponent & TState, ...args: unknown[]) => unknown>;
+    computed?: Record<string, (this: SmartComponent & TState) => unknown>;
+    rules?: Record<string, unknown>;
+    lifecycle?: {
+        onInit?: (component: SmartComponent & TState, subs: ISubscriptionManager, deps: DependencyBag | undefined) => void;
+        onDestroy?: (component: SmartComponent & TState, subs: ISubscriptionManager, deps: DependencyBag | undefined) => void;
+        createDeps?: DependencyBagFactory;
+    };
+    template?: string;
+    skeleton?: string;
+    errorTemplate?: string;
+    styles?: string;
+    initializer?: (component: SmartComponent & TState, deps?: DependencyBag) => Promise<void>;
+    initializerCreateDeps?: DependencyBagFactory;
+    refs?: Set<string>;
+    propsTyped?: boolean;
+    constants?: Record<string, Record<string, string | number | boolean>> | ((component: HTMLElement) => Record<string, Record<string, string | number | boolean>>);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/decorators/smart/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/decorators/smart/types.ts"],"names":[],"mappings":"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"}

package/dist/decorators/smart/types.js

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

package/dist/decorators/smart/types.js.map

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

package/dist/decorators/smart-render.decorator.d.ts

@@ -0,0 +1,27 @@
+import type { ComponentMetadata } from "../core/component-metadata.js";
+/**
+ * Defines the configuration for a SmartComponent decorator.
+ * Derived from ComponentMetadata — all fields are optional at decoration time.
+ */
+export type ComponentConfig = Partial<ComponentMetadata>;
+/**
+ * @SmartRender decorator - Marks a class as a SmartComponent with declarative configuration.
+ *
+ * @param config - Component configuration (selector, template, lifecycle, etc.)
+ * @throws Error if config is null or undefined
+ *
+ * @example
+ * ```typescript
+ * @SmartRender({
+ *   selector: 'todo-app',
+ *   template: '<div>{{count}}</div>',
+ *   initializer: () => new TodoAppInitializer(Services.get(ApiService)),
+ *   lifecycle: () => new TodoAppLifecycle(Services.get(EventBus))
+ * })
+ * class TodoApp extends SmartComponent {
+ *   @Reactive accessor count = 0;
+ * }
+ * ```
+ */
+export declare function SmartRender(config: ComponentConfig): ClassDecorator;
+//# sourceMappingURL=smart-render.decorator.d.ts.map

package/dist/decorators/smart-render.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-render.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/smart-render.decorator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGvE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CA6BnE"}

package/dist/decorators/smart-render.decorator.js

@@ -0,0 +1,41 @@
+import { Services } from "../providers/service-provider.js";
+/**
+ * @SmartRender decorator - Marks a class as a SmartComponent with declarative configuration.
+ *
+ * @param config - Component configuration (selector, template, lifecycle, etc.)
+ * @throws Error if config is null or undefined
+ *
+ * @example
+ * ```typescript
+ * @SmartRender({
+ *   selector: 'todo-app',
+ *   template: '<div>{{count}}</div>',
+ *   initializer: () => new TodoAppInitializer(Services.get(ApiService)),
+ *   lifecycle: () => new TodoAppLifecycle(Services.get(EventBus))
+ * })
+ * class TodoApp extends SmartComponent {
+ *   @Reactive accessor count = 0;
+ * }
+ * ```
+ */
+export function SmartRender(config) {
+    if (!config)
+        throw new Error("Config is required");
+    return (target) => {
+        if (config.selector) {
+            const metadata = {
+                ...config,
+                selector: config.selector,
+                template: config.template || "",
+            };
+            Services.get("IComponentMetadataRegistry").register(config.selector, metadata);
+            const options = {
+                initializer: config.initializer,
+                lifecycle: config.lifecycle,
+            };
+            Services.get("ISmartElementRegistrar").register(config.selector, target, options);
+        }
+        return target;
+    };
+}
+//# sourceMappingURL=smart-render.decorator.js.map

package/dist/decorators/smart-render.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-render.decorator.js","sourceRoot":"","sources":["../../src/decorators/smart-render.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAa5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAuB;IACjD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAEnD,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAsB;gBAClC,GAAG,MAAM;gBACT,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;aAChC,CAAC;YAEF,QAAQ,CAAC,GAAG,CACV,4BAA4B,CAC7B,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAEtC,MAAM,OAAO,GAAwC;gBACnD,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC;YAEF,QAAQ,CAAC,GAAG,CAAyB,wBAAwB,CAAC,CAAC,QAAQ,CACrE,MAAM,CAAC,QAAQ,EACf,MAA+D,EAC/D,OAAO,CACR,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/smart.decorator.d.ts

@@ -0,0 +1,20 @@
+import type { InlineContext } from "./smart/types.js";
+/**
+ * Implements the responsibility of providing a functional decorator for SmartComponents.
+ *
+ * @template TState - Type of component state (from `ctx.state()`)
+ * @param selector - Custom element tag name (e.g., "my-counter")
+ * @param setup - Setup function receiving `InlineContext`
+ * @returns Class decorator that transforms the target into a SmartComponent
+ *
+ * @example
+ * ```typescript
+ * @Smart('hello-world', (ctx) => {
+ *   ctx.state({ name: 'World' });
+ *   ctx.html('<p>Hello {{name}}!</p>');
+ * })
+ * class HelloWorld {}
+ * ```
+ */
+export declare function Smart<TState = unknown>(selector: string, setup: (ctx: InlineContext<TState>) => void): ClassDecorator;
+//# sourceMappingURL=smart.decorator.d.ts.map

package/dist/decorators/smart.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/smart.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQtD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,MAAM,GAAG,OAAO,EACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,IAAI,GAC1C,cAAc,CA+BhB"}

package/dist/decorators/smart.decorator.js

@@ -0,0 +1,45 @@
+import { SmartRender as SmartComponentDecorator } from "./smart-render.decorator.js";
+import { Services } from "../providers/service-provider.js";
+/**
+ * Implements the responsibility of providing a functional decorator for SmartComponents.
+ *
+ * @template TState - Type of component state (from `ctx.state()`)
+ * @param selector - Custom element tag name (e.g., "my-counter")
+ * @param setup - Setup function receiving `InlineContext`
+ * @returns Class decorator that transforms the target into a SmartComponent
+ *
+ * @example
+ * ```typescript
+ * @Smart('hello-world', (ctx) => {
+ *   ctx.state({ name: 'World' });
+ *   ctx.html('<p>Hello {{name}}!</p>');
+ * })
+ * class HelloWorld {}
+ * ```
+ */
+export function Smart(selector, setup) {
+    if (!selector)
+        throw new Error("selector is required");
+    if (!setup)
+        throw new Error("setup is required");
+    const decorator = ((target) => {
+        const factory = Services.get("ISmartComponentFactory");
+        const config = factory.captureConfig(setup);
+        const EnhancedClass = factory.createEnhancedClass(target, config);
+        const InitializerClass = factory.createInitializerClass(config);
+        const LifecycleClass = factory.createLifecycleClass(config);
+        const ComponentDecorator = SmartComponentDecorator({
+            selector,
+            template: config.template || "",
+            skeleton: config.skeleton,
+            errorTemplate: config.errorTemplate,
+            styles: config.styles,
+            constants: config.constants,
+            initializer: InitializerClass ? () => new InitializerClass() : undefined,
+            lifecycle: LifecycleClass ? () => new LifecycleClass() : undefined,
+        });
+        return ComponentDecorator(EnhancedClass);
+    });
+    return decorator;
+}
+//# sourceMappingURL=smart.decorator.js.map

package/dist/decorators/smart.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart.decorator.js","sourceRoot":"","sources":["../../src/decorators/smart.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGrF,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAM5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,KAAK,CACnB,QAAgB,EAChB,KAA2C;IAE3C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAEjD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAe,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAC1B,wBAAwB,CACzB,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,gBAAgB,GAAG,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE5D,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;YACjD,QAAQ;YACR,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAGL;YACb,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS;YACxE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS;SACnE,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC,CAAmB,CAAC;IAErB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/decorators/view-child.decorator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ViewChild decorator - Automatically binds a DOM element reference
+ *
+ * Usage:
+ * @ViewChild('#todo-input') textbox!: HTMLElement;
+ * @ViewChild('smart-textbox') textbox!: HTMLElement;
+ */
+export declare function ViewChild(selector: string): (target: any, propertyKey: string) => void;
+/**
+ * ViewChildComponent decorator - Automatically extracts SmartComponent from element
+ *
+ * Usage:
+ * @ViewChildComponent('#todo-filter') filterComponent!: TodoFilterComponent;
+ */
+export declare function ViewChildComponent(selector: string): (target: any, propertyKey: string) => void;
+/**
+ * Initialize all @ViewChild decorated properties
+ * Called automatically by SmartComponent after render
+ */
+export declare function initializeViewChildren(component: any): void;
+//# sourceMappingURL=view-child.decorator.d.ts.map

package/dist/decorators/view-child.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-child.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/view-child.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IACvB,QAAQ,GAAG,EAAE,aAAa,MAAM,UAOlD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAChC,QAAQ,GAAG,EAAE,aAAa,MAAM,UAOlD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAmB3D"}

package/dist/decorators/view-child.decorator.js

@@ -0,0 +1,56 @@
+/**
+ * ViewChild decorator - Automatically binds a DOM element reference
+ *
+ * Usage:
+ * @ViewChild('#todo-input') textbox!: HTMLElement;
+ * @ViewChild('smart-textbox') textbox!: HTMLElement;
+ */
+export function ViewChild(selector) {
+    return function (target, propertyKey) {
+        // Store metadata about the view child
+        if (!target._viewChildren) {
+            target._viewChildren = [];
+        }
+        target._viewChildren.push({ propertyKey, selector, extractComponent: false });
+    };
+}
+/**
+ * ViewChildComponent decorator - Automatically extracts SmartComponent from element
+ *
+ * Usage:
+ * @ViewChildComponent('#todo-filter') filterComponent!: TodoFilterComponent;
+ */
+export function ViewChildComponent(selector) {
+    return function (target, propertyKey) {
+        // Store metadata about the view child
+        if (!target._viewChildren) {
+            target._viewChildren = [];
+        }
+        target._viewChildren.push({ propertyKey, selector, extractComponent: true });
+    };
+}
+/**
+ * Initialize all @ViewChild decorated properties
+ * Called automatically by SmartComponent after render
+ */
+export function initializeViewChildren(component) {
+    const prototype = Object.getPrototypeOf(component);
+    const viewChildren = prototype._viewChildren;
+    if (!viewChildren || !component.htmlElement)
+        return;
+    for (const { propertyKey, selector, extractComponent } of viewChildren) {
+        const element = component.htmlElement.querySelector(selector);
+        if (element) {
+            if (extractComponent) {
+                // Extract __smartComponent if requested
+                const el = element;
+                component[propertyKey] = el.__smartComponent || null;
+            }
+            else {
+                // Just assign the element
+                component[propertyKey] = element;
+            }
+        }
+    }
+}
+//# sourceMappingURL=view-child.decorator.js.map

package/dist/decorators/view-child.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-child.decorator.js","sourceRoot":"","sources":["../../src/decorators/view-child.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,UAAU,MAAW,EAAE,WAAmB;QAC/C,sCAAsC;QACtC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,UAAU,MAAW,EAAE,WAAmB;QAC/C,sCAAsC;QACtC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAc;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,CAAC;IAE7C,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,WAAW;QAAE,OAAO;IAEpD,KAAK,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,YAAY,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,gBAAgB,EAAE,CAAC;gBACrB,wCAAwC;gBACxC,MAAM,EAAE,GAAG,OAAmD,CAAC;gBAC/D,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,gBAAgB,IAAI,IAAI,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,0BAA0B;gBAC1B,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}