smart-lifecycle 0.1.1

package/dist/reactive/dependency-tracker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Implements the responsibility of tracking reactive property access
+ * during computed getter evaluation.
+ *
+ * @description
+ * Encapsulates the tracking context that `@Reactive` getters participate in.
+ * When a computed getter is evaluated under `discoverDependencies()`, any
+ * `@Reactive` accessor that is read will record its property name via
+ * `trackAccess()`.
+ */
+import type { IDependencyTracker } from "./dependency-tracker.interface.js";
+/**
+ * Implements the responsibility of tracking reactive property dependencies
+ * using an internal Set-based tracking context.
+ */
+export declare class DependencyTracker implements IDependencyTracker {
+    private activeTracker;
+    /**
+     * Records a property access in the active tracking context.
+     * Called by `@Reactive` getters during dependency discovery.
+     * No-op when no tracking context is active.
+     *
+     * @param propertyName - Name of the reactive property being read
+     */
+    trackAccess(propertyName: string): void;
+    /**
+     * Runs a function while tracking which reactive properties are accessed.
+     *
+     * @param fn - Function to run (typically a getter invocation)
+     * @returns Array of reactive property names that were read during execution
+     */
+    discoverDependencies(fn: () => unknown): string[];
+}
+//# sourceMappingURL=dependency-tracker.d.ts.map

package/dist/reactive/dependency-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-tracker.d.ts","sourceRoot":"","sources":["../../src/reactive/dependency-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,aAAa,CAA4B;IAEjD;;;;;;OAMG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAMvC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,MAAM,EAAE;CAUlD"}

package/dist/reactive/dependency-tracker.interface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Defines the responsibility of tracking reactive property access during
+ * computed getter evaluation.
+ *
+ * @description
+ * Provides a tracking context that `@Reactive` getters participate in.
+ * When a computed getter is evaluated under `discoverDependencies()`, any
+ * `@Reactive` accessor that is read will record its property name via
+ * `trackAccess()`.
+ */
+export interface IDependencyTracker {
+    /**
+     * Records a property access in the active tracking context.
+     * Called by `@Reactive` getters during dependency discovery.
+     * No-op when no tracking context is active.
+     *
+     * @param propertyName - Name of the reactive property being read
+     */
+    trackAccess(propertyName: string): void;
+    /**
+     * Runs a function while tracking which reactive properties are accessed.
+     *
+     * @param fn - Function to run (typically a getter invocation)
+     * @returns Array of reactive property names that were read during execution
+     *
+     * @example
+     * ```typescript
+     * const deps = tracker.discoverDependencies(() => component.icon);
+     * // deps → ['mode'] (because getter reads this.mode)
+     * ```
+     */
+    discoverDependencies(fn: () => unknown): string[];
+}
+//# sourceMappingURL=dependency-tracker.interface.d.ts.map

package/dist/reactive/dependency-tracker.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-tracker.interface.d.ts","sourceRoot":"","sources":["../../src/reactive/dependency-tracker.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;CACnD"}

package/dist/reactive/dependency-tracker.interface.js

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

package/dist/reactive/dependency-tracker.interface.js.map

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

package/dist/reactive/dependency-tracker.js

@@ -0,0 +1,47 @@
+/**
+ * Implements the responsibility of tracking reactive property access
+ * during computed getter evaluation.
+ *
+ * @description
+ * Encapsulates the tracking context that `@Reactive` getters participate in.
+ * When a computed getter is evaluated under `discoverDependencies()`, any
+ * `@Reactive` accessor that is read will record its property name via
+ * `trackAccess()`.
+ */
+/**
+ * Implements the responsibility of tracking reactive property dependencies
+ * using an internal Set-based tracking context.
+ */
+export class DependencyTracker {
+    activeTracker = null;
+    /**
+     * Records a property access in the active tracking context.
+     * Called by `@Reactive` getters during dependency discovery.
+     * No-op when no tracking context is active.
+     *
+     * @param propertyName - Name of the reactive property being read
+     */
+    trackAccess(propertyName) {
+        if (this.activeTracker) {
+            this.activeTracker.add(propertyName);
+        }
+    }
+    /**
+     * Runs a function while tracking which reactive properties are accessed.
+     *
+     * @param fn - Function to run (typically a getter invocation)
+     * @returns Array of reactive property names that were read during execution
+     */
+    discoverDependencies(fn) {
+        const deps = new Set();
+        this.activeTracker = deps;
+        try {
+            fn();
+        }
+        finally {
+            this.activeTracker = null;
+        }
+        return Array.from(deps);
+    }
+}
+//# sourceMappingURL=dependency-tracker.js.map

