@ecopages/core 0.2.0-beta.31 → 0.2.0-beta.32

package/src/route-renderer/orchestration/foreign-child/foreign-child-output.utils.js

@@ -1,180 +1,191 @@
-import { buildInjectorMapScript } from "../../../eco/lazy-injector-map.js";
+import { buildInjectorMapScript } from '../../../eco/lazy-injector-map.js';
 function cloneTemplateStrings(strings, firstString) {
-  const nextStrings = [...strings];
-  nextStrings[0] = firstString;
-  const rawDescriptor = Object.getOwnPropertyDescriptor(strings, "raw");
-  if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
-    const rawStrings = [...rawDescriptor.value];
-    rawStrings[0] = firstString;
-    Object.defineProperty(nextStrings, "raw", {
-      ...rawDescriptor,
-      value: rawStrings
-    });
-  }
-  return nextStrings;
+    const nextStrings = [...strings];
+    nextStrings[0] = firstString;
+    const rawDescriptor = Object.getOwnPropertyDescriptor(strings, 'raw');
+    if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
+        const rawStrings = [...rawDescriptor.value];
+        rawStrings[0] = firstString;
+        Object.defineProperty(nextStrings, 'raw', {
+            ...rawDescriptor,
+            value: rawStrings,
+        });
+    }
+    return nextStrings;
 }
 function cloneTemplateContentWithUpdatedFirstString(content, firstString) {
-  const descriptors = Object.getOwnPropertyDescriptors(content);
-  const clonedContent = Object.create(Object.getPrototypeOf(content));
-  const stringsDescriptor = descriptors.strings;
-  Object.defineProperties(clonedContent, {
-    ...descriptors,
-    strings: {
-      ...stringsDescriptor,
-      value: cloneTemplateStrings(content.strings, firstString)
-    }
-  });
-  return clonedContent;
+    const descriptors = Object.getOwnPropertyDescriptors(content);
+    const clonedContent = Object.create(Object.getPrototypeOf(content));
+    const stringsDescriptor = descriptors.strings;
+    Object.defineProperties(clonedContent, {
+        ...descriptors,
+        strings: {
+            ...stringsDescriptor,
+            value: cloneTemplateStrings(content.strings, firstString),
+        },
+    });
+    return clonedContent;
 }
 function cloneMarkupNodeLikeWithUpdatedOuterHtml(content, outerHTML) {
-  const descriptors = Object.getOwnPropertyDescriptors(content);
-  const clonedContent = Object.create(Object.getPrototypeOf(content));
-  const outerHTMLDescriptor = descriptors.outerHTML;
-  Object.defineProperties(clonedContent, {
-    ...descriptors,
-    outerHTML: {
-      configurable: outerHTMLDescriptor?.configurable ?? true,
-      enumerable: outerHTMLDescriptor?.enumerable ?? true,
-      writable: true,
-      value: outerHTML
-    }
-  });
-  return clonedContent;
+    const descriptors = Object.getOwnPropertyDescriptors(content);
+    const clonedContent = Object.create(Object.getPrototypeOf(content));
+    const outerHTMLDescriptor = descriptors.outerHTML;
+    Object.defineProperties(clonedContent, {
+        ...descriptors,
+        outerHTML: {
+            configurable: outerHTMLDescriptor?.configurable ?? true,
+            enumerable: outerHTMLDescriptor?.enumerable ?? true,
+            writable: true,
+            value: outerHTML,
+        },
+    });
+    return clonedContent;
 }
 function wrapWithScriptsInjectorMarkup(content, injectorMapScript) {
-  return `<scripts-injector><script type="ecopages/injector-map">${injectorMapScript}<\/script>${content}<\/scripts-injector>`;
+    return `<scripts-injector><script type="ecopages/injector-map">${injectorMapScript}</script>${content}</scripts-injector>`;
 }
 function cloneTemplateContentWithWrappedInjector(content, injectorMapScript) {
-  if (content.strings.length === 0) {
-    return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
-  }
-  const nextStrings = [...content.strings];
-  nextStrings[0] = wrapWithScriptsInjectorMarkup(nextStrings[0] ?? "", injectorMapScript);
-  nextStrings[nextStrings.length - 1] = `${nextStrings[nextStrings.length - 1] ?? ""}<\/scripts-injector>`;
-  const rawDescriptor = Object.getOwnPropertyDescriptor(content.strings, "raw");
-  if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
-    const rawStrings = [...rawDescriptor.value];
-    rawStrings[0] = wrapWithScriptsInjectorMarkup(rawStrings[0] ?? "", injectorMapScript);
-    rawStrings[rawStrings.length - 1] = `${rawStrings[rawStrings.length - 1] ?? ""}<\/scripts-injector>`;
-    Object.defineProperty(nextStrings, "raw", {
-      ...rawDescriptor,
-      value: rawStrings
-    });
-  }
-  const descriptors = Object.getOwnPropertyDescriptors(content);
-  const clonedContent = Object.create(Object.getPrototypeOf(content));
-  const stringsDescriptor = descriptors.strings;
-  Object.defineProperties(clonedContent, {
-    ...descriptors,
-    strings: {
-      ...stringsDescriptor,
-      value: nextStrings
+    if (content.strings.length === 0) {
+        return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
     }
-  });
-  return clonedContent;
+    const nextStrings = [...content.strings];
+    nextStrings[0] = wrapWithScriptsInjectorMarkup(nextStrings[0] ?? '', injectorMapScript);
+    nextStrings[nextStrings.length - 1] = `${nextStrings[nextStrings.length - 1] ?? ''}</scripts-injector>`;
+    const rawDescriptor = Object.getOwnPropertyDescriptor(content.strings, 'raw');
+    if (rawDescriptor && Array.isArray(rawDescriptor.value)) {
+        const rawStrings = [...rawDescriptor.value];
+        rawStrings[0] = wrapWithScriptsInjectorMarkup(rawStrings[0] ?? '', injectorMapScript);
+        rawStrings[rawStrings.length - 1] = `${rawStrings[rawStrings.length - 1] ?? ''}</scripts-injector>`;
+        Object.defineProperty(nextStrings, 'raw', {
+            ...rawDescriptor,
+            value: rawStrings,
+        });
+    }
+    const descriptors = Object.getOwnPropertyDescriptors(content);
+    const clonedContent = Object.create(Object.getPrototypeOf(content));
+    const stringsDescriptor = descriptors.strings;
+    Object.defineProperties(clonedContent, {
+        ...descriptors,
+        strings: {
+            ...stringsDescriptor,
+            value: nextStrings,
+        },
+    });
+    return clonedContent;
 }
