hexo-component-inferno 4.2.2 → 5.0.0

package/lib/schema/plugin/outdated_browser.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "/plugin/outdated_browser.json",
-  "description": "Enable the Outdated Browser plugin\nhttp://outdatedbrowser.com/",
+  "description": "Warn when required CSS features are unsupported",
   "type": "boolean",
   "default": false
 }

package/lib/schema/share/bdshare.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "/share/bdshare.json",
-  "description": "Enable Baidu share buttons",
+  "description": "Baidu share buttons (deprecated)",
   "type": "object",
   "properties": {
     "type": {

package/lib/schema/share/sharejs.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "/share/sharejs.json",
-  "description": "Enable Share.js share buttons\nhttps://github.com/overtrue/share.js/",
+  "description": "Share.js (retired; select web_share or addtoany)",
   "type": "object",
   "properties": {
     "type": {

package/lib/schema/share/web_share.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/share/web_share.json",
+  "description": "Social sharing links and a native Web Share button",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "web_share"
+    }
+  },
+  "required": ["type"]
+}

package/lib/schema/widget/github_calendar.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/widget/github_calendar.json",
+  "description": "Responsive GitHub contribution calendar. Data is loaded from the third-party github-contributions-api.jogruber.de service; no GitHub token is needed",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "github_calendar"
+    },
+    "username": {
+      "type": "string",
+      "description": "GitHub username. Leave empty to hide this widget",
+      "pattern": "^$|^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,37}[a-zA-Z0-9])?$",
+      "nullable": true
+    },
+    "title": {
+      "type": "string",
+      "description": "Widget title. Leave empty to use the translated default",
+      "nullable": true
+    },
+    "color": {
+      "type": "string",
+      "description": "Optional six-digit hex color, for example '#40c463'. Leave empty to use the theme's calendar palette",
+      "pattern": "^$|^#?[a-fA-F0-9]{6}$",
+      "nullable": true
+    }
+  },
+  "required": ["type"]
+}

package/lib/schema/widget/profile.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/widget/profile.json",
+  "description": "Profile widget configurations",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "profile",
+      "nullable": true
+    },
+    "author": {
+      "type": "string",
+      "description": "Author name",
+      "examples": ["Your name"],
+      "nullable": true
+    },
+    "author_title": {
+      "type": "string",
+      "description": "Author title",
+      "examples": ["Your title"],
+      "nullable": true
+    },
+    "location": {
+      "type": "string",
+      "description": "Author's current location",
+      "examples": ["Your location"],
+      "nullable": true
+    },
+    "avatar": {
+      "type": "string",
+      "description": "URL or path to the avatar image",
+      "nullable": true
+    },
+    "avatar_rounded": {
+      "type": "boolean",
+      "description": "Whether show the rounded avatar image",
+      "default": false,
+      "nullable": true
+    },
+    "gravatar": {
+      "type": "string",
+      "description": "Email address for the Gravatar",
+      "nullable": true
+    },
+    "follow_link": {
+      "type": "string",
+      "description": "URL or path for the follow button",
+      "examples": ["https://github.com/ppoffice"],
+      "nullable": true
+    },
+    "social_links": {
+      "$ref": "/misc/poly_links.json",
+      "description": "Links to be shown on the bottom of the profile widget",
+      "examples": [
+        {
+          "Github": { "icon": "fab fa-github", "url": "https://github.com/ppoffice" },
+          "Facebook": { "icon": "fab fa-facebook", "url": "https://facebook.com" },
+          "Twitter": { "icon": "fab fa-twitter", "url": "https://twitter.com" },
+          "Dribbble": { "icon": "fab fa-dribbble", "url": "https://dribbble.com" },
+          "RSS": { "icon": "fas fa-rss", "url": "/" }
+        }
+      ]
+    }
+  },
+  "required": ["type"]
+}

package/lib/util/archives.js

