smart-lifecycle 0.1.1

package/dist/providers/default-service-provider.js

@@ -0,0 +1,89 @@
+/**
+ * Default Service Registry implementation.
+ *
+ * @description
+ * Simple Map-based registry for Composition Root pattern.
+ * Supports both direct instances and factory functions for lazy instantiation.
+ * Zero-dependency implementation.
+ *
+ * @remarks
+ * Factory functions enable:
+ * - Lazy instantiation (created on first access)
+ * - Circular dependency resolution
+ * - Dynamic dependency resolution
+ */
+export class DefaultServiceRegistry {
+    services = new Map();
+    /**
+     * Registers a service instance or factory function
+     *
+     * @param token - Service identifier (class constructor or string)
+     * @param instanceOrFactory - Service instance or factory function
+     *
+     * @example
+     * ```typescript
+     * // Direct instance
+     * registry.register(TodoService, new TodoService());
+     *
+     * // Factory function (lazy)
+     * registry.register(TodoService, () => new TodoService());
+     *
+     * // With dependencies
+     * registry.register(TodoService, () => {
+     *   const http = registry.get(HttpService);
+     *   return new TodoService(http);
+     * });
+     * ```
+     */
+    register(token, instanceOrFactory) {
+        if (this.services.has(token)) {
+            console.warn(`[ServiceRegistry] Service ${this.getTokenName(token)} is already registered. Overwriting.`);
+        }
+        this.services.set(token, instanceOrFactory);
+    }
+    /**
+     * Retrieves a service instance by token
+     *
+     * @description
+     * If the registered value is a factory function, it will be invoked
+     * and the result returned. Otherwise, returns the instance directly.
+     *
+     * @param token - Service identifier
+     * @returns Service instance
+     * @throws Error if service is not registered
+     */
+    get(token) {
+        if (!this.services.has(token)) {
+            throw new Error(`[ServiceRegistry] Service '${this.getTokenName(token)}' is not registered. ` +
+                `Make sure to register it in your Composition Root.`);
+        }
+        const value = this.services.get(token);
+        // Execute factory function if registered as factory
+        // Cache the result so subsequent gets return the same instance (singleton)
+        if (typeof value === "function" && !value.prototype) {
+            const instance = value();
+            this.services.set(token, instance);
+            return instance;
+        }
+        return value;
+    }
+    has(token) {
+        return this.services.has(token);
+    }
+    clear() {
+        this.services.clear();
+    }
+    get size() {
+        return this.services.size;
+    }
+    getTokenName(token) {
+        if (typeof token === "string") {
+            return token;
+        }
+        if (typeof token === "symbol") {
+            return token.toString();
+        }
+        return token.name || token.toString();
+    }
+}
+//# sourceMappingURL=default-service-provider.js.map

package/dist/providers/default-service-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-service-provider.js","sourceRoot":"","sources":["../../src/providers/default-service-provider.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,sBAAsB;IACzB,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE7D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAI,KAAsB,EAAE,iBAAgC;QAClE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CACV,6BAA6B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,sCAAsC,CAC5F,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAI,KAAsB;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,uBAAuB;gBAC3E,oDAAoD,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEvC,oDAAoD;QACpD,2EAA2E;QAC3E,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAI,KAAiB,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACnC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,KAAU,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,KAAmB;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEO,YAAY,CAAC,KAAmB;QACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/providers/framework-bootstrap.d.ts

