smart-lifecycle 0.1.1

package/dist/rendering/lifecycle/lifecycle-coordinator.js

@@ -0,0 +1,142 @@
+import { MountSession } from './mount-session.js';
+let sessionIdCounter = 0;
+/**
+ * Implements the responsibility of coordinating mount sessions for a SmartComponent.
+ *
+ * @description
+ * Manages multiple DOM mounts for a single component instance (for shared components).
+ * Tracks mount count and executes lifecycle transitions:
+ * - 0→1: Initialize component once (data subscriptions)
+ * - 1→0: Cleanup component (unsubscribe, destroy)
+ *
+ * @template T - The SmartComponent type
+ *
+ * @example
+ * ```typescript
+ * const coordinator = new LifecycleCoordinator(component);
+ * const handle = coordinator.attachMount({ hostElement, domContext, metadata });
+ * // ... later
+ * handle.dispose();
+ * ```
+ */
+export class LifecycleCoordinator {
+    component;
+    sessions = new Map();
+    initialized = false;
+    /**
+     * Creates a lifecycle coordinator for a component.
+     *
+     * @param component - The component instance being coordinated
+     * @throws Error if component is null or undefined
+     */
+    constructor(component) {
+        this.component = component;
+        if (!component)
+            throw new Error('Component is required');
+    }
+    /**
+     * Gets the current mount count.
+     */
+    get mountCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Attaches a new mount session.
+     *
+     * @param options - Mount options (host, context, metadata)
+     * @returns Mount handle for cleanup
+     * @throws Error if options are invalid
+     */
+    attachMount(options) {
+        if (!options)
+            throw new Error('Mount options are required');
+        if (!options.hostElement)
+            throw new Error('Host element is required');
+        if (!options.domContext)
+            throw new Error('DOM context is required');
+        if (!options.metadata)
+            throw new Error('Metadata is required');
+        const sessionId = `mount-${++sessionIdCounter}`;
+        const session = new MountSession(sessionId, options.hostElement, options.domContext);
+        this.sessions.set(sessionId, session);
+        // Wire lifecycle manager handleMount hook
+        const lifecycle = this.component._lifecycleManager;
+        if (lifecycle && typeof lifecycle.handleMount === 'function') {
+            const ctx = {
+                mountId: sessionId,
+                hostElement: options.hostElement,
+                domContext: options.domContext,
+                component: this.component,
+                addDisposer: (fn) => session.addDisposer(fn)
+            };
+            lifecycle.handleMount(ctx);
+        }
+        return {
+            sessionId,
+            dispose: () => this.detachMount(sessionId)
+        };
+    }
+    /**
+     * Marks component as initialized (called after initializer executes).
+     */
+    markInitialized() {
+        this.initialized = true;
+    }
+    /**
+     * Detaches a mount session.
+     *
+     * @param sessionId - Session identifier to detach
+     */
+    detachMount(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        // Wire lifecycle manager handleUnmount hook
+        const lifecycle = this.component._lifecycleManager;
+        if (lifecycle && typeof lifecycle.handleUnmount === 'function') {
+            lifecycle.handleUnmount(sessionId);
+        }
+        session.dispose();
+        this.sessions.delete(sessionId);
+        // Transition N→0: Cleanup component
+        if (this.mountCount === 0) {
+            this.initialized = false;
+            if (this.component.onDestroy) {
+                this.component.onDestroy();
+            }
+        }
+    }
+    /**
+     * Gets a mount session by ID.
+     *
+     * @param sessionId - Session identifier
+     * @returns MountSession or undefined if not found
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Gets all active sessions.
+     *
+     * @returns Array of all mount sessions
+     */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Checks if component has been initialized.
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Disposes all mount sessions and cleans up the component.
+     */
+    dispose() {
+        const sessionIds = Array.from(this.sessions.keys());
+        for (const sessionId of sessionIds) {
+            this.detachMount(sessionId);
+        }
+    }
+}
+//# sourceMappingURL=lifecycle-coordinator.js.map

