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

package/scripts/lib/share-services.js

@@ -0,0 +1,96 @@
+"use strict";
+
+const SHARE_SERVICE_IDS = Object.freeze([
+  "wechat",
+  "weibo",
+  "x",
+  "telegram",
+  "whatsapp",
+  "email",
+  "link",
+  "system"
+]);
+
+const SHARE_SERVICE_SET = new Set(SHARE_SERVICE_IDS);
+const SHARE_SERVICE_LABELS = Object.freeze({
+  wechat: "WeChat",
+  weibo: "Weibo",
+  email: "Email",
+  link: "Link",
+  system: "System",
+  x: "X",
+  telegram: "Telegram",
+  whatsapp: "WhatsApp"
+});
+
+function text(value) {
+  return value == null ? "" : String(value);
+}
+
+function query(pairs) {
+  return pairs
+    .filter(([, value, omitEmpty]) => !omitEmpty || value !== "")
+    .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
+    .join("&");
+}
+
+function filterShareServices(services) {
+  if (!Array.isArray(services)) return [];
+  return services.filter(service => SHARE_SERVICE_SET.has(service));
+}
+
+function buildShareAction(service, share = {}) {
+  if (!SHARE_SERVICE_SET.has(service)) return null;
+  const permalink = text(share.permalink);
+  const title = text(share.title);
+  const image = text(share.image);
+  const summary = text(share.summary);
+  const action = {
+    service,
+    label: SHARE_SERVICE_LABELS[service]
+  };
+
+  if (service === "wechat") {
+    action.kind = "toggle";
+    action.target = "qrcode-wechat";
+  } else if (service === "weibo") {
+    action.kind = "external";
+    action.href = `https://service.weibo.com/share/share.php?${query([
+      ["url", permalink],
+      ["title", title],
+      ["pics", image, true],
+      ["summary", summary]
+    ])}`;
+  } else if (service === "email") {
+    action.kind = "link";
+    action.href = `mailto:?${query([["subject", title], ["body", permalink]])}`;
+  } else if (service === "link") {
+    action.kind = "copy";
+    action.target = "copy-link";
+  } else if (service === "system") {
+    action.kind = "native";
+    action.data = {
+      title,
+      text: summary || title,
+      url: permalink
+    };
+    action.target = "copy-link";
+  } else if (service === "x") {
+    action.kind = "external";
+    action.href = `https://x.com/intent/tweet?${query([["text", title], ["url", permalink]])}`;
+  } else if (service === "telegram") {
+    action.kind = "external";
+    action.href = `https://t.me/share/url?${query([["url", permalink], ["text", title]])}`;
+  } else if (service === "whatsapp") {
+    action.kind = "external";
+    action.href = `https://wa.me/?${query([["text", `${title}\n${permalink}`]])}`;
+  }
+
+  return action;
+}
+
+module.exports = {
+  SHARE_SERVICE_IDS,
+  buildShareAction,
+  filterShareServices
+};

package/scripts/lib/source-config.js

@@ -0,0 +1,27 @@
+/* global hexo */
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+const frontMatter = require("hexo-front-matter");
+
+function sourcePathForData(key) {
+  return `source/_data/${key}.yml`;
+}
+
+function sourcePathForPage(page) {
+  return page.source ? `source/${page.source}` : (page.path || "<page>");
+}
+
+function readFrontMatter(ctx, page) {
+  if (!page.source) return null;
+  const sourcePath = path.join(ctx.source_dir, page.source);
+  if (!fs.existsSync(sourcePath)) return null;
+  return frontMatter.parse(fs.readFileSync(sourcePath, "utf8"));
+}
+
+module.exports = {
+  readFrontMatter,
+  sourcePathForData,
+  sourcePathForPage
+};

package/scripts/lib/theme-metadata.js

@@ -0,0 +1,22 @@
+/* global hexo */
+"use strict";
+
+const { deepFreeze } = require("../schema/schema-utils");
+const pkg = require("../../package.json");
+
+const repositoryValue = typeof pkg.repository === "string" ? pkg.repository : pkg.repository?.url;
+const repository = repositoryValue.replace(/^git\+/, "").replace(/\.git$/, "");
+const displayName = pkg.name
+  .replace(/^hexo-theme-/, "")
+  .replace(/(^|-)([a-z])/g, (_, separator, letter) => `${separator ? " " : ""}${letter.toUpperCase()}`);
+
+module.exports = deepFreeze({
+  name: displayName,
+  version: pkg.version,
+  homepage: pkg.homepage,
+  repository,
+  assets: {
+    mainCss: "/css/main.css",
+    mainJs: "/js/main.js"
+  }
+});