@@ -0,0 +1,58 @@
+import type { IServiceRegistry } from "./service-provider.interface.js";
+/**
+ * Map of service token overrides.
+ * Each key is a service token (string), each value is a factory function or instance
+ * that replaces the framework default for that token.
+ */
+export type FrameworkOverrides = Record<string, (() => unknown) | unknown>;
+/**
+ * Defines the decorator compatibility mode for the framework.
+ *
+ * - `'strict'`: Only TC39 Stage 3 decorators are accepted. Using legacy
+ *   (`experimentalDecorators`) context throws an error at decoration time.
+ *   This is the default and recommended mode for new projects.
+ * - `'auto'`: Both TC39 Stage 3 and legacy (`experimentalDecorators`) decorator
+ *   contexts are accepted. Use this in sandboxed environments (e.g. code playground
+ *   iframes) where the user controls the decorator system.
+ */
+export type DecoratorMode = "strict" | "auto";
+/**
+ * Configuration options for `bootstrapFramework`.
+ */
+export interface BootstrapOptions {
+    /**
+     * Controls which decorator system is accepted at runtime.
+     * Defaults to `'strict'` (TC39 Stage 3 only).
+     */
+    readonly decorators?: DecoratorMode;
+}
+/**
+ * Registers all framework services in the given registry.
+ *
+ * @description
+ * Centralised composition root for the SmartComponents framework.
+ * Every concrete instantiation lives here — the rest of the codebase
+ * depends only on abstractions resolved through the registry.
+ *
+ * @param registry - Service registry to populate
+ * @param overrides - Optional map of service overrides. Tokens present here
+ *                    replace the framework default — the default is never registered.
+ * @param options - Optional framework configuration options.
+ * @throws Error if registry is null or undefined
+ *
+ * @example
+ * ```typescript
+ * // Default bootstrap (strict TC39 Stage 3 mode)
+ * await bootstrapFramework(Services);
+ *
+ * // With SSR adapter override
+ * await bootstrapFramework(Services, {
+ *   'IDomAdapter': () => new SSRDomAdapter()
+ * });
+ *
+ * // Sandbox/playground mode — accept any decorator system
+ * await bootstrapFramework(Services, {}, { decorators: 'auto' });
+ * ```
+ */
+export declare function bootstrapFramework(registry: IServiceRegistry, overrides?: FrameworkOverrides, options?: BootstrapOptions): Promise<void>;
+//# sourceMappingURL=framework-bootstrap.d.ts.map

package/dist/providers/framework-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-bootstrap.d.ts","sourceRoot":"","sources":["../../src/providers/framework-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAoCxE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AAE3E;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,GAAE,kBAAuB,EAClC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA2Mf"}

package/dist/providers/framework-bootstrap.js