package/dist/reactive/dependency-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-tracker.js","sourceRoot":"","sources":["../../src/reactive/dependency-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACpB,aAAa,GAAuB,IAAI,CAAC;IAEjD;;;;;;OAMG;IACH,WAAW,CAAC,YAAoB;QAC9B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,EAAiB;QACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC;YACH,EAAE,EAAE,CAAC;QACP,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/reactive/index.d.ts

@@ -0,0 +1,5 @@
+export type { Observable } from './observable.js';
+export { Subject } from './subject.js';
+export { Subscription, type Unsubscribe } from './subscription.js';
+export { map$ } from './operators.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/reactive/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reactive/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/reactive/index.js

@@ -0,0 +1,4 @@
+export { Subject } from './subject.js';
+export { Subscription } from './subscription.js';
+export { map$ } from './operators.js';
+//# sourceMappingURL=index.js.map

package/dist/reactive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reactive/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/reactive/observable.d.ts

@@ -0,0 +1,15 @@
+import type { Subscription } from './subscription';
+/**
+ * Defines the responsibility of representing a stream of values.
+ * Consumers can subscribe to receive values over time and unsubscribe to stop receiving updates.
+ */
+export interface Observable<T> {
+    /**
+     * Subscribes to the stream.
+     *
+     * @param next - Handler invoked for each emitted value
+     * @returns Subscription-like disposable to stop receiving values
+     */
+    subscribe(next: (value: T) => void): Subscription;
+}
+//# sourceMappingURL=observable.d.ts.map

package/dist/reactive/observable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable.d.ts","sourceRoot":"","sources":["../../src/reactive/observable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,YAAY,CAAC;CACnD"}

package/dist/reactive/observable.js

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

package/dist/reactive/observable.js.map

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

package/dist/reactive/operators.d.ts

@@ -0,0 +1,6 @@
+import type { Observable } from './observable.js';
+/**
+ * Defines the responsibility of transforming stream values using a mapping function.
+ */
+export declare function map$<A, B>(source: Observable<A>, mapper: (value: A) => B): Observable<B>;
+//# sourceMappingURL=operators.d.ts.map

package/dist/reactive/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../src/reactive/operators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAMxF"}

package/dist/reactive/operators.js

@@ -0,0 +1,11 @@
+/**
+ * Defines the responsibility of transforming stream values using a mapping function.
+ */
+export function map$(source, mapper) {
+    return {
+        subscribe(next) {
+            return source.subscribe((value) => next(mapper(value)));
+        }
+    };
+}
+//# sourceMappingURL=operators.js.map

package/dist/reactive/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../../src/reactive/operators.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,IAAI,CAAO,MAAqB,EAAE,MAAuB;IACvE,OAAO;QACL,SAAS,CAAC,IAAwB;YAChC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/reactive/signal.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Defines the responsibility of representing a minimal teardown function.
+ */
+export type Unsubscribe = () => void;
+/**
+ * Defines the responsibility of broadcasting invalidation signals to listeners.
+ */
+export interface IStateSignal {
+    /**
+     * Subscribes a listener to be notified on invalidation.
+     * @param listener - Callback invoked when notify() is called
+     * @returns Unsubscribe function to remove the listener
+     */
+    subscribe(listener: () => void): Unsubscribe;
+    /**
+     * Notifies all current listeners.
+     */
+    notify(): void;
+}
+/**
+ * Implements the responsibility of multicasting invalidation notifications.
+ */
+export declare class StateSignal implements IStateSignal {
+    private readonly listeners;
+    /**
+     * Subscribes a listener to be notified on invalidation.
+     *
+     * @param listener - Callback invoked when notify() is called
+     * @returns Unsubscribe function to remove the listener
+     */
+    subscribe(listener: () => void): Unsubscribe;
+    /**
+     * Notifies all current listeners.
+     *
+     * @description
+     * Subscriber exceptions are isolated to prevent one faulty subscriber
+     * from breaking the rest of the notification chain.
+     */
+    notify(): void;
+}
+//# sourceMappingURL=signal.d.ts.map

package/dist/reactive/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/reactive/signal.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IAE7C;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAEnD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW;IAO5C;;;;;;OAMG;IACH,MAAM,IAAI,IAAI;CAUf"}

package/dist/reactive/signal.js