package/scripts/lib/ui-capabilities.js

@@ -0,0 +1,32 @@
+"use strict";
+
+const UI_CAPABILITIES = Object.freeze({
+  interactive: "ui-interactive",
+  interactiveSpotlight: "ui-interactive card-hover card-hover--spotlight",
+  collectionItem: "ui-collection__item ui-interactive card-hover card-hover--spotlight",
+  spotlight: "card-hover card-hover--spotlight",
+  hoverCard: "card-hover card-hover--spotlight card-hover--tilt"
+});
+
+function appendTokens(target, value) {
+  if (typeof value !== "string") return;
+  for (const token of value.trim().split(/\s+/)) {
+    if (token && !target.includes(token)) target.push(token);
+  }
+}
+
+function composeUiClasses(baseClass, capability = "interactiveSpotlight", modifiers = "") {
+  if (!Object.prototype.hasOwnProperty.call(UI_CAPABILITIES, capability)) {
+    throw new TypeError(`unknown UI capability: ${capability}`);
+  }
+  const classes = [];
+  appendTokens(classes, baseClass);
+  appendTokens(classes, UI_CAPABILITIES[capability]);
+  appendTokens(classes, modifiers);
+  return classes.join(" ");
+}
+
+module.exports = {
+  UI_CAPABILITIES,
+  composeUiClasses
+};

package/scripts/lib/widget-registry.js

@@ -0,0 +1,150 @@
+"use strict";
+
+const REGION_PRESENTATIONS = Object.freeze({
+  topbar: "topbar",
+  leftbar: "leftbar",
+  rightbar: "rightbar"
+});
+
+const DEFAULT_PRESENTATIONS = Object.freeze(["leftbar", "rightbar", "drawer"]);
+
+const PRESENTATIONS_BY_LAYOUT = Object.freeze({
+  menu: Object.freeze(["topbar", "leftbar", "leftbarRail", "drawer"]),
+  settings: Object.freeze(["topbar", "leftbar", "leftbarRail", "drawer"]),
+  spacer: Object.freeze(["topbar"]),
+  toc: Object.freeze(["topbar", "leftbar", "rightbar", "drawer"]),
+  tree: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  tagtree: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  recent: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  related: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  ghrepo: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  ghissues: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  ghuser: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  author: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  timeline: Object.freeze(["leftbar", "rightbar", "drawer"]),
+  markdown: Object.freeze(["leftbar", "rightbar", "drawer"])
+});
+
+const SYSTEM_WIDGETS = Object.freeze({
+  menu: Object.freeze({ layout: "menu", system: true }),
+  settings: Object.freeze({ layout: "settings", system: true }),
+  spacer: Object.freeze({ layout: "spacer", system: true })
+});
+
+function clone(value) {
+  if (Array.isArray(value)) return value.map(clone);
+  if (value == null || typeof value !== "object") return value;
+  return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, clone(child)]));
+}
+
+function freeze(value) {
+  if (value == null || typeof value !== "object" || Object.isFrozen(value)) return value;
+  Object.values(value).forEach(freeze);
+  return Object.freeze(value);
+}
+
+function normalizedPresentations(descriptor, layout) {
+  if (Array.isArray(descriptor?.presentations)) return Object.freeze(descriptor.presentations.slice());
+  return PRESENTATIONS_BY_LAYOUT[layout] || DEFAULT_PRESENTATIONS;
+}
+
+function leftbarZone(layout) {
+  if (layout === "settings") return "system";
+  return "body";
+}
+
+function widgetSource(specification) {
+  if (typeof specification === "string") return { id: specification, override: null };
+  if (specification != null && typeof specification === "object") {
+    return {
+      id: typeof specification.override === "string" ? specification.override : null,
+      override: specification
+    };
+  }
+  return { id: null, override: null };
+}
+
+function resolveWidget(specification, catalog, context = {}) {
+  const region = context.region;
+  const index = Number.isInteger(context.index) ? context.index : 0;
+  const source = widgetSource(specification);
+  const registered = source.id == null
+    ? null
+    : (SYSTEM_WIDGETS[source.id] || catalog?.[source.id] || null);
+  const descriptor = Object.assign({}, registered || {}, source.override || {});
+  const layout = typeof descriptor.layout === "string" ? descriptor.layout : source.id;
+  if (["brand", "actions"].includes(layout)) {
+    return freeze({ instance: null, warning: {
+      code: "fixed_region_content",
+      widget: source.id || layout,
+      layout,
+      region,
+      supported: []
+    } });
+  }
+  if (!layout || (!registered && source.override == null)) {
+    return freeze({ instance: null, warning: {
+      code: "unknown_widget",
+      widget: source.id || "<invalid>",
+      layout: layout || "<unknown>",
+      region,
+      supported: []
+    } });
+  }
+  if (context.region === "leftbar" && context.contentOnly === true && ["menu", "settings"].includes(layout)) {
+    return freeze({ instance: null, warning: {
+      code: "fixed_leftbar_widget",
+      widget: source.id || layout,
+      layout,
+      region: context.region,
+      supported: ["topbar"]
+    } });
+  }
+  // presentation 是 Widget 类型能力，不允许实例通过内联参数抬高权限。
+  const presentations = normalizedPresentations(registered, layout);
+  const target = REGION_PRESENTATIONS[region];
+  if (!target || !presentations.includes(target)) {
+    return freeze({ instance: null, warning: {
+      code: "unsupported_widget_presentation",
+      widget: source.id || layout,
+      layout,
+      region,
+      supported: presentations.slice()
+    } });
+  }
+  const id = source.id || layout;
+  return freeze({
+    instance: {
+      instanceId: `${region}:${index}:${id}`,
+      id,
+      layout,
+      system: descriptor.system === true,
+      presentation: target,
+      presentations: presentations.slice(),
+      leftbarZone: leftbarZone(layout),
+      item: clone(descriptor)
+    },
+    warning: null
+  });
+}
+
+function resolveRegionWidgets(widgets, catalog, context = {}) {
+  const instances = [];
+  const warnings = [];
+  for (const [index, specification] of (Array.isArray(widgets) ? widgets : []).entries()) {
+    const result = resolveWidget(specification, catalog, { ...context, index });
+    if (result.instance) instances.push(result.instance);
+    if (result.warning) warnings.push({ ...result.warning, profile: context.profile || null });
+  }
+  return freeze({ instances, warnings });
+}
+
+module.exports = {
+  DEFAULT_PRESENTATIONS,
+  PRESENTATIONS_BY_LAYOUT,
+  REGION_PRESENTATIONS,
+  SYSTEM_WIDGETS,
+  leftbarZone,
+  resolveRegionWidgets,
+  resolveWidget
+};