@@ -0,0 +1,153 @@
+import { BrowserDomAdapter } from "../rendering/dom/browser-dom-adapter.js";
+import { SkeletonValidator } from "../rendering/skeleton/skeleton-validator.js";
+import { SkeletonRenderer } from "../rendering/skeleton/skeleton-renderer.js";
+import { ComponentMetadataRegistry } from "../core/component-metadata-registry.js";
+import { ComponentInstanceRegistry } from "../core/component-instance-registry.js";
+import { DomContextHostResolver } from "../rendering/dom-context/dom-context-host-resolver.js";
+import { ExpressionParserService } from "../rendering/expression-parser/expression-parser.service.js";
+import { ASTEvaluator } from "../rendering/expression-parser/evaluators/ast.evaluator.js";
+import { SafeMethodValidator } from "../rendering/expression-parser/safe-methods.js";
+import { ExpressionResolver } from "../rendering/bindings/expression-resolver.js";
+import { PropertyExtractor } from "../rendering/bindings/property-extractor.js";
+import { ManagedElementResolver } from "../rendering/managed-host/managed-element-resolver.js";
+import { ManagedElementRegistry } from "../rendering/managed-host/managed-element-registry.js";
+import { OutletResolver } from "../rendering/managed-host/outlet-resolver.js";
+import { HostStyleMigrator } from "../rendering/managed-host/host-style-migrator.js";
+import { BindingResolver } from "../rendering/bindings/binding-resolver.js";
+import { ErrorRenderer } from "../rendering/pipeline/error-renderer.js";
+import { TemplateCompiler } from "../rendering/templates/template-compiler.js";
+import { TemplateAnalyzer } from "../rendering/templates/template-analyzer.js";
+import { TemplateCompilationCache } from "../rendering/templates/template-compilation-cache.js";
+import { RenderPipeline } from "../rendering/pipeline/render-pipeline.js";
+import { DomContextFactory } from "../rendering/dom-context/dom-context-factory.js";
+import { TemplateProviderFactory } from "../rendering/templates/template-provider.factory.js";
+import { RenderEngine } from "../rendering/render-engine.js";
+import { SmartElementFactory } from "../registration/smart-element-factory.js";
+import { SmartElementRegistrar } from "../registration/smart-element-registrar.js";
+import { DefaultSmartComponentFactory } from "../decorators/smart/smart-component-factory.js";
+import { DefaultListenerMetadataRegistry } from "../decorators/listen/listener-metadata-registry.js";
+import { DefaultListenerInitializer } from "../decorators/listen/listener-initializer.js";
+import { DependencyTracker } from "../reactive/dependency-tracker.js";
+import { WeakRefObjectRegistry } from "../utils/object-registry.js";
+import { BrowserNavigationService } from "../components/smart-router/navigation.js";
+import { SharedStylesRegistry } from "../rendering/styles/shared-styles-registry.js";
+/**
+ * Registers all framework services in the given registry.
+ *
+ * @description
+ * Centralised composition root for the SmartComponents framework.
+ * Every concrete instantiation lives here — the rest of the codebase
+ * depends only on abstractions resolved through the registry.
+ *
+ * @param registry - Service registry to populate
+ * @param overrides - Optional map of service overrides. Tokens present here
+ *                    replace the framework default — the default is never registered.
+ * @param options - Optional framework configuration options.
+ * @throws Error if registry is null or undefined
+ *
+ * @example
+ * ```typescript
+ * // Default bootstrap (strict TC39 Stage 3 mode)
+ * await bootstrapFramework(Services);
+ *
+ * // With SSR adapter override
+ * await bootstrapFramework(Services, {
+ *   'IDomAdapter': () => new SSRDomAdapter()
+ * });
+ *
+ * // Sandbox/playground mode — accept any decorator system
+ * await bootstrapFramework(Services, {}, { decorators: 'auto' });
+ * ```
+ */
+export async function bootstrapFramework(registry, overrides = {}, options = {}) {
+    if (!registry)
+        throw new Error("Service registry is required");
+    const decoratorMode = options.decorators ?? "strict";
+    const register = (token, defaultFactory) => {
+        if (token in overrides) {
+            registry.register(token, overrides[token]);
+            return;
+        }
+        if (!registry.has(token)) {
+            registry.register(token, defaultFactory);
+        }
+    };
+    register("IDecoratorMode", () => decoratorMode);
+    // DOM
+    register("IDomAdapter", () => new BrowserDomAdapter());
+    // Reactivity
+    register("IDependencyTracker", () => new DependencyTracker());
+    // Object Registry
+    register("IObjectRegistry", () => new WeakRefObjectRegistry());
+    // Safe method validation (security boundary)
+    register("ISafeMethodValidator", () => new SafeMethodValidator());
+    // Navigation
+    register("INavigationService", () => new BrowserNavigationService());
+    // Shared styles (adoptedStyleSheets across all Shadow Roots)
+    register("ISharedStylesRegistry", () => new SharedStylesRegistry());
+    // Skeleton
+    register("ISkeletonValidator", () => new SkeletonValidator());
+    register("ISkeletonRenderer", () => new SkeletonRenderer(registry.get("IDomAdapter"), registry.get("ISkeletonValidator")));
+    // Metadata & instances
+    register("IComponentMetadataRegistry", () => new ComponentMetadataRegistry());
+    register("IComponentInstanceRegistry", () => new ComponentInstanceRegistry());
+    // Host resolution
+    register("IHostResolver", () => new DomContextHostResolver());
+    // Expression parsing
+    register("IExpressionParser", () => new ExpressionParserService());
+    register("IEvaluator", () => new ASTEvaluator(registry.get("ISafeMethodValidator")));
+    // Bindings
+    register("IExpressionResolver", () => new ExpressionResolver(registry.get("IExpressionParser"), registry.get("IEvaluator")));
+    register("IPropertyExtractor", () => new PropertyExtractor(registry.get("IExpressionParser")));
+    register("IManagedElementRegistry", () => ManagedElementRegistry);
+    register("IOutletResolver", () => new OutletResolver());
+    register("IHostStyleMigrator", () => new HostStyleMigrator());
+    register("IManagedElementResolver", () => new ManagedElementResolver(registry.get("IManagedElementRegistry")));
+    register("IBindingResolver", () => new BindingResolver(registry.get("IExpressionResolver"), registry.get("IPropertyExtractor"), registry.get("IManagedElementResolver"), registry.get("IDependencyTracker"), registry.get("IObjectRegistry")));
+    // Templates
+    register("IErrorRenderer", () => new ErrorRenderer(registry.get("IDomAdapter")));
+    register("ITemplateCompiler", () => new TemplateCompiler(registry.get("IDomAdapter"), registry.get("IBindingResolver"), registry.get("IComponentMetadataRegistry"), registry.get("IManagedElementRegistry")));
+    register("ITemplateAnalyzer", () => new TemplateAnalyzer());
+    register("ITemplateCompilationCache", () => new TemplateCompilationCache());
+    // Pipeline
+    register("IRenderPipeline", () => new RenderPipeline(registry.get("IHostResolver"), registry.get("ITemplateCompiler"), registry.get("IErrorRenderer"), registry.get("IOutletResolver"), registry.get("IHostStyleMigrator"), registry.get("IManagedElementRegistry"), registry.get("IListenerInitializer"), registry.get("ISharedStylesRegistry")));
+    // DOM Context
+    register("IDomContextFactory", () => new DomContextFactory());
+    // Template Provider
+    register("ITemplateProvider", () => TemplateProviderFactory.createDefault(registry.get("IComponentMetadataRegistry")));
+    // Render Engine
+    register("IRenderEngine", () => new RenderEngine(registry.get("ISkeletonRenderer"), registry.get("IRenderPipeline"), registry.get("IDomContextFactory"), registry.get("ITemplateCompilationCache"), registry.get("ITemplateAnalyzer"), registry.get("ITemplateProvider"), registry.get("IComponentInstanceRegistry"), registry.get("IComponentMetadataRegistry")));
+    // Smart Component class factory (@Smart decorator)
+    register("ISmartComponentFactory", () => new DefaultSmartComponentFactory());
+    // Listener metadata registry (@Listen decorator)
+    register("IListenerMetadataRegistry", () => new DefaultListenerMetadataRegistry());
+    register("IListenerInitializer", () => new DefaultListenerInitializer());
+    // Smart Element infrastructure
+    register("ISmartElementFactory", () => new SmartElementFactory(registry));
+    register("ISmartElementRegistrar", () => new SmartElementRegistrar(registry, registry.get("ISmartElementFactory")));
+    // Framework custom elements (dynamic imports avoid HTMLElement in Node)
+    if (typeof customElements !== "undefined") {
+        const [{ SmartForElement }, { SmartActionElement }, { SmartLinkElement }, { SmartRouterElement }, { SmartSelectElement },] = await Promise.all([
+            import("../components/smart-for/smart-for-element.js"),
+            import("../components/smart-action/smart-action-element.js"),
+            import("../components/smart-link/smart-link-element.js"),
+            import("../components/smart-router/smart-router-element.js"),
+            import("../components/smart-select/smart-select-element.js"),
+        ]);
+        const behaviors = [
+            ["smart-for", SmartForElement],
+            ["smart-action", SmartActionElement],
+            ["smart-link", SmartLinkElement],
+            ["smart-router", SmartRouterElement],
+        ];
+        for (const [tag, elementClass] of behaviors) {
+            if (!customElements.get(tag)) {
+                customElements.define(tag, elementClass);
+            }
+        }
+        if (!customElements.get("smart-select")) {
+            customElements.define("smart-select", SmartSelectElement);
+        }
+    }
+}
+//# sourceMappingURL=framework-bootstrap.js.map