@@ -0,0 +1,86 @@
+/**
+ * Internal option and grouping logic for the archives widget. No Hexo imports, helpers or JSX.
+ * @module util/archives
+ * @private
+ */
+
+function firstSet(...values) {
+  return values.find(value => value !== null && typeof value !== 'undefined');
+}
+
+/**
+ * Resolve archive option aliases/defaults without coercing false, zero or empty strings.
+ * @param {Object} widget Archives widget options.
+ * @returns {Object} Resolved grouping, ordering, formatting, limit and count-display options.
+ */
+function resolveArchiveOptions(widget) {
+  const groupBy = firstSet(widget.group_by, 'monthly');
+  const order = firstSet(widget.order, -1);
+  const {
+    format,
+    amount
+  } = widget;
+  const showCount = firstSet(widget.show_count, widget.showCount, true);
+  return {
+    groupBy,
+    order,
+    format,
+    amount,
+    showCount
+  };
+}
+
+// Same conversion as Hexo's toMomentLocale, without depending on Hexo's private modules.
+function toMomentLocale(lang) {
+  if (lang === undefined) return undefined;
+  if (!lang || lang === 'en' || lang === 'default') return 'en';
+  return lang.toLowerCase().replace('_', '-');
+}
+
+/**
+ * Group already ordered posts by consecutive formatted names and apply the archive limit.
+ * The first date in each group supplies its year/month even when a custom format merges years.
+ * Sorting stays with the Hexo collection adapter; this function only needs forEach and date.clone.
+ * @param {{forEach: Function}} posts Ordered records with Moment-compatible date values.
+ * @param {Object} options groupBy/format/amount plus the selected language code and timezone.
+ * @returns {Object} Selected groups ({name, year, month, count}) and hasMore; URLs remain unresolved.
+ */
+function groupArchives(posts, options) {
+  const {
+    groupBy,
+    format,
+    amount,
+    timezone
+  } = options;
+  const language = toMomentLocale(options.language);
+  const groups = [];
+  let length = 0;
+  posts.forEach(post => {
+    let date = post.date.clone();
+    if (timezone) date = date.tz(timezone);
+    if (language) date = date.locale(language);
+    const year = date.year();
+    const month = date.month() + 1;
+    const name = date.format(format || (groupBy === 'monthly' ? 'MMMM YYYY' : 'YYYY'));
+    const last = groups[length - 1];
+    if (!last || last.name !== name) {
+      length = groups.push({
+        name,
+        year,
+        month,
+        count: 1
+      });
+    } else {
+      last.count++;
+    }
+  });
+  const hasMore = amount > 0 && groups.length > amount;
+  return {
+    groups: hasMore ? groups.slice(0, amount) : groups,
+    hasMore
+  };
+}
+module.exports = {
+  resolveArchiveOptions,
+  groupArchives
+};

package/lib/util/categories.js

@@ -0,0 +1,102 @@
+/**
+ * Internal category option and tree preparation, independent of Hexo initialization and JSX.
+ * @module util/categories
+ * @private
+ */
+
+function firstSet(...values) {
+  return values.find(value => value !== null && typeof value !== 'undefined');
+}
+
+/**
+ * Resolve aliases/defaults without coercing explicit false, zero or empty strings.
+ * @param {Object} widget Categories widget options.
+ * @returns {Object} order, orderBy, showCurrent and showCount.
+ */
+function resolveCategoryOptions(widget) {
+  const order = firstSet(widget.order, 1);
+  const orderBy = firstSet(widget.order_by, widget.orderBy, 'name');
+  const showCurrent = firstSet(widget.show_current, widget.showCurrent, false);
+  const showCount = firstSet(widget.show_count, widget.showCount, true);
+  return {
+    order,
+    orderBy,
+    showCurrent,
+    showCount
+  };
+}
+
+/**
+ * Parse depth only after the caller's empty-source check, retaining parseInt and zero-as-unlimited.
+ * @param {*} depth Widget depth.
+ * @param {*} fallback Legacy top-level props.depth.
+ * @returns {number} Parsed depth, or zero for an unset/unparseable value.
+ */
+function resolveCategoryDepth(depth, fallback) {
+  return parseInt(firstSet(depth, fallback), 10) || 0;
+}
+function prepareQuery(categories, parent, orderBy, order) {
+  const query = {};
+  if (parent) query.parent = parent;else query.parent = {
+    $exists: false
+  };
+  return categories.find(query).sort(orderBy, order).filter(cat => cat.length);
+}
+function currentCategory(cat, page) {
+  let isCurrent = false;
+  for (let j = 0; j < cat.length; j++) {
+    const post = cat.posts.data[j];
+    if (post && post._id === page._id) {
+      isCurrent = true;
+      break;
+    }
+  }
+  // Preserve both the raw prefix test and its falsey/unset result, rather than coercing to boolean.
+  return isCurrent || page.base && page.base.startsWith(cat.path);
+}
+
+/**
+ * Prepare the category tree through the collection's existing find/sort/filter/map contract.
+ * URLs are resolved in the original depth-first postorder, even for subsequently hidden roots.
+ * Keeping the URL helper at this point also preserves helper calls before later query/current errors.
+ * @param {Object} categories Queryable source with the existing find/sort/filter/map contract.
+ * @param {Object} options Resolved order/orderBy/showCurrent/depth plus raw amount.
+ * @param {Object} page Current page; an unset page skips current checks.
+ * @param {Function} url_for Existing URL helper, not a generic node projection.
+ * @returns {Object} Selected categories ({children, isCurrent, name, count, url}) and hasMore.
+ */
+function prepareCategories(categories, options, page, url_for) {
+  const {
+    order,
+    orderBy,
+    showCurrent,
+    depth,
+    amount
+  } = options;
+  function hierarchicalList(level, parent) {
+    return prepareQuery(categories, parent, orderBy, order).map(cat => {
+      let children = [];
+      if (!depth || level + 1 < depth) children = hierarchicalList(level + 1, cat._id);
+      let isCurrent = false;
+      if (showCurrent && page) isCurrent = currentCategory(cat, page);
+      return {
+        children,
+        isCurrent,
+        name: cat.name,
+        count: cat.length,
+        url: url_for(cat.path)
+      };
+    });
+  }
+  const list = hierarchicalList(0);
+  const hasMore = amount > 0 && list.length > amount;
+  return {
+    categories: hasMore ? list.slice(0, amount) : list,
+    hasMore
+  };
+}
+module.exports = {
+  resolveCategoryOptions,
+  resolveCategoryDepth,
+  prepareCategories
+};

