jamdesk 1.1.218 → 1.1.220

package/vendored/lib/svg-text.ts

@@ -0,0 +1,185 @@
+// No imports on purpose: this file is copied verbatim into the CLI.
+
+export const SVG_TEXT_MAX_BYTES = 1_048_576;
+export const SVG_TEXT_MESSAGE =
+  "This SVG logo has text in it that link previews can't show. Convert the text to outlines (paths) in your design tool and export it again.";
+export const SVG_TEXT_LINK = 'https://jamdesk.com/docs/content/seo#customize-the-social-card';
+
+// Elements whose contents are never painted, so a <text> inside them is not visible text.
+const NON_RENDERED = new Set(['title', 'desc', 'metadata', 'script', 'style']);
+
+/** Character data of a <text> body with nested tags (tspan etc.) dropped. */
+function visibleData(body: string): boolean {
+  let i = 0;
+  while (i < body.length) {
+    const lt = body.indexOf('<', i);
+    const end = lt === -1 ? body.length : lt;
+    for (let k = i; k < end; k++) {
+      const c = body.charCodeAt(k);
+      // Anything that is not ASCII whitespace counts, entities such as &#x44; included.
+      if (c !== 32 && c !== 9 && c !== 10 && c !== 13 && c !== 12) return true;
+    }
+    if (lt === -1) return false;
+    const gt = body.indexOf('>', lt);
+    if (gt === -1) return false;
+    i = gt + 1;
+  }
+  return false;
+}
+
+/**
+ * Index of the close tag for rawName at or after `from`, or -1. A match only
+ * counts when the name ends there, so </textPath is not the close of <text.
+ * The search only moves forward, so it stays linear.
+ */
+function findClose(lc: string, rawName: string, from: number): number {
+  const needle = '</' + rawName;
+  let at = lc.indexOf(needle, from);
+  while (at !== -1) {
+    const c = lc.charCodeAt(at + needle.length);
+    if (c === 62 || c === 32 || c === 9 || c === 10 || c === 13 || c === 12) return at;
+    at = lc.indexOf(needle, at + 1);
+  }
+  return -1;
+}
+
+// display:none on an element or its style hides the whole subtree. Design tools
+// leave the original text in a hidden layer after outlining a copy of it.
+// visibility:hidden is not here on purpose: a child can set it back to visible.
+const DISPLAY_NONE_ATTR = /(?:^|\s)display\s*=\s*(["'])\s*none\s*\1/;
+const STYLE_ATTR = /(?:^|\s)style\s*=\s*(?:"([^"]*)"|'([^']*)')/;
+const DISPLAY_NONE_CSS = /(?:^|[;\s])display\s*:\s*none(?![a-z0-9_-])/;
+
+function isDisplayNone(attrs: string): boolean {
+  if (DISPLAY_NONE_ATTR.test(attrs)) return true;
+  const style = STYLE_ATTR.exec(attrs);
+  return !!style && DISPLAY_NONE_CSS.test(style[1] ?? style[2]);
+}
+
+/**
+ * True when the SVG has a <text> element with visible characters.
+ * @vercel/og has no fonts for SVGs embedded as images, so such text draws blank
+ * (reproduced in prod 2026-10-05). Single forward scan with indexOf: every
+ * search moves past what it consumed, and anything unterminated ends the scan.
+ * A display:none element is tracked by name and depth inside the same scan, so
+ * skipping it never re-reads input.
+ */
+export function svgHasText(svg: string): boolean {
+  const lc = svg.toLowerCase();
+  // Raw name of the display:none element being skipped, and how many opens of
+  // that name are still unclosed. 0 means not inside a hidden element.
+  let hiddenName = '';
+  let hiddenDepth = 0;
+  let i = 0;
+  while (i < lc.length) {
+    const lt = lc.indexOf('<', i);
+    if (lt === -1) return false;
+
+    if (lc.startsWith('<!--', lt)) {
+      const end = lc.indexOf('-->', lt + 4);
+      if (end === -1) return false;
+      i = end + 3;
+      continue;
+    }
+    if (lc.startsWith('<![cdata[', lt)) {
+      const end = lc.indexOf(']]>', lt + 9);
+      if (end === -1) return false;
+      i = end + 3;
+      continue;
+    }
+    if (lc.startsWith('<?', lt)) {
+      const end = lc.indexOf('?>', lt + 2);
+      if (end === -1) return false;
+      i = end + 2;
+      continue;
+    }
+
+    const isClose = lc.charCodeAt(lt + 1) === 47;
+    const nameStart = isClose ? lt + 2 : lt + 1;
+    let n = nameStart;
+    while (n < lc.length) {
+      const c = lc.charCodeAt(n);
+      if (c === 32 || c === 9 || c === 10 || c === 13 || c === 12 || c === 47 || c === 62 || c === 60) break;
+      n++;
+    }
+    const rawName = lc.slice(nameStart, n);
+    // Every tag is read up to its '>' and the scan resumes after it, so no
+    // character is looked at twice. With no '>' left, no later tag can be whole.
+    const gt = lc.indexOf('>', n);
+    if (gt === -1) return false;
+    const selfClosing = lc.charCodeAt(gt - 1) === 47;
+
+    if (isClose) {
+      if (hiddenDepth > 0 && rawName === hiddenName) hiddenDepth--;
+      i = gt + 1;
+      continue;
+    }
+
+    const local = rawName.slice(rawName.indexOf(':') + 1);
+    const isText = local === 'text';
+    if (isText || NON_RENDERED.has(local)) {
+      if (selfClosing) {
+        i = gt + 1;
+        continue;
+      }
+      // Jump over the body even when hidden: script or title content could
+      // otherwise look like tags and throw off the hidden depth count.
+      const close = findClose(lc, rawName, gt + 1);
+      if (close === -1) return false;
+      if (
+        isText &&
+        hiddenDepth === 0 &&
+        !isDisplayNone(lc.slice(n, gt)) &&
+        visibleData(lc.slice(gt + 1, close))
+      ) {
+        return true;
+      }
+      i = close;
+      continue;
+    }
+
+    if (!selfClosing) {
+      if (hiddenDepth > 0) {
+        if (rawName === hiddenName) hiddenDepth++;
+      } else if (isDisplayNone(lc.slice(n, gt))) {
+        hiddenName = rawName;
+        hiddenDepth = 1;
+      }
+    }
+    i = gt + 1;
+  }
+  return false;
+}
+
+type ImageValue = string | { light?: string; dark?: string } | undefined;
+
+/**
+ * The SVG logo the generated social card draws, or null when it draws none.
+ * SVG logos are never rewritten, and neither fallback in seo.ts (the favicon
+ * swap at :176 and :212) applies to .svg, so a returned ref is the file drawn.
+ * Mirrors resolveImagePath and the card variant choice in seo.ts.
+ */
+export function cardSvgLogoRef(config: {
+  logo?: ImageValue;
+  seo?: { metatags?: Record<string, string>; socialCard?: { theme?: string; customImage?: string } };
+}): string | null {
+  const card = config.seo?.socialCard;
+  // 'replace' with a usable global og:image serves that image instead of the card.
+  if (card?.customImage === 'replace') {
+    const og = config.seo?.metatags?.['og:image'];
+    const trimmed = typeof og === 'string' ? og.trim() : '';
+    if (trimmed && !trimmed.startsWith('data:')) return null;
+  }
+
+  const logo = config.logo;
+  if (!logo) return null;
+  let ref = '';
+  if (typeof logo === 'string') {
+    ref = logo;
+  } else {
+    const { light, dark } = logo;
+    ref = (card?.theme === 'dark' ? dark || light : light || dark) || '';
+  }
+  if (!ref) return null;
+  return /\.svg$/i.test(ref.split(/[?#]/)[0]) ? ref : null;
+}

package/vendored/lib/validate-config.ts

@@ -347,6 +347,8 @@ export function formatValidationErrors(errors: ErrorObject[] | null | undefined,
       case 'minLength':
         return `Value at ${path} must not be empty`;
       case 'pattern':
+        // A bare "Invalid format" gives no hint that %s is the missing piece.
+        if (err.instancePath === '/seo/titleTemplate') return `Invalid value at ${path}: must contain %s where the page title goes`;
         return `Invalid format at ${path}`;
       case 'anyOf':
         return `Invalid value at ${path}: does not match any allowed format`;

package/vendored/schema/docs-schema.json

@@ -610,6 +610,12 @@
                                 }
                             }
                         },
+                        "titleTemplate": {
+                            "type": "string",
+                            "pattern": "%s",
+                            "maxLength": 200,
+                            "description": "Format of the browser tab and search result title on every page. Each `%s` is replaced with the page title, for example `%s | Acme`. Use `%s` alone to leave out the site name. Does not change og:title. Defaults to `%s — <name>`."
+                        },
                         "socialCard": {
                             "type": "object",
                             "additionalProperties": false,

package/vendored/shared/status-reporter.ts

@@ -58,6 +58,10 @@ export const BUILD_WARNING_TYPES = [
   // reusing invalid_openapi_spec: the key may be `api.asyncapi`, which has no
   // OpenAPI spec to have failed to parse.
   'inert_config_key',
+  // New (2026-10-05): the SVG logo the OG social card draws has visible <text>,
+  // which the card renderer paints blank. Suggestion tier: the site still
+  // builds and the page logo is fine, only the link preview loses the text.
+  'logo_svg_text',
 ] as const;
 
 export type BuildWarningType = (typeof BUILD_WARNING_TYPES)[number];
@@ -104,6 +108,7 @@ export const SUGGESTION_TYPES: ReadonlySet<BuildWarningType> = new Set([
   'page_missing_description',
   'page_short_description',
   'logo_oversized',
+  'logo_svg_text',
 ]);
 
 /**