package/dist/rendering/lifecycle/lifecycle-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-coordinator.js","sourceRoot":"","sources":["../../../src/rendering/lifecycle/lifecycle-coordinator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AAElE,IAAI,gBAAgB,GAAG,CAAC,CAAC;AAmBzB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,oBAAoB;IAUF;IATrB,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IACnD,WAAW,GAAG,KAAK,CAAC;IAE5B;;;;;OAKG;IACH,YAA6B,SAAY;QAAZ,cAAS,GAAT,SAAS,CAAG;QACvC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,OAA2B;QACrC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAE/D,MAAM,SAAS,GAAG,SAAS,EAAE,gBAAgB,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,SAAS,EACT,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,CACnB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEtC,0CAA0C;QAC1C,MAAM,SAAS,GAAI,IAAI,CAAC,SAAiB,CAAC,iBAAqD,CAAC;QAChG,IAAI,SAAS,IAAI,OAAQ,SAAiB,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACtE,MAAM,GAAG,GAAqB;gBAC5B,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;aAC7C,CAAC;YACD,SAAiB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QAED,OAAO;YACL,SAAS;YACT,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,SAAyB;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,4CAA4C;QAC5C,MAAM,SAAS,GAAI,IAAI,CAAC,SAAiB,CAAC,iBAAqD,CAAC;QAChG,IAAI,SAAS,IAAI,OAAQ,SAAiB,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;YACvE,SAAiB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEhC,oCAAoC;QACpC,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAyB;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF"}

package/dist/rendering/lifecycle/mount-context.interface.d.ts

@@ -0,0 +1,50 @@
+import type { IDomContext } from '../dom-context/dom-context.interface.js';
+import type { MountSessionId } from './mount-session.js';
+import type { Unsubscribe } from '../../reactive/signal.js';
+/**
+ * Defines the responsibility of providing mount-specific context to lifecycle managers.
+ *
+ * @description
+ * Represents the context for a single DOM mount session.
+ * Lifecycle managers receive this context per-mount, enabling Shared mode
+ * where multiple hosts share a single component instance.
+ *
+ * @example
+ * ```typescript
+ * class MyLifecycleManager extends SmartLifecycleManager<MyComponent> {
+ *   onMount(ctx: IMountContext<MyComponent>): void {
+ *     const button = ctx.hostElement.querySelector('button');
+ *     ctx.addDisposer(() => cleanup());
+ *   }
+ * }
+ * ```
+ */
+export interface IMountContext<TComponent> {
+    /**
+     * Unique identifier for this mount session
+     */
+    readonly mountId: MountSessionId;
+    /**
+     * The custom element host for this mount
+     */
+    readonly hostElement: HTMLElement;
+    /**
+     * The DOM context for this mount (isolated rendering)
+     */
+    readonly domContext: IDomContext;
+    /**
+     * The component instance being mounted
+     */
+    readonly component: TComponent;
+    /**
+     * Registers a cleanup function for this mount session
+     *
+     * @param disposer - Function to execute when mount is disposed
+     *
+     * @remarks
+     * Disposers are called automatically when this mount is removed.
+     * In Shared mode, disposers are per-mount, not per-component.
+     */
+    addDisposer(disposer: Unsubscribe): void;
+}
+//# sourceMappingURL=mount-context.interface.d.ts.map

package/dist/rendering/lifecycle/mount-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-context.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/lifecycle/mount-context.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa,CAAC,UAAU;IACvC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAE/B;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1C"}

package/dist/rendering/lifecycle/mount-context.interface.js

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

package/dist/rendering/lifecycle/mount-context.interface.js.map

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

package/dist/rendering/lifecycle/mount-session.d.ts