package/lib/util/cdn-rules.js

@@ -0,0 +1,109 @@
+/**
+ * Provider templates and package compatibility rules, private to the URL resolver.
+ * @module util/cdn-rules
+ * @private
+ */
+const PROVIDERS = {
+  LIBRARY: {
+    cdnjs: '[cdnjs]https://cdnjs.cloudflare.com/ajax/libs/${ package }/${ version }/${ filename }',
+    loli: '[cdnjs]https://cdnjs.loli.net/ajax/libs/${ package }/${ version }/${ filename }',
+    jsdelivr: 'https://cdn.jsdelivr.net/npm/${ package }@${ version }/${ filename }',
+    unpkg: 'https://unpkg.com/${ package }@${ version }/${ filename }'
+  },
+  FONT: {
+    google: 'https://fonts.googleapis.com/${ type }?family=${ fontname }',
+    loli: 'https://fonts.loli.net/${ type }?family=${ fontname }',
+    fontim: 'https://fonts.font.im/${ type }?family=${ fontname }',
+    ustc: 'https://fonts.lug.ustc.edu.cn/${ type }?family=${ fontname }'
+  },
+  ICON: {
+    loli: 'https://cdnjs.loli.net/ajax/libs/font-awesome/6.0.0/css/all.min.css',
+    fontawesome: 'https://use.fontawesome.com/releases/v6.0.0/css/all.css'
+  }
+};
+function stripPrefix(filename, prefix) {
+  return filename.startsWith(prefix) ? filename.substr(prefix.length) : filename;
+}
+function stripMin(filename) {
+  return filename.indexOf('.min.') > -1 ? filename.replace(/\.min\./gi, '.') : filename;
+}
+
+// An absent mapping preserves the npm path; null means the provider lacks the package.
+const PACKAGE_RULES = {
+  'justified-gallery': {
+    cdnjs: null
+  },
+  '@mathjax/mathjax-newcm-font': {
+    cdnjs: null
+  },
+  lightgallery: {
+    // cdnjs itself serves this release, but its loli mirror lacks the CSS, core and plugins.
+    unavailable: [{
+      provider: 'loli',
+      version: '3.0.0'
+    }]
+  },
+  disqusjs: {
+    cdnjs: {
+      filename: file => stripPrefix(file, 'dist/browser/')
+    },
+    unpkg: {
+      filename: file => file.startsWith('dist/browser/') ? file : file.replace(/\.min\./gi, '.')
+    }
+  },
+  moment: {
+    cdnjs: {
+      package: 'moment.js',
+      filename: file => stripPrefix(file, 'min/')
+    }
+  },
+  outdatedbrowser: {
+    cdnjs: {
+      package: 'outdated-browser',
+      filename: file => stripPrefix(file, 'outdatedbrowser/')
+    }
+  },
+  'highlight.js': {
+    cdnjs: {
+      filename: file => file.endsWith('.css') && file.indexOf('.min.') === -1 ? file.substr(0, file.length - 4) + '.min.css' : file
+    }
+  },
+  mathjax: {
+    cdnjs: {
+      filename: file => stripMin(stripPrefix(file, 'unpacked/'))
+    },
+    unpkg: {
+      filename: stripMin
+    }
+  },
+  katex: {
+    cdnjs: {
+      package: 'KaTeX'
+    }
+  },
+  'pace-js': {
+    cdnjs: {
+      package: 'pace'
+    }
+  },
+  clipboard: {
+    cdnjs: {
+      package: 'clipboard.js'
+    }
+  },
+  cookieconsent: {
+    cdnjs: {
+      filename: file => stripPrefix(file, 'build/')
+    }
+  },
+  '@waline/client': {
+    cdnjs: {
+      package: 'waline'
+    }
+  }
+};
+module.exports = {
+  PROVIDERS,
+  PACKAGE_RULES,
+  stripPrefix
+};

