@ecency/render-helper 2.5.24 → 2.5.26

package/README.md

@@ -19,7 +19,7 @@ Built and maintained by [Ecency](https://ecency.com), an open-source social plat
 - `pnpm publish:render-helper` - Manually publish to npm
 
 ### CI/CD
-- Part of vision-next monorepo with centralized GitHub Actions (`.github/workflows/packages.yml`)
+- Part of vision-web monorepo with centralized GitHub Actions (`.github/workflows/packages.yml`)
 - Automatically detects changes to `packages/render-helper/**` using git diff
 - On push to `develop` branch, builds and publishes to npm
 - Uses OIDC (OpenID Connect) for secure npm authentication
@@ -128,7 +128,7 @@ src/
 
 ## Build System
 
-- Uses **tsup** for bundling (shared with other vision-next packages)
+- Uses **tsup** for bundling (shared with other vision-web packages)
 - TypeScript 5.6+ with strict mode enabled
 - Outputs three bundles:
     - `dist/browser/index.js` - Browser ESM with TypeScript declarations
@@ -173,6 +173,6 @@ const summary = postBodySummary(entry, 200, 'react-native')
 - When adding embed support for new platforms, implement server-side rendering only
 - All external content must go through sanitization
 - Version bumps required for auto-publish via CI
-- Part of vision-next monorepo - changes require updating across dependent packages
+- Part of vision-web monorepo - changes require updating across dependent packages
 - The `@ecency/renderer` package uses this as a workspace dependency
 - Exports are optimized for tree-shaking with proper ESM structure

package/dist/browser/index.d.ts

@@ -12,6 +12,32 @@ interface Entry {
 interface RenderOptions {
     /** When true, video embeds (3Speak, YouTube, etc.) render as iframes directly without a play button overlay. */
     embedVideosDirectly?: boolean;
+    /**
+     * When true, auto-linkified `@user` and `#tag` chips render as inert `<span>`
+     * instead of `<a>`. Only affects the non-app render path, which is the only
+     * one that emits these chips. For consumers that have no profile or tag
+     * routes to send a reader to (a single-author self-hosted blog), an `<a>`
+     * pointing at `/@user` or `/trending/tag` is a dead link that is still
+     * focusable, announced as a link, and crawlable. Classes are unchanged so
+     * existing chip styling still applies.
+     */
+    inertAuthorAndTagChips?: boolean;
+    /**
+     * Absolute origin for links a consumer has no route to serve itself, e.g.
+     * `https://ecency.com`. Only affects the non-app render path.
+     *
+     * This is for PROFILE SECTION links, `/@user/wallet`, `/@user/followers` and
+     * the rest of SECTION_LIST. They are emitted as ordinary links, so a
+     * consumer whose only matching route is `/:author/:permlink` routes them as a
+     * post and tries to load one whose permlink is `wallet`. That is not a dead
+     * route, so no route guard catches it, and it is not a chip, so
+     * `inertAuthorAndTagChips` does not either.
+     *
+     * Post links themselves are deliberately NOT rewritten: `/@author/permlink`
+     * is real content the consumer can resolve from the chain, and keeping it
+     * internal is the point of a self-hosted blog.
+     */
+    externalProfileBase?: string;
 }
 
 /**

package/dist/browser/index.js

@@ -1069,9 +1069,9 @@ function a(el, forApp, parentDomain = "ecency.com", seoContext, renderOptions) {
       if (el.textContent === href) {
         el.textContent = `@${author}/${section}`;
       }
-      if (forApp) {
-        const ha = `https://ecency.com/@${author}/${section}`;
-        el.setAttribute("href", ha);
+      const external1 = renderOptions?.externalProfileBase;
+      if (forApp || external1) {
+        el.setAttribute("href", `${external1 ?? "https://ecency.com"}/@${author}/${section}`);
       } else {
         const h = `/@${author}/${section}`;
         el.setAttribute("href", h);
@@ -1139,9 +1139,9 @@ function a(el, forApp, parentDomain = "ecency.com", seoContext, renderOptions) {
       if (el.textContent === href) {
         el.textContent = `@${author}/${section}`;
       }
-      if (forApp) {
-        const ha = `https://ecency.com/@${author}/${section}`;
-        el.setAttribute("href", ha);
+      const external2 = renderOptions?.externalProfileBase;
+      if (forApp || external2) {
+        el.setAttribute("href", `${external2 ?? "https://ecency.com"}/@${author}/${section}`);
       } else {
         const h = `/@${author}/${section}`;
         el.setAttribute("href", h);
@@ -1763,6 +1763,9 @@ function linkify(content, forApp, renderOptions) {
     const tag2 = tag.trim().substring(1);
     const tagLower = tag2.toLowerCase();
     if (!forApp) {
+      if (renderOptions?.inertAuthorAndTagChips) {
+        return `${preceding}<span class="er-tag er-tag-link">${tag.trim()}</span>`;
+      }
       return `${preceding}<a class="er-tag er-tag-link" href="/trending/${tagLower}">${tag.trim()}</a>`;
     }
     return `${preceding}<a class="markdown-tag-link" data-tag="${tagLower}">${tag.trim()}</a>`;
@@ -1776,7 +1779,8 @@ function linkify(content, forApp, renderOptions) {
       if (userLower.indexOf("/") === -1 && isValidUsername(user)) {
         if (!forApp) {
           const avatarSrc = `${getProxyBase()}/u/${userLower}/avatar/small`;
-          const html = `${preceedings}<a class="er-author er-author-link" href="/@${userLower}"><img class="er-author-link-image" src="${avatarSrc}" alt="${userLower}"/>@${userLower}</a>`;
+          const inner = `<img class="er-author-link-image" src="${avatarSrc}" alt="${userLower}"/>@${userLower}`;
+          const html = renderOptions?.inertAuthorAndTagChips ? `${preceedings}<span class="er-author er-author-link">${inner}</span>` : `${preceedings}<a class="er-author er-author-link" href="/@${userLower}">${inner}</a>`;
           const placeholder = `\u200C${authorPlaceholders.length}\u200C`;
           authorPlaceholders.push({ placeholder, html });
           return placeholder;
@@ -1795,7 +1799,8 @@ function linkify(content, forApp, renderOptions) {
       const permlink = sanitizePermlink(p3);
       if (!isValidPermlink(permlink)) return match;
       if (SECTION_LIST.includes(permlink)) {
-        const attrs = forApp ? `href="https://ecency.com/@${authorLower}/${permlink}"` : `href="/@${authorLower}/${permlink}"`;
+        const external = renderOptions?.externalProfileBase;
+        const attrs = forApp || external ? `href="${external ?? "https://ecency.com"}/@${authorLower}/${permlink}"` : `href="/@${authorLower}/${permlink}"`;
         return `${preceding}<a class="markdown-profile-link" ${attrs}>@${authorLower}/${permlink}</a>`;
       } else {
         const attrs = forApp ? `data-author="${authorLower}" data-tag="${tag}" data-permlink="${permlink}"` : `href="/@${authorLower}/${permlink}"`;
@@ -1810,7 +1815,8 @@ function linkify(content, forApp, renderOptions) {
       const permlink = sanitizePermlink(p3);
       if (!isValidPermlink(permlink)) return match;
       if (SECTION_LIST.includes(permlink)) {
-        const attrs = forApp ? `href="https://ecency.com/@${uu}/${permlink}"` : `href="/@${uu}/${permlink}"`;
+        const external = renderOptions?.externalProfileBase;
+        const attrs = forApp || external ? `href="${external ?? "https://ecency.com"}/@${uu}/${permlink}"` : `href="/@${uu}/${permlink}"`;
         return ` <a class="markdown-profile-link" ${attrs}>@${uu}/${permlink}</a>`;
       } else {
         const attrs = forApp ? `data-author="${uu}" data-tag="post" data-permlink="${permlink}"` : `href="/@${uu}/${permlink}"`;
@@ -1841,6 +1847,19 @@ function hasAncestor(node, tagNames) {
   }
   return false;
 }
+var CHIP_CLASSES = ["er-author-link", "er-tag-link"];
+function hasChipAncestor(node) {
+  let current = node.parentNode;
+  while (current) {
+    const el = current;
+    const className = typeof el.getAttribute === "function" ? el.getAttribute("class") : null;
+    if (className && className.split(/\s+/).some((token) => CHIP_CLASSES.includes(token))) {
+      return true;
+    }
+    current = current.parentNode;
+  }
+  return false;
+}
 function text(node, forApp, renderOptions) {
   if (!node || !node.parentNode) {
     return;
@@ -1848,8 +1867,11 @@ function text(node, forApp, renderOptions) {
   if (hasAncestor(node, ["a", "code", "pre"])) {
     return;
   }
+  if (renderOptions?.inertAuthorAndTagChips && hasChipAncestor(node)) {
+    return;
+  }
   const nodeValue = node.nodeValue || "";
-  const linkified = linkify(nodeValue, forApp);
+  const linkified = linkify(nodeValue, forApp, renderOptions);
   if (linkified !== nodeValue) {
     const doc = DOMParser.parseFromString(
       `<span class="wr">${linkified}</span>`,
@@ -1937,7 +1959,7 @@ function traverse(node, forApp, depth = 0, state = { firstImageFound: false }, p
       iframe(child, parentDomain, forApp, renderOptions);
     }
     if (child.nodeName === "#text") {
-      text(child, forApp);
+      text(child, forApp, renderOptions);
     }
     if (child.nodeName.toLowerCase() === "img") {
       img(child, state, forApp);
@@ -2141,7 +2163,7 @@ function markdown2Html(obj, forApp = true, _webp = false, parentDomain = "ecency
     logIfSlow(performance.now() - t02, `body_len=${obj.length}`);
     return res2;
   }
-  const key = `${makeEntryCacheKey(obj)}-md-${forApp ? "app" : "site"}-${parentDomain}${seoContext ? `-seo${seoContext.authorReputation ?? ""}-${seoContext.postPayout ?? ""}` : ""}${renderOptions?.embedVideosDirectly ? "-embed" : ""}`;
+  const key = `${makeEntryCacheKey(obj)}-md-${forApp ? "app" : "site"}-${parentDomain}${seoContext ? `-seo${seoContext.authorReputation ?? ""}-${seoContext.postPayout ?? ""}` : ""}${renderOptions?.embedVideosDirectly ? "-embed" : ""}${renderOptions?.inertAuthorAndTagChips ? "-inert" : ""}${renderOptions?.externalProfileBase ? "-ext" + renderOptions.externalProfileBase : ""}`;
   const item = cacheGet(key);
   if (item) {
     return item;