package/dist/providers/framework-bootstrap.js.map

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

package/dist/providers/framework-element-registration.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=framework-element-registration.d.ts.map

package/dist/providers/framework-element-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-element-registration.d.ts","sourceRoot":"","sources":["../../src/providers/framework-element-registration.ts"],"names":[],"mappings":""}

package/dist/providers/framework-element-registration.js

@@ -0,0 +1,42 @@
+/**
+ * Implements the responsibility of registering all framework-provided custom elements.
+ *
+ * @description
+ * Centralises element registration so individual element files have no
+ * import side-effects. Behaviors are marked as smart tags (so the template
+ * compiler routes object values through SmartInputStore). smart-select is
+ * intentionally NOT marked — the parent binding resolver must recurse into
+ * its children.
+ *
+ * Separated from framework-bootstrap.ts because `class X extends HTMLElement`
+ * fails in Node.js (no global HTMLElement). Dynamically imported by
+ * bootstrapFramework() only in browser environments.
+ *
+ * @example
+ * ```typescript
+ * // Imported automatically by bootstrapFramework() — no manual import needed.
+ * await bootstrapFramework(Services);
+ * ```
+ */
+import { markSmartTag } from '../registration/smart-tags.js';
+import { SmartForElement } from '../components/smart-for/smart-for-element.js';
+import { SmartActionElement } from '../components/smart-action/smart-action-element.js';
+import { SmartLinkElement } from '../components/smart-link/smart-link-element.js';
+import { SmartRouterElement } from '../components/smart-router/smart-router-element.js';
+import { SmartSelectElement } from '../components/smart-select/smart-select-element.js';
+const behaviors = [
+    ['smart-for', SmartForElement],
+    ['smart-action', SmartActionElement],
+    ['smart-link', SmartLinkElement],
+    ['smart-router', SmartRouterElement],
+];
+for (const [tag, elementClass] of behaviors) {
+    markSmartTag(tag);
+    if (!customElements.get(tag)) {
+        customElements.define(tag, elementClass);
+    }
+}
+if (!customElements.get('smart-select')) {
+    customElements.define('smart-select', SmartSelectElement);
+}
+//# sourceMappingURL=framework-element-registration.js.map