package/lib/util/cdn.js

@@ -0,0 +1,116 @@
+/**
+ * Pure CDN URL resolution. Hexo registration and package compatibility rules stay separate.
+ * @module util/cdn
+ * @private
+ */
+const {
+  PROVIDERS,
+  PACKAGE_RULES,
+  stripPrefix
+} = require('./cdn-rules');
+function selectLibraryProvider(providers, name) {
+  const {
+    cdn_overrides: overrides
+  } = providers;
+  return typeof overrides === 'object' && overrides !== null && overrides[name] ? overrides[name] : providers.cdn || 'jsdelivr';
+}
+function packageRule(name) {
+  return Object.prototype.hasOwnProperty.call(PACKAGE_RULES, name) ? PACKAGE_RULES[name] : {};
+}
+function resolveLibraryAsset(provider, asset) {
+  let template = provider in PROVIDERS.LIBRARY ? PROVIDERS.LIBRARY[provider] : provider;
+  const unavailable = typeof asset.package === 'string' && packageRule(asset.package).unavailable;
+  if (unavailable && unavailable.some(entry => entry.provider === provider && entry.version === asset.version)) {
+    return {
+      template: PROVIDERS.LIBRARY.jsdelivr,
+      asset
+    };
+  }
+  let family = provider === 'unpkg' ? 'unpkg' : null;
+  if (template.startsWith('[cdnjs]')) {
+    family = 'cdnjs';
+    template = template.substr(7);
+  }
+  if (!family) return {
+    template,
+    asset
+  };
+  try {
+    const mapping = packageRule(asset.package)[family];
+    if (mapping === null) return {
+      template: PROVIDERS.LIBRARY.jsdelivr,
+      asset
+    };
+    if (mapping) {
+      // Commit a mapping only after its path conversion succeeds. Later failures retain renames.
+      asset = {
+        package: mapping.package || asset.package,
+        version: asset.version,
+        filename: mapping.filename ? mapping.filename(asset.filename) : asset.filename
+      };
+    }
+    if (family === 'cdnjs') asset.filename = stripPrefix(asset.filename, 'dist/');
+  } catch (e) {
+    template = PROVIDERS.LIBRARY.jsdelivr;
+  }
+  return {
+    template,
+    asset
+  };
+}
+function formatLibraryUrl({
+  template,
+  asset
+}) {
+  return template.replace(/\${\s*package\s*}/gi, asset.package).replace(/\${\s*version\s*}/gi, asset.version).replace(/\${\s*filename\s*}/gi, asset.filename);
+}
+
+/**
+ * Resolve a library URL with optional per-package provider overrides.
+ * @param {Object} providers Provider configuration.
+ * @param {string} _package npm package name.
+ * @param {string} version Library version.
+ * @param {string} filename Path in the npm package.
+ * @returns {string} The resolved URL.
+ */
+function resolveCdn(providers, _package, version, filename) {
+  const provider = selectLibraryProvider(providers, _package);
+  return formatLibraryUrl(resolveLibraryAsset(provider, {
+    package: _package,
+    version,
+    filename
+  }));
+}
+
+/**
+ * Resolve a web font URL; only undefined selects provider/type defaults.
+ * @param {Object} providers Provider configuration.
+ * @param {string} fontName Font family expression, unchanged by URL encoding.
+ * @param {string} [type=css] Google Fonts endpoint type.
+ * @returns {string} The resolved font URL.
+ */
+function resolveFontCdn(providers, fontName, type = 'css') {
+  let {
+    fontcdn = 'google'
+  } = providers;
+  if (fontcdn in PROVIDERS.FONT) fontcdn = PROVIDERS.FONT[fontcdn];
+  return fontcdn.replace(/\${\s*fontname\s*}/gi, fontName).replace(/\${\s*type\s*}/gi, type);
+}
+
+/**
+ * Select an icon provider URL without interpolating/coercing a custom value.
+ * @param {Object} providers Provider configuration.
+ * @returns {*} The known URL or original custom value.
+ */
+function resolveIconCdn(providers) {
+  let {
+    iconcdn = 'fontawesome'
+  } = providers;
+  if (iconcdn in PROVIDERS.ICON) iconcdn = PROVIDERS.ICON[iconcdn];
+  return iconcdn;
+}
+module.exports = {
+  resolveCdn,
+  resolveFontCdn,
+  resolveIconCdn
+};