package/scripts/lib/wiki_readme.js

@@ -1,3 +1,5 @@
+/* global hexo */
+
 /**
  * wiki_readme.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
  *
@@ -5,28 +7,29 @@
  * 以该仓库 README.md 作为主页正文（复用底层远程 md 渲染组件）。
  */
 
-'use strict';
+"use strict";
 
-const { mdrenderHtml } = require('./mdrender_html');
+const { mdrenderHtml, rawOrigin } = require("./mdrender_html");
 
 /**
- * README 地址。host 由调用方从主题配置 api_host.ghraw 传入；
+ * README 地址。rawUrl 由调用方从 services.github.raw_url 传入；
  * branch 缺省用 GitHub HEAD（自动指向默认分支）。
  */
-function readmeUrl(repo, branch, host) {
-  return `https://${host}/${repo}/${branch || 'HEAD'}/README.md`;
+function readmeUrl(repo, branch, rawUrl) {
+  const origin = rawOrigin(rawUrl) || "";
+  return `${origin}/${repo}/${branch || "HEAD"}/README.md`;
 }
 
 // 页面正文是否为空（剪裁多余空行、空格后判断）
 function isEmptyContent(page) {
-  return !page || !String(page.content || '').trim();
+  return !page || !String(page.content || "").trim();
 }
 
 /**
  * 判定是否 README 主页：配置了 repo 的项目首页且正文为空。
  */
 function isWikiReadmePage(proj, page) {
-  if (!proj || !proj.repo || !page || !proj.homepage) {
+  if (!proj || !proj.source?.repository || !page || !proj.homepage) {
     return false;
   }
   if (!isEmptyContent(page)) {
@@ -37,14 +40,15 @@ function isWikiReadmePage(proj, page) {
 
 /**
  * 生成 README 主页占位（原地替换模式）；不适用时返回空串。
- * options: { ghraw }
+ * options: { rawUrl }
  */
 function wikiReadmeHtml(proj, page, options = {}) {
   if (!isWikiReadmePage(proj, page)) {
-    return '';
+    return "";
   }
-  return mdrenderHtml(readmeUrl(proj.repo, proj.branch, options.ghraw), {
-    ghraw: options.ghraw,
+  const rawUrl = options.rawUrl;
+  return mdrenderHtml(readmeUrl(proj.source.repository, proj.source.branch, rawUrl), {
+    rawUrl,
     replace: true
   });
 }