-function isThenable(value) {
-  return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+/**
+ * Returns `true` when `value` is a thenable (Promise-like) object.
+ *
+ * Used to transparently handle both synchronous and asynchronous component
+ * render results without requiring every caller to branch on `instanceof Promise`.
+ *
+ * @typeParam T Expected resolved type of the thenable.
+ */
+export function isThenable(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'then' in value &&
+        typeof value.then === 'function');
 }
 function isTemplateContentShape(value) {
-  return typeof value === "object" && value !== null && Array.isArray(value.strings) && ((value.values ?? void 0) === void 0 || Array.isArray(value.values));
+    return (typeof value === 'object' &&
+        value !== null &&
+        Array.isArray(value.strings) &&
+        ((value.values ?? undefined) === undefined ||
+            Array.isArray(value.values)));
 }
 function isMarkupNodeLikeShape(value) {
-  return typeof value === "object" && value !== null && typeof value.nodeType === "number";
+    return (typeof value === 'object' && value !== null && typeof value.nodeType === 'number');
 }
-function isMarkupNodeLike(value) {
-  return isMarkupNodeLikeShape(value);
+/** Returns whether a value looks like a DOM-like markup node from SSR integrations. */
+export function isMarkupNodeLike(value) {
+    return isMarkupNodeLikeShape(value);
 }
-function isOpaqueForeignChildValue(children) {
-  if (children === null || typeof children !== "object") {
-    return false;
-  }
-  if (Array.isArray(children)) {
-    return false;
-  }
-  if ("$$typeof" in children) {
-    return false;
-  }
-  if ("strings" in children && Array.isArray(children.strings)) {
-    return false;
-  }
-  if (isMarkupNodeLikeShape(children)) {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(children);
-  return prototype === Object.prototype || prototype === null;
+/**
+ * Returns whether a value is a plain opaque object that string serializers would
+ * coerce via `String(value)` rather than render as markup.
+ *
+ * @remarks
+ * Template results (`strings`/`values`), markup nodes, arrays, and framework
+ * element markers (`$$typeof`) are not opaque. Cross-integration children that
+ * are only plain objects must use EcoEmbed or already-serialized HTML.
+ */
+export function isOpaqueForeignChildValue(children) {
+    if (children === null || typeof children !== 'object') {
+        return false;
+    }
+    if (Array.isArray(children)) {
+        return false;
+    }
+    if ('$$typeof' in children) {
+        return false;
+    }
+    if ('strings' in children && Array.isArray(children.strings)) {
+        return false;
+    }
+    if (isMarkupNodeLikeShape(children)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(children);
+    return prototype === Object.prototype || prototype === null;
 }
-function assertForeignChildrenNotOpaque(children, context) {
-  if (!isOpaqueForeignChildValue(children)) {
-    return;
-  }
-  const childTag = Object.prototype.toString.call(children);
-  throw new TypeError(
-    `[ecopages] ${context} refused to coerce opaque foreign children (${childTag}). Use EcoEmbed for cross-integration children or pass already-serialized HTML.`
-  );
+/**
+ * Throws when foreign-path children would be coerced from an opaque object.
+ */
+export function assertForeignChildrenNotOpaque(children, context) {
+    if (!isOpaqueForeignChildValue(children)) {
+        return;
+    }
+    const childTag = Object.prototype.toString.call(children);
+    throw new TypeError(`[ecopages] ${context} refused to coerce opaque foreign children (${childTag}). Use EcoEmbed for cross-integration children or pass already-serialized HTML.`);
 }
 function injectTriggerAttributeIntoString(content, triggerId) {
-  const str = content;
-  let i = 0;
-  while (i < str.length) {
-    if (str[i] !== "<") {
-      i++;
-      continue;
+    const str = content;
+    let i = 0;
+    while (i < str.length) {
+        if (str[i] !== '<') {
+            i++;
+            continue;
+        }
+        const next = str[i + 1];
+        if (next === '!' || next === '?') {
+            const end = str.indexOf('>', i);
+            if (end === -1)
+                break;
+            i = end + 1;
+            continue;
+        }
+        if (next && /[a-zA-Z]/.test(next)) {
+            const tagSlice = str.slice(i + 1);
+            const nameEnd = tagSlice.search(/[\s/>]/);
+            if (nameEnd === -1)
+                break;
+            const insertAt = i + 1 + nameEnd;
+            return `${str.slice(0, insertAt)} data-eco-trigger="${triggerId}"${str.slice(insertAt)}`;
+        }
+        break;
     }
-    const next = str[i + 1];
-    if (next === "!" || next === "?") {
-      const end = str.indexOf(">", i);
-      if (end === -1) break;
-      i = end + 1;
-      continue;
+    return str;
+}
+export function addTriggerAttribute(content, triggerId) {
+    if (isTemplateContentShape(content)) {
+        if (content.strings.length === 0) {
+            return String(content);
+        }
+        return cloneTemplateContentWithUpdatedFirstString(content, injectTriggerAttributeIntoString(content.strings[0] ?? '', triggerId));
     }
-    if (next && /[a-zA-Z]/.test(next)) {
-      const tagSlice = str.slice(i + 1);
-      const nameEnd = tagSlice.search(/[\s/>]/);
-      if (nameEnd === -1) break;
-      const insertAt = i + 1 + nameEnd;
-      return `${str.slice(0, insertAt)} data-eco-trigger="${triggerId}"${str.slice(insertAt)}`;
+    if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === 'string') {
+        return cloneMarkupNodeLikeWithUpdatedOuterHtml(content, injectTriggerAttributeIntoString(content.outerHTML, triggerId));
     }
-    break;
-  }
-  return str;
+    return injectTriggerAttributeIntoString(String(content), triggerId);
 }
-function addTriggerAttribute(content, triggerId) {
-  if (isTemplateContentShape(content)) {
-    if (content.strings.length === 0) {
-      return String(content);
+export function wrapWithScriptsInjector(content, lazyGroups) {
+    const injectorMapScript = buildInjectorMapScript(lazyGroups ?? []);
+    if (isTemplateContentShape(content)) {
+        return cloneTemplateContentWithWrappedInjector(content, injectorMapScript);
     }
-    return cloneTemplateContentWithUpdatedFirstString(
-      content,
-      injectTriggerAttributeIntoString(content.strings[0] ?? "", triggerId)
-    );
-  }
-  if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === "string") {
-    return cloneMarkupNodeLikeWithUpdatedOuterHtml(
-      content,
-      injectTriggerAttributeIntoString(content.outerHTML, triggerId)
-    );
-  }
-  return injectTriggerAttributeIntoString(String(content), triggerId);
-}
-function wrapWithScriptsInjector(content, lazyGroups) {
-  const injectorMapScript = buildInjectorMapScript(lazyGroups ?? []);
-  if (isTemplateContentShape(content)) {
-    return cloneTemplateContentWithWrappedInjector(content, injectorMapScript);
-  }
-  if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === "string") {
-    return cloneMarkupNodeLikeWithUpdatedOuterHtml(
-      content,
-      wrapWithScriptsInjectorMarkup(content.outerHTML, injectorMapScript)
-    );
-  }
-  return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
+    if (isMarkupNodeLikeShape(content) && typeof content.outerHTML === 'string') {
+        return cloneMarkupNodeLikeWithUpdatedOuterHtml(content, wrapWithScriptsInjectorMarkup(content.outerHTML, injectorMapScript));
+    }
+    return wrapWithScriptsInjectorMarkup(String(content), injectorMapScript);
 }
-export {
-  addTriggerAttribute,
-  assertForeignChildrenNotOpaque,
-  isMarkupNodeLike,
-  isOpaqueForeignChildValue,
-  isThenable,
-  wrapWithScriptsInjector
-};