@ecopages/lit 0.2.0-alpha.25 → 0.2.0-alpha.27

package/CHANGELOG.md

@@ -8,18 +8,18 @@ All notable changes to `@ecopages/lit` are documented here.
 
 ### Bug Fixes
 
-- Fixed Lit document-shell composition, declarative shadow DOM SSR, nested child serialization, lazy preload handling, explicit render paths, and mixed-renderer boundary resolution.
-- Fixed Lit boundary payload compatibility coverage and removed the plugin/renderer integration-name import cycle.
+- Fixed Lit document-shell composition, declarative shadow DOM SSR, nested child serialization, lazy preload handling, explicit render paths, and mixed-renderer foreign-subtree resolution.
+- Fixed Lit foreign-subtree payload compatibility coverage and removed the plugin/renderer integration-name import cycle.
 
 ### Documentation
 
-- Updated the README to document `.lit.tsx` route ownership, standalone setup, and mixed-renderer Lit boundary handling.
+- Updated the README to document `.lit.tsx` route ownership, standalone setup, and mixed-renderer Lit foreign-subtree handling.
 
 ### Tests
 
-- Updated integration coverage for explicit boundary composition and Node and esbuild compatibility.
-- Added renderer-level coverage for the boundary payload compatibility contract.
+- Updated integration coverage for explicit foreign-subtree composition and Node and esbuild compatibility.
+- Added renderer-level coverage for the foreign-subtree payload compatibility contract.
 
 ### Refactoring
 
-- Moved Lit HTML serialization and child-slot reinjection mechanics into a dedicated utility so the renderer stays focused on preload and boundary orchestration.
+- Moved Lit HTML serialization and child-slot reinjection mechanics into a dedicated utility so the renderer stays focused on preload and foreign-subtree orchestration.

package/README.md