@@ -0,0 +1,37 @@
+/**
+ * Implements the responsibility of multicasting invalidation notifications.
+ */
+export class StateSignal {
+    listeners = new Set();
+    /**
+     * Subscribes a listener to be notified on invalidation.
+     *
+     * @param listener - Callback invoked when notify() is called
+     * @returns Unsubscribe function to remove the listener
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /**
+     * Notifies all current listeners.
+     *
+     * @description
+     * Subscriber exceptions are isolated to prevent one faulty subscriber
+     * from breaking the rest of the notification chain.
+     */
+    notify() {
+        for (const fn of [...this.listeners]) {
+            try {
+                fn();
+            }
+            catch {
+                // Isolation: a faulty subscriber must not break sibling subscribers.
+                // Errors are intentionally not re-thrown to preserve notification chain integrity.
+            }
+        }
+    }
+}
+//# sourceMappingURL=signal.js.map

package/dist/reactive/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/reactive/signal.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD;;;;;OAKG;IACH,SAAS,CAAC,QAAoB;QAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM;QACJ,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,EAAE,EAAE,CAAC;YACP,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,mFAAmF;YACrF,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/reactive/subject.d.ts

@@ -0,0 +1,30 @@
+import { type Observable } from './observable.js';
+import { Subscription } from './subscription.js';
+/**
+ * Implements the responsibility of multicasting values to multiple subscribers.
+ * Provides a minimal subset similar to RxJS Subject without operators.
+ */
+export declare class Subject<T> implements Observable<T> {
+    private observers;
+    private isCompleted;
+    /**
+     * Subscribes to receive values from this subject.
+     *
+     * @param next - Handler invoked for each emitted value
+     * @returns Subscription that removes the handler on unsubscribe
+     */
+    subscribe(next: (value: T) => void): Subscription;
+    /**
+     * Emits a new value to all current subscribers.
+     */
+    next(value: T): void;
+    /**
+     * Completes the subject and clears subscribers.
+     */
+    complete(): void;
+    /**
+     * Returns an Observable view of this subject.
+     */
+    asObservable(): Observable<T>;
+}
+//# sourceMappingURL=subject.d.ts.map

package/dist/reactive/subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../../src/reactive/subject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,OAAO,CAAC,CAAC,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,YAAY;IAUjD;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAOpB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,YAAY,IAAI,UAAU,CAAC,CAAC,CAAC;CAG9B"}

package/dist/reactive/subject.js