@@ -0,0 +1,49 @@
+import type { IDomContext } from '../dom-context/dom-context.interface.js';
+import type { Unsubscribe } from '../../reactive/signal.js';
+/**
+ * Unique identifier for a mount session.
+ */
+export type MountSessionId = string;
+/**
+ * Defines the responsibility of managing a single DOM mount session.
+ *
+ * @description
+ * Represents one host element mounting a SmartComponent.
+ * For shared components, multiple sessions can exist per component instance.
+ * Each session has its own host element and DOM context for isolated rendering.
+ *
+ * @example
+ * ```typescript
+ * const session = new MountSession('mount-1', hostElement, domContext);
+ * session.addDisposer(() => cleanup());
+ * session.dispose(); // Idempotent cleanup
+ * ```
+ */
+export declare class MountSession {
+    readonly id: MountSessionId;
+    readonly hostElement: HTMLElement;
+    readonly domContext: IDomContext;
+    private disposers;
+    private disposed;
+    /**
+     * Creates a new mount session.
+     *
+     * @param id - Unique session identifier
+     * @param hostElement - The custom element host for this mount
+     * @param domContext - The DOM context for this mount
+     * @throws Error if any parameter is null or undefined
+     */
+    constructor(id: MountSessionId, hostElement: HTMLElement, domContext: IDomContext);
+    /**
+     * Adds a disposer function to be called on cleanup.
+     *
+     * @param disposer - Function to execute on dispose
+     */
+    addDisposer(disposer: Unsubscribe): void;
+    /**
+     * Disposes this mount session.
+     * Idempotent - safe to call multiple times.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=mount-session.d.ts.map

package/dist/rendering/lifecycle/mount-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-session.d.ts","sourceRoot":"","sources":["../../../src/rendering/lifecycle/mount-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;aAaL,EAAE,EAAE,cAAc;aAClB,WAAW,EAAE,WAAW;aACxB,UAAU,EAAE,WAAW;IAdzC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;OAOG;gBAEe,EAAE,EAAE,cAAc,EAClB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,WAAW;IAOzC;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAKxC;;;OAGG;IACH,OAAO,IAAI,IAAI;CAehB"}

package/dist/rendering/lifecycle/mount-session.js

@@ -0,0 +1,71 @@
+/**
+ * Defines the responsibility of managing a single DOM mount session.
+ *
+ * @description
+ * Represents one host element mounting a SmartComponent.
+ * For shared components, multiple sessions can exist per component instance.
+ * Each session has its own host element and DOM context for isolated rendering.
+ *
+ * @example
+ * ```typescript
+ * const session = new MountSession('mount-1', hostElement, domContext);
+ * session.addDisposer(() => cleanup());
+ * session.dispose(); // Idempotent cleanup
+ * ```
+ */
+export class MountSession {
+    id;
+    hostElement;
+    domContext;
+    disposers = [];
+    disposed = false;
+    /**
+     * Creates a new mount session.
+     *
+     * @param id - Unique session identifier
+     * @param hostElement - The custom element host for this mount
+     * @param domContext - The DOM context for this mount
+     * @throws Error if any parameter is null or undefined
+     */
+    constructor(id, hostElement, domContext) {
+        this.id = id;
+        this.hostElement = hostElement;
+        this.domContext = domContext;
+        if (!id)
+            throw new Error('Mount session id is required');
+        if (!hostElement)
+            throw new Error('Host element is required');
+        if (!domContext)
+            throw new Error('DOM context is required');
+    }
+    /**
+     * Adds a disposer function to be called on cleanup.
+     *
+     * @param disposer - Function to execute on dispose
+     */
+    addDisposer(disposer) {
+        if (this.disposed)
+            return;
+        this.disposers.push(disposer);
+    }
+    /**
+     * Disposes this mount session.
+     * Idempotent - safe to call multiple times.
+     */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const disposer of this.disposers) {
+            try {
+                disposer();
+            }
+            catch (error) {
+                // Silently handle disposal errors to prevent cascading failures
+            }
+        }
+        this.disposers = [];
+        this.domContext.destroy();
+    }
+}
+//# sourceMappingURL=mount-session.js.map

package/dist/rendering/lifecycle/mount-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-session.js","sourceRoot":"","sources":["../../../src/rendering/lifecycle/mount-session.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAY;IAaL;IACA;IACA;IAdV,SAAS,GAAkB,EAAE,CAAC;IAC9B,QAAQ,GAAG,KAAK,CAAC;IAEzB;;;;;;;OAOG;IACH,YACkB,EAAkB,EAClB,WAAwB,EACxB,UAAuB;QAFvB,OAAE,GAAF,EAAE,CAAgB;QAClB,gBAAW,GAAX,WAAW,CAAa;QACxB,eAAU,GAAV,UAAU,CAAa;QAEvC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,QAAqB;QAC/B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,gEAAgE;YAClE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/rendering/managed-host/host-style-migrator.d.ts

@@ -0,0 +1,55 @@
+import { IHostStyleMigrator } from "./host-style-migrator.interface.js";
+/**
+ * Implements the responsibility of migrating host styling to outlet element.
+ *
+ * @description
+ * Handles the migration of class and id attributes from host to outlet:
+ * - **Class:** Merge and deduplicate, host-first order
+ * - **ID:** Only migrate if outlet has no id (conservative conflict resolution)
+ *
+ * @example
+ * ```typescript
+ * const migrator = new HostStyleMigrator();
+ * migrator.migrate(hostElement, outletElement);
+ * // Host class/id migrated to outlet; host attributes removed
+ * ```
+ */
+export declare class HostStyleMigrator implements IHostStyleMigrator {
+    /**
+     * Migrates class and id from host to outlet element.
+     *
+     * @param hostElement - Source element with class/id to migrate
+     * @param outletElement - Target element to receive styling
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * // Host: <x-foo class="btn primary"></x-foo>
+     * // Outlet: <div class="outlet"></div>
+     * migrator.migrate(host, outlet);
+     * // Result: outlet has class="btn primary outlet"; host has no class
+     *
+     * // ID conflict case:
+     * // Host: <x-foo id="my-id"></x-foo>
+     * // Outlet: <div id="outlet-id"></div>
+     * migrator.migrate(host, outlet);
+     * // Result: outlet keeps "outlet-id"; host keeps "my-id" (conservative)
+     * ```
+     */
+    migrate(hostElement: HTMLElement, outletElement: HTMLElement): void;
+    /**
+     * Migrates class attribute with merge and deduplication.
+     *
+     * @param hostElement - Source element with classes
+     * @param outletElement - Target element to receive classes
+     */
+    private migrateClass;
+    /**
+     * Migrates id attribute with conservative conflict resolution.
+     *
+     * @param hostElement - Source element with id
+     * @param outletElement - Target element to receive id
+     */
+    private migrateId;
+}
+//# sourceMappingURL=host-style-migrator.d.ts.map