@@ -5,9 +5,11 @@ Integration plugin for [Lit](https://lit.dev/) in Ecopages. Use it when Lit shou
 ## Installation
 
 ```bash
-bun add @ecopages/lit
+bun add @ecopages/lit lit @lit-labs/ssr @lit-labs/ssr-client
 ```
 
+`lit`, `@lit-labs/ssr`, and `@lit-labs/ssr-client` are required peer dependencies for this package.
+
 ## Usage
 
 Register `litPlugin()` in your `eco.config.ts`.
@@ -49,7 +51,7 @@ This setup lets Kita own the page shell while Lit owns the nested Lit component
 
 ## Mixed Rendering
 
-When a non-Lit render pass enters a Lit-owned component boundary, Ecopages hands that boundary to the Lit renderer. That keeps Lit SSR in charge of custom elements, declarative shadow DOM, and Lit-managed child content.
+When a non-Lit render pass reaches a Lit-owned foreign child, Ecopages hands that foreign subtree to the Lit renderer. That keeps Lit SSR in charge of custom elements, declarative shadow DOM, and Lit-managed child content.
 
 Important:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/lit",
-  "version": "0.2.0-alpha.25",
+  "version": "0.2.0-alpha.27",
   "description": "Ecopages lit integration",
   "keywords": [
     "ecopages",
@@ -31,7 +31,7 @@
     "directory": "packages/integrations/lit"
   },
   "peerDependencies": {
-    "@ecopages/core": "0.2.0-alpha.25",
+    "@ecopages/core": "0.2.0-alpha.27",
     "@lit-labs/ssr": "^3.3.0",
     "@lit-labs/ssr-client": "^1.1.7",
     "lit": "^3.2.1"

package/src/lit-renderer.d.ts

@@ -11,24 +11,20 @@ import { IntegrationRenderer, type RenderToResponseContext } from '@ecopages/cor
 export declare class LitRenderer extends IntegrationRenderer<EcoPagesElement> {
     name: string;
     private isFunctionComponent;
-    private resolveQueuedBoundaryChildren;
-    private resolveQueuedBoundaryHtml;
+    private resolveQueuedForeignSubtreeChildren;
+    private resolveQueuedForeignSubtreeHtml;
     protected shouldRenderPageComponent(): boolean;
     private isLitManagedComponent;
     /**
-     * Renders a Lit component boundary for component-level orchestration.
+     * Renders a Lit component for component-level orchestration.
      *
      * SSR-eligible lazy scripts are preloaded first so custom elements registered
      * by the component can render their server markup even when the Lit renderer is
-     * entered through cross-integration boundary handoff.
+     * entered through cross-integration foreign-child handoff.
      *
      * Includes component-scoped dependency assets when declared.
      */
     renderComponent(input: ComponentRenderInput): Promise<ComponentRenderResult>;
-    protected createComponentBoundaryRuntime(options: {
-        boundaryInput: ComponentRenderInput;
-        rendererCache: Map<string, IntegrationRenderer<any>>;
-    }): import("@ecopages/core").ComponentBoundaryRuntime;
     private readonly ssrLazyPreloader;
     /**
      * Detects preload failures that are expected for browser-only modules.

package/src/lit-renderer.js

@@ -13,25 +13,29 @@ class LitRenderer extends IntegrationRenderer {
   isFunctionComponent(component) {
     return typeof component === "function";
   }
-  async resolveQueuedBoundaryChildren(children, queuedResolutionsByToken, resolveToken) {
+  async resolveQueuedForeignSubtreeChildren(children, queuedResolutionsByToken, resolveToken) {
     if (children === void 0) {
       return void 0;
     }
     let renderedChildren = typeof children === "string" ? children : await renderLitValueToString(children);
-    renderedChildren = await this.resolveQueuedBoundaryTokens(
+    renderedChildren = await this.foreignSubtreeExecutionService.resolveQueuedTokens(
       renderedChildren,
       queuedResolutionsByToken,
       resolveToken
     );
     return renderedChildren;
   }
-  async resolveQueuedBoundaryHtml(html, runtimeContext) {
-    const queuedBoundaryResolution = await this.resolveRendererOwnedQueuedBoundaryHtml({
+  async resolveQueuedForeignSubtreeHtml(html, runtimeContext) {
+    const queuedForeignSubtreeResolution = await this.foreignSubtreeExecutionService.resolveQueuedHtml({
+      currentIntegrationName: this.name,
       html,
       runtimeContext,
       queueLabel: "Lit",
+      getOwningRenderer: (integrationName, rendererCache) => this.getIntegrationRendererForName(integrationName, rendererCache),
+      applyAttributesToFirstElement: (resolvedHtml, attributes) => this.htmlTransformer.applyAttributesToFirstElement(resolvedHtml, attributes),
+      dedupeProcessedAssets: (assets) => this.htmlTransformer.dedupeProcessedAssets(assets),
       renderQueuedChildren: async (children, _runtimeContext, queuedResolutionsByToken, resolveToken) => {
-        const renderedChildren = await this.resolveQueuedBoundaryChildren(
+        const renderedChildren = await this.resolveQueuedForeignSubtreeChildren(
           children,
           queuedResolutionsByToken,
           resolveToken
@@ -43,8 +47,8 @@ class LitRenderer extends IntegrationRenderer {
       }
     });
     return {
-      html: queuedBoundaryResolution.html,
-      assets: queuedBoundaryResolution.assets.length > 0 ? queuedBoundaryResolution.assets : void 0
+      html: queuedForeignSubtreeResolution.html,
+      assets: queuedForeignSubtreeResolution.assets.length > 0 ? queuedForeignSubtreeResolution.assets : void 0
     };
   }
   shouldRenderPageComponent() {
@@ -54,11 +58,11 @@ class LitRenderer extends IntegrationRenderer {
     return component?.config?.integration === this.name || component?.config?.__eco?.integration === this.name;
   }
   /**
-   * Renders a Lit component boundary for component-level orchestration.
+   * Renders a Lit component for component-level orchestration.
    *
    * SSR-eligible lazy scripts are preloaded first so custom elements registered
    * by the component can render their server markup even when the Lit renderer is
-   * entered through cross-integration boundary handoff.
+   * entered through cross-integration foreign-child handoff.
    *
    * Includes component-scoped dependency assets when declared.
    */
@@ -82,30 +86,24 @@ class LitRenderer extends IntegrationRenderer {
     const content = await component(props);
     const renderedHtml = await renderLitValueToString(content);
     const html = renderedChildren === void 0 ? renderedHtml : injectLitRenderedChildren(renderedHtml, renderedChildren);
-    const queuedBoundaryResolution = await this.resolveQueuedBoundaryHtml(
+    const queuedForeignSubtreeResolution = await this.resolveQueuedForeignSubtreeHtml(
       html,
-      this.getQueuedBoundaryRuntime(input)
+      this.getQueuedForeignSubtreeResolutionContext(input)
     );
     const hasDependencies = Boolean(input.component.config?.dependencies);
     const canResolveAssets = typeof this.assetProcessingService?.processDependencies === "function";
     const assets = hasDependencies && canResolveAssets ? await this.processComponentDependencies([input.component]) : void 0;
     return {
-      html: queuedBoundaryResolution.html,
+      html: queuedForeignSubtreeResolution.html,
       canAttachAttributes: true,
-      rootTag: this.getRootTagName(queuedBoundaryResolution.html),
+      rootTag: this.getRootTagName(queuedForeignSubtreeResolution.html),
       integrationName: this.name,
       assets: this.htmlTransformer.dedupeProcessedAssets([
         ...assets ?? [],
-        ...queuedBoundaryResolution.assets ?? []
+        ...queuedForeignSubtreeResolution.assets ?? []
       ])
     };
   }
-  createComponentBoundaryRuntime(options) {
-    return this.createQueuedBoundaryRuntime({
-      boundaryInput: options.boundaryInput,
-      rendererCache: options.rendererCache
-    });
-  }
   ssrLazyPreloader = new LitSsrLazyPreloader({
     resolveDependencyPath: this.resolveDependencyPath.bind(this),
     processDependencies: this.assetProcessingService?.processDependencies?.bind(this.assetProcessingService)
@@ -196,16 +194,16 @@ class LitRenderer extends IntegrationRenderer {
       const normalizedProps = props ?? {};
       await this.preloadSsrLazyScripts([view, Layout]);
       await this.prepareViewDependencies(view, Layout);
-      const pageRender = await this.renderComponentBoundary({
+      const pageRender = await this.renderComponentWithForeignChildren({
         component: view,
         props: normalizedProps
       });
-      const layoutRender = Layout ? await this.renderComponentBoundary({
+      const layoutRender = Layout ? await this.renderComponentWithForeignChildren({
         component: Layout,
         props: {},
         children: pageRender.html
       }) : void 0;
-      const documentRender = await this.renderComponentBoundary({
+      const documentRender = await this.renderComponentWithForeignChildren({
         component: HtmlTemplate,
         props: {
           metadata,