@@ -0,0 +1,53 @@
+import { Subscription } from './subscription.js';
+/**
+ * Implements the responsibility of multicasting values to multiple subscribers.
+ * Provides a minimal subset similar to RxJS Subject without operators.
+ */
+export class Subject {
+    observers = new Set();
+    isCompleted = false;
+    /**
+     * Subscribes to receive values from this subject.
+     *
+     * @param next - Handler invoked for each emitted value
+     * @returns Subscription that removes the handler on unsubscribe
+     */
+    subscribe(next) {
+        if (this.isCompleted) {
+            return new Subscription();
+        }
+        this.observers.add(next);
+        const sub = new Subscription();
+        sub.add(() => this.observers.delete(next));
+        return sub;
+    }
+    /**
+     * Emits a new value to all current subscribers.
+     */
+    next(value) {
+        if (this.isCompleted)
+            return;
+        for (const observer of Array.from(this.observers)) {
+            try {
+                observer(value);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    /**
+     * Completes the subject and clears subscribers.
+     */
+    complete() {
+        if (this.isCompleted)
+            return;
+        this.isCompleted = true;
+        this.observers.clear();
+    }
+    /**
+     * Returns an Observable view of this subject.
+     */
+    asObservable() {
+        return { subscribe: (next) => this.subscribe(next) };
+    }
+}
+//# sourceMappingURL=subject.js.map

package/dist/reactive/subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../src/reactive/subject.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;GAGG;AACH,MAAM,OAAO,OAAO;IACV,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,WAAW,GAAG,KAAK,CAAC;IAE5B;;;;;OAKG;IACH,SAAS,CAAC,IAAwB;QAChC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAQ;QACX,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC;gBAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IACvD,CAAC;CACF"}

package/dist/reactive/subscription.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Defines the responsibility of managing teardown logic for subscriptions and event listeners.
+ */
+export type Unsubscribe = () => void;
+/**
+ * Implements the responsibility of aggregating teardown callbacks and disposing them safely.
+ *
+ * @example
+ * ```typescript
+ * const sub = new Subscription();
+ * sub.add(() => console.log('teardown'));
+ * sub.unsubscribe();
+ * ```
+ */
+export declare class Subscription {
+    private teardowns;
+    private closedInternal;
+    /**
+     * Adds teardown logic or another Subscription.
+     *
+     * @param teardown - Function or Subscription to dispose on unsubscribe
+     */
+    add(teardown: Unsubscribe | Subscription | null | undefined): void;
+    /**
+     * Unsubscribes all registered teardowns idempotently.
+     */
+    unsubscribe(): void;
+    /**
+     * Indicates whether this subscription has been unsubscribed.
+     */
+    get closed(): boolean;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/reactive/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/reactive/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAUlE;;OAEG;IACH,WAAW,IAAI,IAAI;IAUnB;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;CACF"}

package/dist/reactive/subscription.js

@@ -0,0 +1,53 @@
+/**
+ * Implements the responsibility of aggregating teardown callbacks and disposing them safely.
+ *
+ * @example
+ * ```typescript
+ * const sub = new Subscription();
+ * sub.add(() => console.log('teardown'));
+ * sub.unsubscribe();
+ * ```
+ */
+export class Subscription {
+    teardowns = [];
+    closedInternal = false;
+    /**
+     * Adds teardown logic or another Subscription.
+     *
+     * @param teardown - Function or Subscription to dispose on unsubscribe
+     */
+    add(teardown) {
+        if (!teardown || this.closedInternal)
+            return;
+        if (teardown instanceof Subscription) {
+            if (teardown === this)
+                return;
+            this.teardowns.push(() => teardown.unsubscribe());
+            return;
+        }
+        this.teardowns.push(teardown);
+    }
+    /**
+     * Unsubscribes all registered teardowns idempotently.
+     */
+    unsubscribe() {
+        if (this.closedInternal)
+            return;
+        this.closedInternal = true;
+        const tasks = this.teardowns.slice();
+        this.teardowns = [];
+        for (const task of tasks) {
+            try {
+                task();
+            }
+            catch { /* ignore */ }
+        }
+    }
+    /**
+     * Indicates whether this subscription has been unsubscribed.
+     */
+    get closed() {
+        return this.closedInternal;
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/reactive/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/reactive/subscription.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAAkB,EAAE,CAAC;IAC9B,cAAc,GAAG,KAAK,CAAC;IAE/B;;;;OAIG;IACH,GAAG,CAAC,QAAuD;QACzD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO;QAC7C,IAAI,QAAQ,YAAY,YAAY,EAAE,CAAC;YACrC,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO;YAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO;QAChC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBAAC,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/registration/register-smart-behavior.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Registers a pure custom element as a smart behavior.
+ *
+ * @description
+ * Lightweight registration for custom elements that do not require the full
+ * SmartComponent rendering pipeline (template compilation, reactive bindings,
+ * lifecycle managers, host projection). These elements handle their own DOM
+ * wiring directly via connectedCallback / disconnectedCallback.
+ *
+ * The element is marked as a smart tag so that parent template compilers
+ * detect it via isSmartTag() and route object values through SmartInputStore.
+ *
+ * @param tagName - HTML tag name for the element (e.g. 'smart-action')
+ * @param elementClass - CustomElementConstructor to register
+ * @throws Error if tagName or elementClass is null or undefined
+ *
+ * @example
+ * ```typescript
+ * class MyBehavior extends HTMLElement {
+ *   connectedCallback() { ... }
+ *   disconnectedCallback() { ... }
+ * }
+ * registerSmartBehavior('my-behavior', MyBehavior);
+ * ```
+ */
+export declare function registerSmartBehavior(tagName: string, elementClass: CustomElementConstructor): void;
+//# sourceMappingURL=register-smart-behavior.d.ts.map

package/dist/registration/register-smart-behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-smart-behavior.d.ts","sourceRoot":"","sources":["../../src/registration/register-smart-behavior.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,wBAAwB,GACrC,IAAI,CAgBN"}

package/dist/registration/register-smart-behavior.js

@@ -0,0 +1,42 @@
+import { markSmartTag } from './smart-tags.js';
+/**
+ * Registers a pure custom element as a smart behavior.
+ *
+ * @description
+ * Lightweight registration for custom elements that do not require the full
+ * SmartComponent rendering pipeline (template compilation, reactive bindings,
+ * lifecycle managers, host projection). These elements handle their own DOM
+ * wiring directly via connectedCallback / disconnectedCallback.
+ *
+ * The element is marked as a smart tag so that parent template compilers
+ * detect it via isSmartTag() and route object values through SmartInputStore.
+ *
+ * @param tagName - HTML tag name for the element (e.g. 'smart-action')
+ * @param elementClass - CustomElementConstructor to register
+ * @throws Error if tagName or elementClass is null or undefined
+ *
+ * @example
+ * ```typescript
+ * class MyBehavior extends HTMLElement {
+ *   connectedCallback() { ... }
+ *   disconnectedCallback() { ... }
+ * }
+ * registerSmartBehavior('my-behavior', MyBehavior);
+ * ```
+ */
+export function registerSmartBehavior(tagName, elementClass) {
+    if (!tagName)
+        throw new Error('Tag name is required');
+    if (!elementClass)
+        throw new Error('Element class is required');
+    const normalizedTag = tagName.toLowerCase();
+    markSmartTag(normalizedTag);
+    if (typeof customElements === 'undefined') {
+        return;
+    }
+    if (customElements.get(normalizedTag)) {
+        return;
+    }
+    customElements.define(normalizedTag, elementClass);
+}
+//# sourceMappingURL=register-smart-behavior.js.map

package/dist/registration/register-smart-behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-smart-behavior.js","sourceRoot":"","sources":["../../src/registration/register-smart-behavior.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,YAAsC;IAEtC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACtD,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAEhE,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5C,YAAY,CAAC,aAAa,CAAC,CAAC;IAE5B,IAAI,OAAO,cAAc,KAAK,WAAW,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,IAAI,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,cAAc,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACrD,CAAC"}

package/dist/registration/register-smart-element.d.ts

@@ -0,0 +1,27 @@
+import type { SmartComponent } from '../core/smart-component.js';
+import type { SmartElementOptions } from './smart-element-factory.js';
+export { isSmartTag } from './smart-tags.js';
+export { SmartElementFactory } from './smart-element-factory.js';
+export type { SmartElementOptions } from './smart-element-factory.js';
+export type { ISmartElementFactory } from './smart-element-factory.interface.js';
+export { SmartElementRegistrar } from './smart-element-registrar.js';
+export type { ISmartElementRegistrar } from './smart-element-registrar.interface.js';
+/**
+ * Registers a SmartComponent as a native custom element.
+ *
+ * Resolves the registrar from the global Services container.
+ * Requires `bootstrapFramework(Services)` to have been called first.
+ *
+ * @param tagName - HTML tag name for the element (e.g. 'my-component')
+ * @param componentCtor - Constructor of the SmartComponent to register
+ * @param options - Optional configuration: lifecycle, initializer, shadow DOM, render engine
+ * @throws Error if tagName or componentCtor are null or undefined
+ * @throws Error if framework has not been bootstrapped
+ *
+ * @example
+ * ```typescript
+ * registerSmartElement('my-counter', CounterComponent, { useShadowDom: true });
+ * ```
+ */
+export declare function registerSmartElement<T extends SmartComponent>(tagName: string, componentCtor: new (...args: unknown[]) => T, options?: SmartElementOptions<T>): void;
+//# sourceMappingURL=register-smart-element.d.ts.map

package/dist/registration/register-smart-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-smart-element.d.ts","sourceRoot":"","sources":["../../src/registration/register-smart-element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAErF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EAC3D,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC5C,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI,CAGN"}

package/dist/registration/register-smart-element.js

@@ -0,0 +1,26 @@
+import { Services } from '../providers/service-provider.js';
+export { isSmartTag } from './smart-tags.js';
+export { SmartElementFactory } from './smart-element-factory.js';
+export { SmartElementRegistrar } from './smart-element-registrar.js';
+/**
+ * Registers a SmartComponent as a native custom element.
+ *
+ * Resolves the registrar from the global Services container.
+ * Requires `bootstrapFramework(Services)` to have been called first.
+ *
+ * @param tagName - HTML tag name for the element (e.g. 'my-component')
+ * @param componentCtor - Constructor of the SmartComponent to register
+ * @param options - Optional configuration: lifecycle, initializer, shadow DOM, render engine
+ * @throws Error if tagName or componentCtor are null or undefined
+ * @throws Error if framework has not been bootstrapped
+ *
+ * @example
+ * ```typescript
+ * registerSmartElement('my-counter', CounterComponent, { useShadowDom: true });
+ * ```
+ */
+export function registerSmartElement(tagName, componentCtor, options) {
+    const registrar = Services.get('ISmartElementRegistrar');
+    registrar.register(tagName, componentCtor, options);
+}
+//# sourceMappingURL=register-smart-element.js.map

package/dist/registration/register-smart-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-smart-element.js","sourceRoot":"","sources":["../../src/registration/register-smart-element.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAI5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,aAA4C,EAC5C,OAAgC;IAEhC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAyB,wBAAwB,CAAC,CAAC;IACjF,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}