package/lib/util/consent.js

@@ -0,0 +1,122 @@
+/* eslint-env browser */
+/**
+ * Consent boundary for the theme's explicitly classified analytics integrations.
+ * @module util/consent
+ */
+const {
+  toJs
+} = require('./script');
+
+// Kept self-contained because this function is emitted into the generated page.
+function installConsent(type) {
+  if (window.hexoComponentConsent) {
+    return;
+  }
+  const integrations = Object.create(null);
+  let started = false;
+  const status = (document.cookie.match(/(?:^|;\s*)cookieconsent_status=([^;]*)/) || [])[1];
+  let allowed = type === 'opt-out' ? status !== 'deny' : status === 'allow';
+  let popup = null;
+  function run() {
+    Object.keys(integrations).forEach(id => {
+      const integration = integrations[id];
+      if (allowed && !integration.started) {
+        integration.started = true;
+        started = true;
+        integration.start();
+      }
+    });
+  }
+  window.hexoComponentConsent = {
+    allowed: function () {
+      return allowed;
+    },
+    register: function (id, start, stop) {
+      if (!integrations[id]) {
+        integrations[id] = {
+          start: start,
+          stop: stop,
+          started: false
+        };
+      }
+      run();
+    },
+    setPopup: function (value) {
+      popup = value;
+    },
+    setStatus: function (value) {
+      const previous = allowed;
+      allowed = type === 'opt-out' ? value !== 'deny' : value === 'allow';
+      if (previous && !allowed) {
+        try {
+          Object.keys(integrations).forEach(id => {
+            const integration = integrations[id];
+            if (integration.started && integration.stop) {
+              integration.stop();
+            }
+          });
+        } finally {
+          // A loaded vendor SDK may own timers/listeners that cannot safely be unloaded.
+          // A new document, with the saved denial, is the generic stop boundary.
+          if (started) {
+            window.location.reload();
+          }
+        }
+      } else {
+        run();
+      }
+    },
+    revoke: function () {
+      if (popup) {
+        popup.setStatus('deny');
+      } else {
+        document.cookie = 'cookieconsent_status=deny; Path=/; Max-Age=31536000; SameSite=Lax';
+      }
+      // setStatus on the popup invokes this too; a repeated denial is harmless.
+      this.setStatus('deny');
+    },
+    open: function () {
+      if (popup) {
+        popup.open();
+      }
+    }
+  };
+}
+
+/**
+ * Build the idempotent browser-side consent controller. Info is deliberately not gated.
+ * @param {string} type CookieConsent mode.
+ * @returns {string} Inline JavaScript.
+ */
+function consentRuntime(type) {
+  return `(${installConsent.toString()})(${toJs(type)});`;
+}
+
+/**
+ * Defer all scripts (including inline SDK bootstrap code) until this integration is authorized.
+ * Noscript pixels are intentionally not restored: without JavaScript consent cannot be obtained.
+ * @param {string} id Stable integration ID, shared across PJAX navigations.
+ * @param {string} markup Rendered integration markup containing scripts.
+ * @param {string} type CookieConsent mode.
+ * @returns {string} Inline JavaScript without active external resources before permission.
+ */
+function gateMarkup(id, markup, type) {
+  return `${consentRuntime(type)}
+    window.hexoComponentConsent.register(${toJs(id)}, function () {
+      var template = document.createElement('template');
+      template.innerHTML = ${toJs(markup)};
+      template.content.querySelectorAll('script').forEach(function (source) {
+        if (!window.hexoComponentConsent.allowed()) return;
+        var script = document.createElement('script');
+        Array.prototype.forEach.call(source.attributes, function (attr) {
+          script.setAttribute(attr.name, attr.value);
+        });
+        script.textContent = source.textContent;
+        document.head.appendChild(script);
+      });
+    });`;
+}
+module.exports = {
+  consentRuntime,
+  gateMarkup
+};

package/lib/util/deprecate.js

@@ -13,7 +13,7 @@ const warned = new Set();
  * @param {string} name Name of the component, such as <code>share.addthis</code>.
  * @param {string} message Why the component is deprecated, and what to use instead.
  * @example
- * deprecate('share.addthis', 'AddThis shut down on May 31, 2023. Use AddToAny or ShareThis instead.');
+ * deprecate('share.addthis', 'Service shut down. Use AddToAny or ShareThis.');
  */
 function deprecate(name, message) {
   if (warned.has(name)) {