@ecopages/lit 0.2.1-beta.0 → 0.3.0

package/src/utils/lit-html-rendering.js

@@ -1,52 +1,45 @@
-import { render } from "@lit-labs/ssr";
-import { html as staticHtml, unsafeStatic } from "lit/static-html.js";
-const LIT_HTML_TEMPLATE_SLOT_MARKER = "<--content-->";
-const LIT_COMPONENT_CHILDREN_SLOT_MARKER = "<!--eco-lit-component-children-->";
-const ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER = "&lt;!--eco-lit-component-children--&gt;";
-const DOUBLE_ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER = "&amp;lt;!--eco-lit-component-children--&amp;gt;";
+import { render } from '@lit-labs/ssr';
+import { html as staticHtml, unsafeStatic } from 'lit/static-html.js';
+export const LIT_HTML_TEMPLATE_SLOT_MARKER = '<--content-->';
+export const LIT_COMPONENT_CHILDREN_SLOT_MARKER = '<!--eco-lit-component-children-->';
+const ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER = '&lt;!--eco-lit-component-children--&gt;';
+const DOUBLE_ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER = '&amp;lt;!--eco-lit-component-children--&amp;gt;';
 const DUPLICATE_DECLARATIVE_SHADOW_ROOT_ATTRIBUTE = /\sshadowroot=(['"])(open|closed)\1(?=\sshadowrootmode=\1\2\1)/g;
-function normalizeLitHtml(markup) {
-  return markup.replace(DUPLICATE_DECLARATIVE_SHADOW_ROOT_ATTRIBUTE, "");
+export function normalizeLitHtml(markup) {
+    return markup.replace(DUPLICATE_DECLARATIVE_SHADOW_ROOT_ATTRIBUTE, '');
 }
-function injectLitRenderedChildren(template, renderedChildren) {
-  for (const marker of [
-    LIT_COMPONENT_CHILDREN_SLOT_MARKER,
-    ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER,
-    DOUBLE_ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER
-  ]) {
-    if (template.includes(marker)) {
-      return template.split(marker).join(renderedChildren);
+export function injectLitRenderedChildren(template, renderedChildren) {
+    for (const marker of [
+        LIT_COMPONENT_CHILDREN_SLOT_MARKER,
+        ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER,
+        DOUBLE_ESCAPED_COMPONENT_CHILDREN_SLOT_MARKER,
+    ]) {
+        if (template.includes(marker)) {
+            return template.split(marker).join(renderedChildren);
+        }
     }
-  }
-  if (template.includes(LIT_HTML_TEMPLATE_SLOT_MARKER)) {
-    return template.split(LIT_HTML_TEMPLATE_SLOT_MARKER).join(renderedChildren);
-  }
-  if (template.includes("</body>")) {
-    return template.replace("</body>", `${renderedChildren}</body>`);
-  }
-  if (template.includes("</html>")) {
-    return template.replace("</html>", `${renderedChildren}</html>`);
-  }
-  return `${template}${renderedChildren}`;
+    if (template.includes(LIT_HTML_TEMPLATE_SLOT_MARKER)) {
+        return template.split(LIT_HTML_TEMPLATE_SLOT_MARKER).join(renderedChildren);
+    }
+    if (template.includes('</body>')) {
+        return template.replace('</body>', `${renderedChildren}</body>`);
+    }
+    if (template.includes('</html>')) {
+        return template.replace('</html>', `${renderedChildren}</html>`);
+    }
+    return `${template}${renderedChildren}`;
 }
-async function renderLitValueToString(value) {
-  if (typeof value === "string") {
-    let renderedHtml2 = "";
-    for (const chunk of render(staticHtml`${unsafeStatic(value)}`)) {
-      renderedHtml2 += chunk;
+export async function renderLitValueToString(value) {
+    if (typeof value === 'string') {
+        let renderedHtml = '';
+        for (const chunk of render(staticHtml `${unsafeStatic(value)}`)) {
+            renderedHtml += chunk;
+        }
+        return normalizeLitHtml(renderedHtml);
+    }
+    let renderedHtml = '';
+    for (const chunk of render(value)) {
+        renderedHtml += chunk;
     }
-    return normalizeLitHtml(renderedHtml2);
-  }
-  let renderedHtml = "";
-  for (const chunk of render(value)) {
-    renderedHtml += chunk;
-  }
-  return normalizeLitHtml(renderedHtml);
+    return normalizeLitHtml(renderedHtml);
 }
-export {
-  LIT_COMPONENT_CHILDREN_SLOT_MARKER,
-  LIT_HTML_TEMPLATE_SLOT_MARKER,
-  injectLitRenderedChildren,
-  normalizeLitHtml,
-  renderLitValueToString
-};

package/src/lit-ssr-lazy-preloader.d.ts

@@ -1,44 +0,0 @@
-import type { EcoComponent } from '@ecopages/core';
-import type { AssetDefinition } from '@ecopages/core/services/asset-processing-service';
-type ProcessDependencies = (dependencies: AssetDefinition[], integrationName: string) => Promise<Array<{
-    filepath?: string;
-}>>;
-export interface LitSsrLazyPreloaderOptions {
-    resolveDependencyPath: (componentDir: string, sourcePath: string) => string;
-    processDependencies?: ProcessDependencies;
-    preferSourceImports?: boolean;
-}
-/**
- * Encapsulates SSR lazy script preload behavior for Lit components.
- *
- * Collects `dependencies.scripts` lazy entries with `ssr: true`, resolves the
- * processed entrypoint through the asset pipeline, and imports the module so
- * custom elements are registered before SSR rendering.
- */
-export declare class LitSsrLazyPreloader {
-    private readonly resolveDependencyPath;
-    private readonly processDependencies?;
-    private readonly preferSourceImports;
-    private readonly ssrPreloadedScripts;
-    private readonly ssrPreloadFailedScripts;
-    private readonly ssrPreloadEntrypointCache;
-    constructor({ resolveDependencyPath, processDependencies, preferSourceImports }: LitSsrLazyPreloaderOptions);
-    private getErrorCode;
-    /**
-     * Detects preload failures that are expected for browser-only modules.
-     */
-    isExpectedSsrPreloadError(error: unknown): boolean;
-    /**
-     * Collects lazy script file paths eligible for SSR preloading.
-     */
-    collectSsrPreloadScripts(components: Array<EcoComponent | undefined>): string[];
-    /**
-     * Preloads SSR-eligible lazy scripts to register custom elements before render.
-     */
-    preloadSsrLazyScripts(components: Array<EcoComponent | undefined>): Promise<void>;
-    /**
-     * Resolves the concrete JS entrypoint used for SSR preloading.
-     */
-    resolveSsrPreloadEntrypoint(scriptPath: string): Promise<string | null>;
-}
-export {};

package/src/lit-ssr-lazy-preloader.js

@@ -1,167 +0,0 @@
-import { AssetFactory } from "@ecopages/core/services/asset-processing-service";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-class LitSsrLazyPreloader {
-  resolveDependencyPath;
-  processDependencies;
-  preferSourceImports;
-  ssrPreloadedScripts = /* @__PURE__ */ new Set();
-  ssrPreloadFailedScripts = /* @__PURE__ */ new Set();
-  ssrPreloadEntrypointCache = /* @__PURE__ */ new Map();
-  constructor({ resolveDependencyPath, processDependencies, preferSourceImports }) {
-    this.resolveDependencyPath = resolveDependencyPath;
-    this.processDependencies = processDependencies;
-    this.preferSourceImports = preferSourceImports ?? typeof Bun !== "undefined";
-  }
-  getErrorCode(error) {
-    if (typeof error !== "object" || error === null) {
-      return "";
-    }
-    const code = Reflect.get(error, "code");
-    return code === void 0 ? "" : String(code);
-  }
-  /**
-   * Detects preload failures that are expected for browser-only modules.
-   */
-  isExpectedSsrPreloadError(error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    const errorCode = this.getErrorCode(error);
-    if (errorCode === "ERR_UNKNOWN_FILE_EXTENSION") {
-      return true;
-    }
-    return errorMessage.includes(`reading 'Element'`) || errorMessage.includes("window is not defined") || errorMessage.includes("document is not defined") || errorMessage.includes("navigator is not defined");
-  }
-  /**
-   * Collects lazy script file paths eligible for SSR preloading.
-   */
-  collectSsrPreloadScripts(components) {
-    const scriptPaths = /* @__PURE__ */ new Set();
-    const visitedConfigs = /* @__PURE__ */ new Set();
-    const collect = (component) => {
-      const config = component?.config;
-      if (!config || visitedConfigs.has(config)) {
-        return;
-      }
-      visitedConfigs.add(config);
-      const scriptEntries = config.dependencies?.scripts ?? [];
-      const componentFile = config.__eco?.file;
-      if (componentFile) {
-        const componentDir = path.dirname(componentFile);
-        for (const script of scriptEntries) {
-          if (typeof script === "string") {
-            continue;
-          }
-          if (!script.lazy || script.ssr !== true) {
-            continue;
-          }
-          if (!script.src) {
-            continue;
-          }
-          scriptPaths.add(this.resolveDependencyPath(componentDir, script.src));
-        }
-      }
-      if (config.layout) {
-        collect(config.layout);
-      }
-      for (const nestedComponent of config.dependencies?.components || []) {
-        collect(nestedComponent);
-      }
-    };
-    for (const component of components) {
-      collect(component);
-    }
-    return Array.from(scriptPaths);
-  }
-  /**
-   * Preloads SSR-eligible lazy scripts to register custom elements before render.
-   */
-  async preloadSsrLazyScripts(components) {
-    const scripts = this.collectSsrPreloadScripts(components);
-    if (scripts.length === 0) {
-      return;
-    }
-    await Promise.all(
-      scripts.filter((scriptPath) => {
-        if (this.ssrPreloadedScripts.has(scriptPath)) {
-          return false;
-        }
-        if (this.ssrPreloadFailedScripts.has(scriptPath)) {
-          return false;
-        }
-        return true;
-      }).map(async (scriptPath) => {
-        const preloadEntrypoint = await this.resolveSsrPreloadEntrypoint(scriptPath);
-        if (!preloadEntrypoint) {
-          this.ssrPreloadFailedScripts.add(scriptPath);
-          return;
-        }
-        try {
-          await import(
-            /* @vite-ignore */
-            pathToFileURL(preloadEntrypoint).href
-          );
-          this.ssrPreloadedScripts.add(scriptPath);
-        } catch (error) {
-          this.ssrPreloadFailedScripts.add(scriptPath);
-          if (this.isExpectedSsrPreloadError(error)) {
-            if (process.env.ECOPAGES_DEBUG === "true") {
-              console.warn(
-                `[ecopages][lit] Skipping SSR preload for browser-only lazy script: ${scriptPath}`
-              );
-            }
-            return;
-          }
-          console.warn(`[ecopages][lit] Failed to preload lazy SSR script: ${scriptPath}`, error);
-        }
-      })
-    );
-  }
-  /**
-   * Resolves the concrete JS entrypoint used for SSR preloading.
-   */
-  async resolveSsrPreloadEntrypoint(scriptPath) {
-    const cachedEntrypoint = this.ssrPreloadEntrypointCache.get(scriptPath);
-    if (cachedEntrypoint) {
-      return cachedEntrypoint;
-    }
-    if (this.preferSourceImports) {
-      this.ssrPreloadEntrypointCache.set(scriptPath, scriptPath);
-      return scriptPath;
-    }
-    if (!this.processDependencies) {
-      this.ssrPreloadEntrypointCache.set(scriptPath, scriptPath);
-      return scriptPath;
-    }
-    try {
-      const processed = await this.processDependencies(
-        [
-          AssetFactory.createInlineFileScript({
-            filepath: scriptPath,
-            position: "head",
-            bundle: true,
-            attributes: {
-              type: "module",
-              defer: ""
-            }
-          })
-        ],
-        `lit-ssr-preload:${scriptPath}`
-      );
-      const entrypoint = processed[0]?.filepath;
-      if (!entrypoint) {
-        return scriptPath;
-      }
-      this.ssrPreloadEntrypointCache.set(scriptPath, entrypoint);
-      return entrypoint;
-    } catch (error) {
-      if (process.env.ECOPAGES_DEBUG === "true") {
-        console.warn(`[ecopages][lit] Failed to resolve SSR preload entrypoint for: ${scriptPath}`, error);
-      }
-      this.ssrPreloadEntrypointCache.set(scriptPath, scriptPath);
-      return scriptPath;
-    }
-  }
-}
-export {
-  LitSsrLazyPreloader
-};