package/dist/providers/framework-element-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-element-registration.js","sourceRoot":"","sources":["../../src/providers/framework-element-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAExF,MAAM,SAAS,GAA8C;IAC3D,CAAC,WAAW,EAAE,eAAe,CAAC;IAC9B,CAAC,cAAc,EAAE,kBAAkB,CAAC;IACpC,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAChC,CAAC,cAAc,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;IAC5C,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;IACxC,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;AAC5D,CAAC"}

package/dist/providers/service-provider.d.ts

@@ -0,0 +1,70 @@
+import { IServiceRegistry, type ServiceToken } from "./service-provider.interface.js";
+/**
+ * Global Service Registry Facade.
+ *
+ * @description
+ * Provides a single global access point to the service registry
+ * while allowing the underlying implementation to be swapped at runtime.
+ *
+ * @remarks
+ * This facade enables integration with external DI containers like:
+ * - TSyringe
+ * - InversifyJS
+ * - Angular's Injector
+ * - Custom implementations
+ */
+declare class ServiceRegistryFacade implements IServiceRegistry {
+    private static readonly SERVICE_PROVIDER_TOKEN;
+    private implementation;
+    private hasRegistrations;
+    /**
+     * Replace the underlying registry implementation.
+     *
+     * @description
+     * Use this to integrate with external DI containers **before** calling
+     * `bootstrapFramework()`. Swapping after bootstrap destroys all registered
+     * framework services and will cause runtime errors.
+     *
+     * @remarks
+     * The custom implementation must honour these contracts:
+     * - `get()` must return the **same singleton** on every call for a given token.
+     * - `register()` must treat factory functions lazily (invoke on first `get()`, not on `register()`).
+     *
+     * @param impl - New registry implementation
+     * @throws Error if `register()` has already been called (i.e. after bootstrap)
+     *
+     * @example
+     * ```typescript
+     * // Must be called BEFORE bootstrapFramework()
+     * const angularAdapter = new AngularInjectorAdapter(injector);
+     * Services.useImplementation(angularAdapter);
+     * bootstrapFramework(Services);
+     * ```
+     */
+    useImplementation(impl: IServiceRegistry): void;
+    register<T>(token: ServiceToken<T>, instanceOrFactory: T | (() => T)): void;
+    get<T>(token: ServiceToken<T>): T;
+    has(token: ServiceToken): boolean;
+    clear(): void;
+}
+/**
+ * Global service registry instance.
+ *
+ * @description
+ * Use this in your Composition Root to register services at application startup.
+ * Consumers should depend on IServiceProvider interface, not this global instance.
+ *
+ * @example
+ * ```typescript
+ * // Composition Root (main.ts or bootstrap.ts)
+ * Services.register(TodoService, () => new TodoService());
+ * Services.register(HttpService, new HttpService());
+ *
+ * // Consumer (RenderEngine, LifecycleManager, etc.)
+ * constructor(private serviceProvider: IServiceProvider) {}
+ * ```
+ */
+export declare const Services: ServiceRegistryFacade;
+export type { IServiceProvider, IServiceRegistry, } from "./service-provider.interface.js";
+export { DefaultServiceRegistry } from "./default-service-provider.js";
+//# sourceMappingURL=service-provider.d.ts.map

