hexo-theme-stellar 1.44.0 → 2.0.0-rc.2

package/scripts/lib/html-images.js

@@ -0,0 +1,128 @@
+"use strict";
+
+// 解析 <img ...> 标签内部属性，返回 [{name, value, raw, start, end}]
+function parseImageAttributes(inner) {
+  const attrs = [];
+  const re = /([^\s=/>]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
+  let m;
+  while ((m = re.exec(inner)) !== null) {
+    attrs.push({
+      name: m[1].toLowerCase(),
+      value: m[2] !== undefined ? m[2] : m[3] !== undefined ? m[3] : m[4] !== undefined ? m[4] : null,
+      raw: m[0],
+      start: m.index,
+      end: m.index + m[0].length,
+    });
+  }
+  return attrs;
+}
+
+// 查找标签结束位置（尊重属性值内的引号，避免把 > 截断进属性值）
+function findTagEnd(html, start) {
+  let j = start;
+  let quote = null;
+  while (j < html.length) {
+    const ch = html[j];
+    if (quote) {
+      if (ch === quote) {
+        quote = null;
+      }
+    } else if (ch === '"' || ch === "'") {
+      quote = ch;
+    } else if (ch === ">") {
+      return j;
+    }
+    j++;
+  }
+  return -1;
+}
+
+function isTagBoundary(html, pos) {
+  if (pos >= html.length) {
+    return true;
+  }
+  const ch = html[pos];
+  return ch === " " || ch === "\t" || ch === "\n" || ch === "\r" || ch === ">" || ch === "/";
+}
+
+// 只变换真实 <img> 标签，保留脚本、样式、注释和其余 HTML 原文。
+function mapImageTags(html, transform) {
+  if (typeof html !== "string" || !/<img/i.test(html)) return html;
+  const parts = [];
+  let i = 0;
+  const n = html.length;
+  const lower = html.toLowerCase();
+  while (i < n) {
+    const ch = html[i];
+    if (ch !== "<") {
+      parts.push(ch);
+      i++;
+      continue;
+    }
+    // HTML 注释
+    if (html.startsWith("<!--", i)) {
+      const end = html.indexOf("-->", i);
+      if (end === -1) {
+        break;
+      }
+      parts.push(html.slice(i, end + 3));
+      i = end + 3;
+      continue;
+    }
+    // <script>…</script>：整段跳过，避免误处理模板字符串/字符串里的 <img
+    if (lower.startsWith("<script", i) && isTagBoundary(html, i + 7)) {
+      const end = findTagEnd(html, i);
+      if (end === -1) {
+        break;
+      }
+      parts.push(html.slice(i, end + 1));
+      i = end + 1;
+      const close = lower.indexOf("</script", i);
+      if (close === -1) {
+        break;
+      }
+      const closeEnd = html.indexOf(">", close);
+      if (closeEnd === -1) {
+        break;
+      }
+      parts.push(html.slice(i, closeEnd + 1));
+      i = closeEnd + 1;
+      continue;
+    }
+    // <style>…</style>：整段跳过
+    if (lower.startsWith("<style", i) && isTagBoundary(html, i + 6)) {
+      const end = findTagEnd(html, i);
+      if (end === -1) {
+        break;
+      }
+      parts.push(html.slice(i, end + 1));
+      i = end + 1;
+      const close = lower.indexOf("</style", i);
+      if (close === -1) {
+        break;
+      }
+      const closeEnd = html.indexOf(">", close);
+      if (closeEnd === -1) {
+        break;
+      }
+      parts.push(html.slice(i, closeEnd + 1));
+      i = closeEnd + 1;
+      continue;
+    }
+    // <img …>
+    if (lower.startsWith("<img", i) && isTagBoundary(html, i + 4)) {
+      const end = findTagEnd(html, i);
+      if (end === -1) {
+        break;
+      }
+      parts.push(transform(html.slice(i, end + 1)));
+      i = end + 1;
+      continue;
+    }
+    parts.push(ch);
+    i++;
+  }
+  return parts.join("");
+}
+
+module.exports = { mapImageTags, parseImageAttributes };

package/scripts/lib/internal-constants.js

@@ -0,0 +1,152 @@
+/* global hexo */
+
+"use strict";
+
+function deepFreeze(value) {
+  if (value == null || typeof value !== "object" || Object.isFrozen(value)) return value;
+  Object.values(value).forEach(deepFreeze);
+  return Object.freeze(value);
+}
+
+module.exports = deepFreeze({
+  providers: {
+    linkPrefetch: "flying_pages",
+    lightbox: "fancybox",
+    diagrams: "mermaid"
+  },
+  runtime: {
+    cache: {
+      enabled: true,
+      defaultTtl: 3600,
+      ttl: {
+        giscus: 600,
+        waline: 600,
+        artalk: 600,
+        memos: 600,
+        "memos-user": 86400,
+        sites: 86400,
+        friends: 86400,
+        friends_and_posts: 86400,
+        siteinfo: 86400
+      },
+      maxEntries: 200
+    },
+    request: {
+      retries: 2,
+      timeoutMs: 5000,
+      idleTimeoutMs: 3000,
+      maxCacheEntryBytes: 200 * 1024
+    },
+    features: {
+      codeCopyToastMs: 2500
+    }
+  },
+  appearance: {
+    gradientAngle: "210deg"
+  },
+  assets: {
+    runtime: {
+      bootstrap: "/js/runtime/index.js",
+      colorSchemeSwitch: "/js/runtime/extensions/color-scheme-switch.js",
+      deferredIcons: "/js/runtime/extensions/deferred-icons.js",
+      dropdown: "/js/runtime/extensions/dropdown.js",
+      heroEffect: "/js/runtime/extensions/hero-effect.js",
+      reveal: "/js/runtime/extensions/reveal.js",
+      settings: "/js/runtime/extensions/settings.js"
+    },
+    heroEffects: {
+      ferrofluid: "/js/runtime/hero-effects/ferrofluid.js",
+      galaxy: "/js/runtime/hero-effects/galaxy.js",
+      lightRays: "/js/runtime/hero-effects/light-rays.js"
+    },
+    dependencies: {
+      marked: "https://gcore.jsdelivr.net/npm/marked@13.0/lib/marked.umd.min.js",
+      lazyLoading: "https://gcore.jsdelivr.net/npm/vanilla-lazyload@19.1/dist/lazyload.min.js"
+    },
+    search: {
+      algolia: "https://gcore.jsdelivr.net/algoliasearch/3/algoliasearch.min.js",
+      providers: {
+        algolia: "/js/search/algolia-search.js",
+        local: "/js/search/local-search.js"
+      },
+      shortcut: "/js/search/shortcut.js"
+    },
+    comments: {
+      beaudar: {
+        js: "https://beaudar.lipk.org/client.js",
+        localCss: "/css/comments/beaudar.css"
+      },
+      utterances: {
+        js: "https://utteranc.es/client.js",
+        localCss: "/css/comments/utterances.css"
+      },
+      giscus: { js: "https://giscus.app/client.js" },
+      twikoo: {
+        js: "https://gcore.jsdelivr.net/npm/twikoo@1.6/dist/twikoo.all.min.js",
+        localCss: "/css/comments/twikoo.css"
+      },
+      waline: {
+        js: "https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline.js",
+        css: "https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline.css",
+        metaCss: "https://gcore.jsdelivr.net/npm/@waline/client@3.15.2/dist/waline-meta.css",
+        localCss: "/css/comments/waline.css"
+      },
+      artalk: {
+        js: "https://unpkg.com/artalk@2.9/dist/artalk.js",
+        css: "https://unpkg.com/artalk@2.9/dist/artalk.css",
+        localCss: "/css/comments/artalk.css"
+      }
+    },
+    features: {
+      linkPrefetch: "https://gcore.jsdelivr.net/npm/flying-pages@2/flying-pages.min.js",
+      lightbox: {
+        js: "https://gcore.jsdelivr.net/npm/@fancyapps/ui@5.0/dist/fancybox/fancybox.umd.js",
+        css: "https://gcore.jsdelivr.net/npm/@fancyapps/ui@5.0/dist/fancybox/fancybox.css",
+        localCss: "/css/plugins/fancybox.css"
+      },
+      swiper: {
+        js: "https://unpkg.com/swiper@10.3/swiper-bundle.min.js",
+        css: "https://unpkg.com/swiper@10.3/swiper-bundle.min.css",
+        localCss: "/css/plugins/swiper.css"
+      },
+      katexCss: "https://cdn.jsdelivr.net/npm/katex@0.16.23/dist/katex.min.css",
+      mathjax: "https://cdnjs.cloudflare.com/ajax/libs/mathjax/3.2.2/es5/tex-mml-chtml.min.js",
+      diagrams: {
+        js: "https://gcore.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"
+      },
+      codeCopy: { js: "/js/plugins/copycode.js" },
+      adaptiveText: {
+        colorJs: "/js/color.js",
+        js: "/js/plugins/adaptive-text.js"
+      },
+      cardHover: { js: "/js/plugins/card-hover.js" },
+      heti: {
+        css: "https://unpkg.com/heti@0.9/umd/heti.min.css",
+        js: "https://unpkg.com/heti@0.9/umd/heti-addon.min.js"
+      }
+    },
+    services: {
+      chat: { endpoint: "https://siteinfo.listentothewind.cn/api/v1" },
+      mdrender: { js: "/js/services/mdrender.js" },
+      siteinfo: { js: "/js/services/siteinfo.js" },
+      ghinfo: { js: "/js/services/ghinfo.js" },
+      rating: { js: "/js/services/rating.js" },
+      vote: { js: "/js/services/vote.js" },
+      sites: { js: "/js/services/sites.js" },
+      friends: { js: "/js/services/friends.js" },
+      friends_and_posts: { js: "/js/services/friends_and_posts.js" },
+      timeline: { js: "/js/services/timeline.js" },
+      weibo: { js: "/js/services/weibo.js" },
+      memos: { js: "/js/services/memos.js" },
+      voice: { js: "/js/plugins/voice.js" },
+      video: { js: "/js/plugins/video.js" },
+      "download-file": { js: "/js/plugins/download-file.js" },
+      twikoo: { js: "/js/services/twikoo_latest_comment.js" },
+      waline: { js: "/js/services/waline_latest_comment.js" },
+      artalk: { js: "/js/services/artalk_latest_comment.js" },
+      giscus: { js: "/js/services/giscus_latest_comment.js" },
+      contributors: { js: "/js/services/contributors.js" },
+      rss: { js: "/js/services/rss.js" }
+    }
+  }
+});

package/scripts/lib/layout-config.js

@@ -0,0 +1,62 @@
+/* global hexo */
+"use strict";
+
+const { cascadeRegions } = require("./regions");
+
+function profilePath(path) {
+  if (typeof path !== "string") return "";
+  return path.replace(/^\/+|\/+$/g, "");
+}
+
+function generatorPath(path) {
+  const normalized = profilePath(path);
+  if (normalized.length === 0) return "index.html";
+  return /\.[^/]+$/.test(normalized) ? normalized : `${normalized}/index.html`;
+}
+
+function toRenderNavigation(profile) {
+  const activeMenu = profile?.activeMenu;
+  return activeMenu == null ? {} : { menu: activeMenu };
+}
+
+function siteBrandModel(globalConfig) {
+  const configured = globalConfig?.leftbar?.brand;
+  if (configured === false) return false;
+  return {
+    ...(configured && typeof configured === "object" ? configured : {}),
+    source: "site",
+    style: configured?.style || "regular"
+  };
+}
+
+function toRenderRegions(globalConfig, profile, defaults = null, options = {}) {
+  const siteBrand = siteBrandModel(globalConfig);
+  const normalizedGlobal = {
+    ...globalConfig,
+    leftbar: {
+      ...(globalConfig?.leftbar || {}),
+      brand: siteBrand
+    }
+  };
+  return cascadeRegions(
+    [normalizedGlobal, defaults, profile, ...(options.layers || [])],
+    { brandSources: { site: siteBrand, ...(options.brandSources || {}) } }
+  );
+}
+
+function requireLayoutProfiles(stellarConfig) {
+  const profiles = stellarConfig?.profiles;
+  if (profiles == null || typeof profiles !== "object" || Array.isArray(profiles)) {
+    throw new TypeError("Stellar v2: 缺少冻结的 profiles 配置");
+  }
+  return profiles;
+}
+
+module.exports = {
+  generatorPath,
+  profilePath,
+  requireLayoutProfiles,
+  siteBrandModel,
+  toRenderNavigation,
+  toRenderRegions
+};

package/scripts/lib/mdrender_html.js

@@ -1,3 +1,5 @@
+/* global hexo */
+
 /**
  * mdrender_html.js v2 | https://github.com/xaoxuu/hexo-theme-stellar/
  *
@@ -5,28 +7,37 @@
  * 统一生成 .data-service.ds-mdrender 占位标记。
  *
  * 行为：
- * - src 为 GitHub raw 类地址时，host 替换为调用方传入的 ghraw
- *   （主题配置 api_host.ghraw，代码不设默认值）；未传 ghraw 时保留 src 原 host；
+ * - src 为 GitHub raw 类地址时，origin 替换为调用方传入的 rawUrl；
+ *   未传 rawUrl 时保留 src 原 origin；
  * - 识别后输出 data-base（该 md 所在 raw 目录）；
  * - 非 GitHub src 原样输出、不带 data-base；
  * - replace=true 输出 data-replace（客户端原地替换，无外部容器）；
  * - heading 缺省 true，输出 data-heading（客户端标题适配本地文章格式）。
  */
 
-'use strict';
+"use strict";
 
 // GitHub raw 规范 host：用于识别用户 src 中的规范 raw 地址（GitHub 固有事实，非配置默认值）
-const GITHUB_RAW_HOST = 'raw.githubusercontent.com';
+const GITHUB_RAW_HOST = "raw.githubusercontent.com";
 
 // 占位标记类名（组件契约：服务端生成、services 按需加载、客户端渲染共用）
-const PLACEHOLDER_CLASS = 'ds-mdrender';
+const PLACEHOLDER_CLASS = "ds-mdrender";
 
 /**
- * 解析 GitHub raw 地址（规范 raw host 或调用方传入的 ghraw 镜像 host）。
+ * 解析 GitHub raw 地址（规范 raw host 或调用方传入的 rawUrl 镜像 origin）。
  * 返回 { host, owner, repo, ref, rest }；无法识别时返回 null。
  */
-function parseGitHubRaw(url, ghrawHost) {
-  if (typeof url !== 'string' || url.length === 0) {
+function rawOrigin(value) {
+  if (typeof value !== "string" || value.length === 0) return null;
+  try {
+    return new URL(value).origin;
+  } catch (e) {
+    return null;
+  }
+}
+
+function parseGitHubRaw(url, rawUrl) {
+  if (typeof url !== "string" || url.length === 0) {
     return null;
   }
   let u;
@@ -35,11 +46,12 @@ function parseGitHubRaw(url, ghrawHost) {
   } catch (e) {
     return null;
   }
-  const host = u.hostname || '';
-  if (host !== GITHUB_RAW_HOST && host !== ghrawHost) {
+  const host = u.hostname || "";
+  const configuredOrigin = rawOrigin(rawUrl);
+  if (host !== GITHUB_RAW_HOST && u.origin !== configuredOrigin) {
     return null;
   }
-  const segs = u.pathname.split('/').filter(s => s.length > 0);
+  const segs = u.pathname.split("/").filter(s => s.length > 0);
   if (segs.length < 3) {
     return null;
   }
@@ -48,50 +60,51 @@ function parseGitHubRaw(url, ghrawHost) {
     owner: segs[0],
     repo: segs[1],
     ref: segs[2],
-    rest: segs.slice(3).join('/')
+    rest: segs.slice(3).join("/")
   };
 }
 
 function escapeAttr(value) {
-  return String(value).replace(/&/g, '&amp;').replace(/"/g, '&quot;');
+  return String(value).replace(/&/g, "&amp;").replace(/"/g, "&quot;");
 }
 
 /**
  * 生成远程 Markdown 渲染占位标记。
- * options: { id, replace, heading, ghraw }
+ * options: { id, replace, heading, rawUrl }
  */
 function mdrenderHtml(src, options = {}) {
-  const parsed = parseGitHubRaw(src, options.ghraw);
+  const configuredRawUrl = options.rawUrl;
+  const parsed = parseGitHubRaw(src, configuredRawUrl);
   let url = src;
   let base = null;
   if (parsed) {
-    // 未传 ghraw 时保留 src 原 host，不硬编码默认值
-    const ghraw = options.ghraw || parsed.host;
+    const origin = rawOrigin(configuredRawUrl) || `https://${parsed.host}`;
     const dir = `${parsed.owner}/${parsed.repo}/${parsed.ref}/`;
-    url = `https://${ghraw}/${dir}${parsed.rest}`;
-    base = `https://${ghraw}/${dir}`;
+    url = `${origin}/${dir}${parsed.rest}`;
+    base = `${origin}/${dir}`;
   }
-  let el = '<div class="data-service ds-mdrender"';
+  let el = "<div class=\"data-service ds-mdrender\"";
   el += ` src="${escapeAttr(url)}"`;
   if (base) {
     el += ` data-base="${escapeAttr(base)}"`;
   }
   if (options.replace === true) {
-    el += ' data-replace="true"';
+    el += " data-replace=\"true\"";
   }
   if (options.heading !== false) {
-    el += ' data-heading="true"';
+    el += " data-heading=\"true\"";
   }
   if (options.id) {
     el += ` id="${escapeAttr(options.id)}"`;
   }
-  el += '></div>';
+  el += "></div>";
   return el;
 }
 
 module.exports = {
   GITHUB_RAW_HOST,
   PLACEHOLDER_CLASS,
+  rawOrigin,
   parseGitHubRaw,
   mdrenderHtml
 };

package/scripts/lib/menu.js

@@ -0,0 +1,36 @@
+"use strict";
+
+const { normalize_path: normalizePath } = require("./path_utils");
+
+function localPath(value) {
+  if (typeof value !== "string") return null;
+  const withoutQuery = value.split(/[?#]/, 1)[0];
+  if (/^(?:[a-z][a-z\d+.-]*:)?\/\//i.test(withoutQuery)) return null;
+  const normalized = normalizePath(withoutQuery || "/");
+  if (normalized === "") return "/";
+  return normalized.startsWith("/") ? normalized : `/${normalized}`;
+}
+
+function resolveMenuActiveByPath(items, pagePath, urlFor = value => value) {
+  if (!Array.isArray(items)) return null;
+  const currentPath = localPath(urlFor(pagePath || "/"));
+  if (currentPath == null) return null;
+
+  let match = null;
+  let matchLength = -1;
+  for (const item of items) {
+    if (item == null || item.type === "search" || typeof item.id !== "string" || typeof item.url !== "string") continue;
+    const itemPath = localPath(urlFor(item.url));
+    if (itemPath == null) continue;
+    const active = itemPath === "/"
+      ? currentPath === "/"
+      : currentPath === itemPath || currentPath.startsWith(`${itemPath}/`);
+    if (active && itemPath.length > matchLength) {
+      match = item.id;
+      matchLength = itemPath.length;
+    }
+  }
+  return match;
+}
+
+module.exports = { localPath, resolveMenuActiveByPath };

package/scripts/lib/model-schema.js

@@ -0,0 +1,90 @@
+/* global hexo */
+"use strict";
+
+const { MODEL_SCHEMAS, PROFILES } = require("../schema/model-schema");
+
+class ModelSchemaError extends Error {
+  constructor(issues) {
+    super(`Stellar v2 模型 Schema 校验失败：\n${issues.map(issue => `- ${issue}`).join("\n")}`);
+    this.name = "ModelSchemaError";
+    this.issues = issues;
+  }
+}
+
+function isPlainObject(value) {
+  if (value == null || typeof value !== "object" || Array.isArray(value)) return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+
+function valueType(value) {
+  if (Array.isArray(value)) return "array";
+  if (value === null) return "null";
+  return typeof value;
+}
+
+function matchesType(value, type) {
+  if (type === "any") return true;
+  if (type === "array") return Array.isArray(value);
+  if (type === "object") return isPlainObject(value);
+  if (type === "number") return typeof value === "number" && Number.isFinite(value);
+  if (type === "null") return value === null;
+  return typeof value === type;
+}
+
+function resolveReference(reference, profile) {
+  if (reference === "CollectionModel") return MODEL_SCHEMAS.CollectionModel.profiles[profile];
+  if (reference === "ContentItemModel") return MODEL_SCHEMAS.ContentItemModel.schema;
+  throw new ModelSchemaError([`未知模型引用 ${reference}`]);
+}
+
+function validateNode(node, value, path, profile, issues) {
+  if (!node.type.some(type => matchesType(value, type))) {
+    issues.push(`${path} 应为 ${node.type.join(" | ")}，实际为 ${valueType(value)}`);
+    return;
+  }
+
+  if (node.reference) {
+    validateNode(resolveReference(node.reference, profile), value, path, profile, issues);
+    return;
+  }
+
+  if (Array.isArray(value) && node.items) {
+    value.forEach((item, index) => validateNode(node.items, item, `${path}[${index}]`, profile, issues));
+    return;
+  }
+
+  if (!isPlainObject(value)) return;
+  const properties = node.properties || {};
+  for (const [key, child] of Object.entries(properties)) {
+    if (child.required && !Object.prototype.hasOwnProperty.call(value, key)) {
+      issues.push(`${path}.${key} 缺少必填模型字段`);
+      continue;
+    }
+    if (Object.prototype.hasOwnProperty.call(value, key)) {
+      validateNode(child, value[key], `${path}.${key}`, profile, issues);
+    }
+  }
+  if (!node.additionalProperties) {
+    for (const key of Object.keys(value)) {
+      if (!Object.prototype.hasOwnProperty.call(properties, key)) {
+        issues.push(`${path}.${key} 未在模型 Schema 中声明`);
+      }
+    }
+  }
+}
+
+function assertPageViewModel(profile, value) {
+  if (!PROFILES.includes(profile)) {
+    throw new ModelSchemaError([`未知 Collection profile ${profile}`]);
+  }
+  const issues = [];
+  validateNode(MODEL_SCHEMAS.PageViewModel.profiles[profile], value, "PageViewModel", profile, issues);
+  if (issues.length > 0) throw new ModelSchemaError(issues);
+  return value;
+}
+
+module.exports = {
+  ModelSchemaError,
+  assertPageViewModel
+};