package/dist/rendering/managed-host/host-style-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-style-migrator.d.ts","sourceRoot":"","sources":["../../../src/rendering/managed-host/host-style-migrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,GAAG,IAAI;IAenE;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAqCpB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;CAoBlB"}

package/dist/rendering/managed-host/host-style-migrator.interface.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Defines the responsibility of migrating host styling to outlet element.
+ *
+ * @description
+ * Handles the migration of class and id attributes from the host element
+ * to the outlet element within the rendered component.
+ *
+ * **Class Migration:**
+ * - Merge host classes with outlet classes
+ * - Deduplicate tokens
+ * - Host classes have priority (appear first)
+ *
+ * **ID Migration:**
+ * - Only migrate if outlet has no id attribute
+ * - If outlet has id, do NOT overwrite (conservative fallback)
+ * - In conflict case, host keeps its id (not stored in inputs)
+ *
+ * @example
+ * ```typescript
+ * const migrator: IHostStyleMigrator = new HostStyleMigrator();
+ * migrator.migrate(hostElement, outletElement);
+ * // Host class/id attributes are migrated to outlet
+ * ```
+ */
+export interface IHostStyleMigrator {
+    /**
+     * Migrates class and id from host to outlet element.
+     *
+     * @param hostElement - Source element with class/id to migrate
+     * @param outletElement - Target element to receive styling
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * // Before: <host class="btn"></host> with outlet <div class="outlet"></div>
+     * migrator.migrate(host, outlet);
+     * // After: host has no class; outlet has class="btn outlet"
+     * ```
+     */
+    migrate(hostElement: HTMLElement, outletElement: HTMLElement): void;
+}
+//# sourceMappingURL=host-style-migrator.interface.d.ts.map

package/dist/rendering/managed-host/host-style-migrator.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-style-migrator.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/managed-host/host-style-migrator.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;CACrE"}

package/dist/rendering/managed-host/host-style-migrator.interface.js

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

package/dist/rendering/managed-host/host-style-migrator.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-style-migrator.interface.js","sourceRoot":"","sources":["../../../src/rendering/managed-host/host-style-migrator.interface.ts"],"names":[],"mappings":""}

package/dist/rendering/managed-host/host-style-migrator.js