package/dist/providers/service-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-provider.d.ts","sourceRoot":"","sources":["../../src/providers/service-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAGzC;;;;;;;;;;;;;GAaG;AACH,cAAM,qBAAsB,YAAW,gBAAgB;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAsB;IAEpE,OAAO,CAAC,cAAc,CAAkD;IACxE,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAoB/C,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI;IAW3E,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC;IAOjC,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAOjC,KAAK,IAAI,IAAI;CAKd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,uBAA8B,CAAC;AAGpD,YAAY,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/providers/service-provider.interface.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Token used to identify services in the DI container.
+ * The any in constructor signatures is type-level only and unavoidable for generic constructors.
+ */
+export type ServiceToken<T = unknown> = string | symbol | (abstract new (...args: any[]) => T) | (new (...args: any[]) => T);
+/**
+ * Interface for Service Provider (Dependency Inversion Principle - Read Access)
+ *
+ * @description
+ * Defines read-only access to the service container.
+ * Consumers should depend on this interface instead of the full registry
+ * to follow Interface Segregation Principle.
+ *
+ * @remarks
+ * This interface is the foundation for Dependency Injection in SmartComponents.
+ * Classes should receive IServiceProvider in their constructor, not the full registry.
+ */
+export interface IServiceProvider {
+    /**
+     * Retrieves a service instance by token
+     * @param token - Service identifier (class constructor or string)
+     * @returns Service instance
+     * @throws Error if service is not registered
+     */
+    get<T>(token: ServiceToken<T>): T;
+    /**
+     * Checks if a service is registered
+     * @param token - Service identifier
+     * @returns true if registered, false otherwise
+     */
+    has(token: ServiceToken): boolean;
+}
+/**
+ * Interface for Service Registry (Dependency Inversion Principle - Write Access)
+ *
+ * @description
+ * Extends IServiceProvider with registration capabilities.
+ * Only the Composition Root should use this interface.
+ *
+ * @remarks
+ * Allows swapping the underlying DI container (e.g., use TSyringe, InversifyJS).
+ */
+export interface IServiceRegistry extends IServiceProvider {
+    /**
+     * Registers a service instance or factory function
+     * @param token - Service identifier (class constructor or string)
+     * @param instanceOrFactory - Service instance or factory function
+     */
+    register<T>(token: ServiceToken<T>, instanceOrFactory: T | (() => T)): void;
+    /**
+     * Clears all registered services
+     */
+    clear(): void;
+}
+//# sourceMappingURL=service-provider.interface.d.ts.map

package/dist/providers/service-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-provider.interface.d.ts","sourceRoot":"","sources":["../../src/providers/service-provider.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAChC,MAAM,GACN,MAAM,GACN,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,GACpC,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAGhC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAElC;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAE5E;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/providers/service-provider.interface.js

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

package/dist/providers/service-provider.interface.js.map

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

package/dist/providers/service-provider.js

@@ -0,0 +1,102 @@
+import { DefaultServiceRegistry } from "./default-service-provider.js";
+/**
+ * Global Service Registry Facade.
+ *
+ * @description
+ * Provides a single global access point to the service registry
+ * while allowing the underlying implementation to be swapped at runtime.
+ *
+ * @remarks
+ * This facade enables integration with external DI containers like:
+ * - TSyringe
+ * - InversifyJS
+ * - Angular's Injector
+ * - Custom implementations
+ */
+class ServiceRegistryFacade {
+    static SERVICE_PROVIDER_TOKEN = "IServiceProvider";
+    implementation = new DefaultServiceRegistry();
+    hasRegistrations = false;
+    /**
+     * Replace the underlying registry implementation.
+     *
+     * @description
+     * Use this to integrate with external DI containers **before** calling
+     * `bootstrapFramework()`. Swapping after bootstrap destroys all registered
+     * framework services and will cause runtime errors.
+     *
+     * @remarks
+     * The custom implementation must honour these contracts:
+     * - `get()` must return the **same singleton** on every call for a given token.
+     * - `register()` must treat factory functions lazily (invoke on first `get()`, not on `register()`).
+     *
+     * @param impl - New registry implementation
+     * @throws Error if `register()` has already been called (i.e. after bootstrap)
+     *
+     * @example
+     * ```typescript
+     * // Must be called BEFORE bootstrapFramework()
+     * const angularAdapter = new AngularInjectorAdapter(injector);
+     * Services.useImplementation(angularAdapter);
+     * bootstrapFramework(Services);
+     * ```
+     */
+    useImplementation(impl) {
+        if (!impl) {
+            throw new Error("[ServiceRegistryFacade] Implementation must not be null or undefined.");
+        }
+        if (impl === this) {
+            throw new Error("[ServiceRegistryFacade] Cannot use the facade as its own implementation: would cause infinite recursion.");
+        }
+        if (this.hasRegistrations) {
+            throw new Error("[ServiceRegistryFacade] Cannot swap implementation after services have been registered. " +
+                "Call useImplementation() before bootstrapFramework().");
+        }
+        this.implementation = impl;
+    }
+    register(token, instanceOrFactory) {
+        if (token === ServiceRegistryFacade.SERVICE_PROVIDER_TOKEN) {
+            throw new Error(`[ServiceRegistryFacade] Token '${ServiceRegistryFacade.SERVICE_PROVIDER_TOKEN}' is reserved. ` +
+                "The service provider is always the facade itself and cannot be overridden.");
+        }
+        this.hasRegistrations = true;
+        this.implementation.register(token, instanceOrFactory);
+    }
+    get(token) {
+        if (token === ServiceRegistryFacade.SERVICE_PROVIDER_TOKEN) {
+            return this;
+        }
+        return this.implementation.get(token);
+    }
+    has(token) {
+        if (token === ServiceRegistryFacade.SERVICE_PROVIDER_TOKEN) {
+            return true;
+        }
+        return this.implementation.has(token);
+    }
+    clear() {
+        this.hasRegistrations = false;
+        this.implementation.clear();
+        this.implementation = new DefaultServiceRegistry();
+    }
+}
+/**
+ * Global service registry instance.
+ *
+ * @description
+ * Use this in your Composition Root to register services at application startup.
+ * Consumers should depend on IServiceProvider interface, not this global instance.
+ *
+ * @example
+ * ```typescript
+ * // Composition Root (main.ts or bootstrap.ts)
+ * Services.register(TodoService, () => new TodoService());
+ * Services.register(HttpService, new HttpService());
+ *
+ * // Consumer (RenderEngine, LifecycleManager, etc.)
+ * constructor(private serviceProvider: IServiceProvider) {}
+ * ```
+ */
+export const Services = new ServiceRegistryFacade();
+export { DefaultServiceRegistry } from "./default-service-provider.js";
+//# sourceMappingURL=service-provider.js.map

package/dist/providers/service-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-provider.js","sourceRoot":"","sources":["../../src/providers/service-provider.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,MAAM,qBAAqB;IACjB,MAAM,CAAU,sBAAsB,GAAG,kBAAkB,CAAC;IAE5D,cAAc,GAAqB,IAAI,sBAAsB,EAAE,CAAC;IAChE,gBAAgB,GAAG,KAAK,CAAC;IAEjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,iBAAiB,CAAC,IAAsB;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,KAAM,IAAoC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,0FAA0F;gBACxF,uDAAuD,CAC1D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAI,KAAsB,EAAE,iBAAgC;QAClE,IAAI,KAAK,KAAK,qBAAqB,CAAC,sBAAsB,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CACb,kCAAkC,qBAAqB,CAAC,sBAAsB,iBAAiB;gBAC7F,4EAA4E,CAC/E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACzD,CAAC;IAED,GAAG,CAAI,KAAsB;QAC3B,IAAI,KAAK,KAAK,qBAAqB,CAAC,sBAAsB,EAAE,CAAC;YAC3D,OAAO,IAAoB,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,KAAmB;QACrB,IAAI,KAAK,KAAK,qBAAqB,CAAC,sBAAsB,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,IAAI,sBAAsB,EAAE,CAAC;IACrD,CAAC;;AAGH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;AAOpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}