@@ -0,0 +1,105 @@
+/**
+ * Implements the responsibility of migrating host styling to outlet element.
+ *
+ * @description
+ * Handles the migration of class and id attributes from host to outlet:
+ * - **Class:** Merge and deduplicate, host-first order
+ * - **ID:** Only migrate if outlet has no id (conservative conflict resolution)
+ *
+ * @example
+ * ```typescript
+ * const migrator = new HostStyleMigrator();
+ * migrator.migrate(hostElement, outletElement);
+ * // Host class/id migrated to outlet; host attributes removed
+ * ```
+ */
+export class HostStyleMigrator {
+    /**
+     * Migrates class and id from host to outlet element.
+     *
+     * @param hostElement - Source element with class/id to migrate
+     * @param outletElement - Target element to receive styling
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * // Host: <x-foo class="btn primary"></x-foo>
+     * // Outlet: <div class="outlet"></div>
+     * migrator.migrate(host, outlet);
+     * // Result: outlet has class="btn primary outlet"; host has no class
+     *
+     * // ID conflict case:
+     * // Host: <x-foo id="my-id"></x-foo>
+     * // Outlet: <div id="outlet-id"></div>
+     * migrator.migrate(host, outlet);
+     * // Result: outlet keeps "outlet-id"; host keeps "my-id" (conservative)
+     * ```
+     */
+    migrate(hostElement, outletElement) {
+        if (!hostElement) {
+            throw new Error("Host element is required");
+        }
+        if (!outletElement) {
+            throw new Error("Outlet element is required");
+        }
+        // Migrate class attribute
+        this.migrateClass(hostElement, outletElement);
+        // Migrate id attribute (conservative: only if outlet has no id)
+        this.migrateId(hostElement, outletElement);
+    }
+    /**
+     * Migrates class attribute with merge and deduplication.
+     *
+     * @param hostElement - Source element with classes
+     * @param outletElement - Target element to receive classes
+     */
+    migrateClass(hostElement, outletElement) {
+        const hostClass = hostElement.getAttribute("class");
+        if (!hostClass) {
+            return; // No class to migrate
+        }
+        // Parse host classes
+        const hostClasses = hostClass
+            .split(/\s+/)
+            .map((cls) => cls.trim())
+            .filter((cls) => cls.length > 0);
+        if (hostClasses.length === 0) {
+            return;
+        }
+        // Get outlet classes
+        const outletClasses = Array.from(outletElement.classList);
+        // Merge: host-first order, deduplicate
+        const mergedClasses = [...hostClasses];
+        for (const cls of outletClasses) {
+            if (!mergedClasses.includes(cls)) {
+                mergedClasses.push(cls);
+            }
+        }
+        // Apply merged classes to outlet
+        outletElement.className = mergedClasses.join(" ");
+        // Remove class from host
+        hostElement.removeAttribute("class");
+    }
+    /**
+     * Migrates id attribute with conservative conflict resolution.
+     *
+     * @param hostElement - Source element with id
+     * @param outletElement - Target element to receive id
+     */
+    migrateId(hostElement, outletElement) {
+        const hostId = hostElement.getAttribute("id");
+        if (!hostId) {
+            return; // No id to migrate
+        }
+        const outletId = outletElement.getAttribute("id");
+        if (outletId) {
+            // Conservative: Do NOT overwrite outlet id
+            // Host keeps its id (not stored in inputs, not removed)
+            return;
+        }
+        // Safe to migrate: outlet has no id
+        outletElement.setAttribute("id", hostId);
+        hostElement.removeAttribute("id");
+    }
+}
+//# sourceMappingURL=host-style-migrator.js.map

package/dist/rendering/managed-host/host-style-migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-style-migrator.js","sourceRoot":"","sources":["../../../src/rendering/managed-host/host-style-migrator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,iBAAiB;IAC5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,WAAwB,EAAE,aAA0B;QAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAE9C,gEAAgE;QAChE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAClB,WAAwB,EACxB,aAA0B;QAE1B,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,sBAAsB;QAChC,CAAC;QAED,qBAAqB;QACrB,MAAM,WAAW,GAAG,SAAS;aAC1B,KAAK,CAAC,KAAK,CAAC;aACZ,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;aACxB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEnC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,qBAAqB;QACrB,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAE1D,uCAAuC;QACvC,MAAM,aAAa,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,aAAa,CAAC,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAElD,yBAAyB;QACzB,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACK,SAAS,CACf,WAAwB,EACxB,aAA0B;QAE1B,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,mBAAmB;QAC7B,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,2CAA2C;YAC3C,wDAAwD;YACxD,OAAO;QACT,CAAC;QAED,oCAAoC;QACpC,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/rendering/managed-host/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Managed Host Module
+ *
+ * Provides abstractions for handling managed host elements in the SmartComponents
+ * rendering pipeline. A managed host is an element that is being rendered by the
+ * engine with an associated SmartComponent instance.
+ *
+ * @module managed-host
+ */
+export { IOutletResolver } from "./outlet-resolver.interface.js";
+export { IHostStyleMigrator } from "./host-style-migrator.interface.js";
+export { IManagedElementResolver } from "./managed-element-resolver.interface.js";
+export type { IManagedElementRegistry } from "./managed-element-registry.js";
+export { OutletResolver } from "./outlet-resolver.js";
+export { HostStyleMigrator } from "./host-style-migrator.js";
+export { ManagedElementResolver } from "./managed-element-resolver.js";
+export { ManagedElementRegistry } from "./managed-element-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/rendering/managed-host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/managed-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/rendering/managed-host/index.js

@@ -0,0 +1,14 @@
+/**
+ * Managed Host Module
+ *
+ * Provides abstractions for handling managed host elements in the SmartComponents
+ * rendering pipeline. A managed host is an element that is being rendered by the
+ * engine with an associated SmartComponent instance.
+ *
+ * @module managed-host
+ */
+export { OutletResolver } from "./outlet-resolver.js";
+export { HostStyleMigrator } from "./host-style-migrator.js";
+export { ManagedElementResolver } from "./managed-element-resolver.js";
+export { ManagedElementRegistry } from "./managed-element-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/rendering/managed-host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rendering/managed-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}