vitepress-linkcard 2.0.0 → 2.0.1

package/README.md

@@ -10,14 +10,14 @@ You can see: [A blog generated with this plugin](https://asumoranda.com/posts/10
 
 [![NPM Version](https://img.shields.io/npm/v/vitepress-linkcard?style=flat&logo=npm&logoColor=white&label=npmjs&color=%23CB3837)](https://www.npmjs.com/package/vitepress-linkcard)
 [![NPM bundle size](https://img.shields.io/bundlephobia/min/vitepress-linkcard)](https://www.npmjs.com/package/vitepress-linkcard)
-[![VitePress](https://img.shields.io/badge/For_VitePress-v1-%235C73E7?logo=vitepress&logoColor=white)](https://vuejs.github.io/vitepress/v1/)
+[![VitePress](https://img.shields.io/badge/For_VitePress-v1_|_v2-%235C73E7?logo=vitepress&logoColor=white)](https://vuejs.github.io/vitepress/v1]/)
 [![NPM License](https://img.shields.io/npm/l/vitepress-linkcard)](/LICENSE)
 
 [![Yarn](https://img.shields.io/badge/Built_with_Yarn-v4.9.2-%232C8EBB?logo=yarn&logoColor=white)](https://yarnpkg.com/)
 [![ESLint](https://img.shields.io/badge/Lint_with-ESLint-%234B32C3?style=flat&logo=eslint&logoColor=white&labelColor=gray)](https://github.com/asumo-1xts/vitepress-linkcard/actions/workflows/eslint.yml)
 [![Prettier](https://img.shields.io/badge/Format_with-Prettier-%23F7B93E?style=flat&logo=prettier&logoColor=white&labelColor=gray)](https://github.com/asumo-1xts/vitepress-linkcard/actions/workflows/prettier.yml)
 
-<img src="https://github.com/asumo-1xts/vitepress-linkcard/blob/main/.github/screen.webp?raw=true" width=90% alt="How it shows" />
+<img src="https://github.com/asumo-1xts/vitepress-linkcard/blob/main/.github/screen.gif?raw=true" width=90% alt="How it shows" />
 
 This plugin was forked from [markdown-it-link-to-card](https://github.com/luckrya/markdown-it-link-to-card).
 
@@ -88,7 +88,7 @@ You can customize:
 #### `docs/.vitepress/theme/custom.css`
 
 ```css
-/* For example: like Features in VitePress */
+/* For example: like "Features" in VitePress */
 
 .vitepress-linkcard-container {
   border-color: #00000000 !important;
@@ -104,7 +104,17 @@ You can customize:
 #### `docs/.vitepress/theme/index.ts`
 
 ``` ts
-import './style.css'
+import DefaultTheme from 'vitepress/theme-without-fonts'
+import type { Theme as ThemeConfig } from 'vitepress'
+import './custom.css'
+
+const Theme: ThemeConfig = {
+  extends: DefaultTheme
+}
+
+export default {
+  ...Theme
+}
 ```
 
 ## Other specifications

package/dist/.cjs.min.js

@@ -1,5 +1,5 @@
 /*!
-  * vitepress-linkcard v2.0.0
+  * vitepress-linkcard v2.0.1
   * (c) 2022 - 2026 luckrya
   * Released under the MIT License.
   */
@@ -8,7 +8,7 @@ Object.defineProperty(exports,"__esModule",{value:!0});var e=require("url"),t=re
   * @luckrya/utility v0.1.0
   * (c) 2022 - 2022 Y.R
   * Released under the MIT License.
-  */(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function m(e){var t=function(e,t){if("object"!=typeof e||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t||"default");if("object"!=typeof n)return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:t+""}(c=s||(s={})).Array="[object Array]",c.Object="[object Object]",c.Function="[object Function]",c.Number="[object Number]",c.String="[object String]",c.Boolean="[object Boolean]",c.Undefined="[object Undefined]",c.Null="[object Null]",c.Error="[object Error]";var x=function(e){return Object.prototype.toString.call(e)===s.String},S=function(e){return Object.prototype.toString.call(e)===s.Function},O="undefined"!=typeof window,k=function(){var e,t="".concat(process.cwd(),"/.linkcard_cache.json"),r="".concat(process.cwd(),"/.config/.linkcard_cache.json");if(h.default.existsSync(t))e=t;else if(h.default.existsSync(r))e=r;else{e=t;h.default.writeFileSync(e,JSON.stringify({"https://example.com/":{description:"Example Website",logo:"https://example.com/example.png",title:"Example Title"}},null,2))}return e},N=function(){return function(e,t,r){return t&&g(e.prototype,t),r&&g(e,r),Object.defineProperty(e,"prototype",{writable:!1}),e}(function e(){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,e)},[{key:"setFile",value:function(e){var t=e,r=this.readFile();r&&(t=Object.assign(r,t)),h.default.writeFileSync(k(),JSON.stringify(t)),function(){var e=k(),t=h.default.readFileSync(e,"utf-8").trim();if(t){var r=JSON.parse(t),n=JSON.stringify(r,null,2)+"\n";h.default.writeFileSync(e,n)}}()}},{key:"readFile",value:function(){var e=h.default.readFileSync(k(),"utf-8"),t=JSON.parse(e);if(function(e){return Object.prototype.toString.call(e)===s.Object}(t))return t}},{key:"has",value:function(e){return!!this.get(e)}},{key:"get",value:function(e){var t=this.readFile();return null==t?void 0:t[e]}},{key:"set",value:function(e,t){this.setFile(y({},e,t))}}])}(),T=new N;function j(e){return'style="'.concat(function(e){return Object.entries(e).map(function(e){var t,r=w(e,2),n=r[0],o=r[1];if(n&&o)return"".concat((t=n,t.replace(/\B([A-Z])/g,"-$1").toLowerCase()),": ").concat(o,";")}).filter(Boolean).join(" ")}(e),'"')}var C=function(e){return{"-webkit-box-orient":"vertical","-webkit-line-clamp":e,display:"-webkit-box",hyphens:"auto",lineClamp:e,overflow:"hidden",overflowWrap:"anywhere",textOverflow:"ellipsis",wordBreak:"break-word"}},R=function(e,t){var r,n,o={rel:'rel="noopener noreferrer"',target:'target="'.concat(t.target,'"'),href:'href="'.concat(t.href,'"'),title:'title="'.concat(t.linkTitle,'"')},i=function(e){return e.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#039;/g,"'")},a={a:j({color:"unset !important",display:"block",width:"100%",textDecoration:"none"}),container:j({display:"flex",alignItems:"center",flexWrap:"wrap",gap:"10px",borderRadius:"12px",border:"1px solid var(--vp-c-bg-soft)",backgroundColor:"var(--vp-c-bg-soft)",boxSizing:"border-box",width:"100%",height:"130px",transition:"border-color 0.25s, background-color 0.25s"}),img:j({borderRadius:"0px 12px 12px 0px",maxWidth:"40%",height:"128px",flexShrink:0,objectFit:"contain",overflow:"hidden"}),texts:j({flex:"1 1 0%",minWidth:"0"}),title:j(E(E({},C(2)),{},{opacity:1,fontSize:"16px",lineHeight:"22px",margin:"0 16px 8px 16px",fontWeight:"bold"})),domain:j(E(E({},C(1)),{},{opacity:1,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 8px 16px",textDecoration:"underline"})),description:j(E(E({},C(2)),{},{opacity:.8,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 0px 16px"}))},s=t.href||"",c=new URL(s).origin.replace(/^https?:\/\//,"").replace(/^www\./,"")||"Unknown domain",l=e.title,u=e.description;"github.com"==c?(l=(null===(r=e.title)||void 0===r?void 0:r.split(":")[0].replace("GitHub - ",""))||"No title",u=(null===(n=u)||void 0===n?void 0:n.replace(" - ".concat(l),"").replace("Contribute to ".concat(l," development by creating an account on GitHub."),""))||""):(l=e.title||"No title",u=e.description||"");return'<span style="display:block;">\n  <a '.concat(o.rel," ").concat(o.target," ").concat(o.href," ").concat(o.title," ").concat(a.a,'>\n    <span class="vitepress-linkcard-container" ').concat(a.container,">\n      <span ").concat(a.texts,">\n        <span ").concat(a.title,">\n          ").concat(i(l),"\n        </span>\n        <span ").concat(a.domain,">\n          ").concat(i(c),"\n        </span>\n        <span ").concat(a.description,">\n          ").concat(i(u),'\n        </span>\n      </span>\n      <img src="').concat(null==e?void 0:e.logo,'" ').concat(a.img,"/>\n    </span>\n  </a>\n</span>")};function D(e){return new URL(e)}var A="https://resources.whatwg.org/logo-url.svg",L=/(<[A-Za-z]+\s*[^>]*>(.*)<\/[A-Za-z]+>)/,q=/content=["|']([^>]*)["|']/,P=/href=["|']([^>]*)["|']/,H=/(<title\s*[^>]*>(.*)<\/title>)/g,F=function(e){return new RegExp("<".concat(arguments.length>1&&void 0!==arguments[1]?arguments[1]:"meta","\\s[^>]*\\w+=['|\"]([a-zA-Z]|:|\\s)*").concat(e,"['|\"][^>]*\\/?>"))};function _(e){var t,r=e.match(F("title"));if(null!=r&&r.length){var n=r[0].match(q);n&&x(n[1])&&(t=n[1])}else{var o=e.match(H);if(null!=o&&o.length){var i=o[0].match(L);i&&x(i[2])&&(t=i[2])}}return t}function I(e){var t,r=e.match(F("description"));if(null!=r&&r.length){var n=r[0].match(q);n&&x(n[1])&&(t=n[1])}return t}function U(e){var t,r=e.match(F("image"));if(null!=r&&r.length){var n=r[0].match(q);n&&x(n[1])&&(t=n[1])}else{var o=e.match(F("icon","link"));if(null!=o&&o.length){var i=o[0].match(P);i&&x(i[1])&&(t=i[1])}}return t}function M(e,t){var r,n,o,i={title:_(e),description:I(e),logo:(r=U(e),r?D(r)?r:"".concat(null===(n=D(t))||void 0===n?void 0:n.origin).concat("/".concat(r).replace(/\/\//g,"/")):A)};return o=i,Object.values(o).filter(function(e){return x(e)}).length?i:null}function B(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var J,G={};
+  */(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function m(e){var t=function(e,t){if("object"!=typeof e||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t||"default");if("object"!=typeof n)return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:t+""}(c=s||(s={})).Array="[object Array]",c.Object="[object Object]",c.Function="[object Function]",c.Number="[object Number]",c.String="[object String]",c.Boolean="[object Boolean]",c.Undefined="[object Undefined]",c.Null="[object Null]",c.Error="[object Error]";var x=function(e){return Object.prototype.toString.call(e)===s.String},S=function(e){return Object.prototype.toString.call(e)===s.Function},O="undefined"!=typeof window,k=function(){var e,t="".concat(process.cwd(),"/.linkcard_cache.json"),r="".concat(process.cwd(),"/.config/.linkcard_cache.json");if(h.default.existsSync(t))e=t;else if(h.default.existsSync(r))e=r;else{e=t;h.default.writeFileSync(e,JSON.stringify({"https://example.com/":{description:"Example Website",logo:"https://example.com/example.png",title:"Example Title"}},null,2))}return e},N=function(){return function(e,t,r){return t&&g(e.prototype,t),r&&g(e,r),Object.defineProperty(e,"prototype",{writable:!1}),e}(function e(){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,e)},[{key:"setFile",value:function(e){var t=e,r=this.readFile();r&&(t=Object.assign(r,t)),h.default.writeFileSync(k(),JSON.stringify(t)),function(){var e=k(),t=h.default.readFileSync(e,"utf-8").trim();if(t){var r=JSON.parse(t),n=JSON.stringify(r,null,2)+"\n";h.default.writeFileSync(e,n)}}()}},{key:"readFile",value:function(){var e=h.default.readFileSync(k(),"utf-8"),t=JSON.parse(e);if(function(e){return Object.prototype.toString.call(e)===s.Object}(t))return t}},{key:"has",value:function(e){return!!this.get(e)}},{key:"get",value:function(e){var t=this.readFile();return null==t?void 0:t[e]}},{key:"set",value:function(e,t){this.setFile(y({},e,t))}}])}(),T=new N;function j(e){return'style="'.concat(function(e){return Object.entries(e).map(function(e){var t,r=w(e,2),n=r[0],o=r[1];if(n&&o)return"".concat((t=n,t.replace(/\B([A-Z])/g,"-$1").toLowerCase()),": ").concat(o,";")}).filter(Boolean).join(" ")}(e),'"')}var C=function(e){return{"-webkit-box-orient":"vertical","-webkit-line-clamp":e,display:"-webkit-box",hyphens:"auto",lineClamp:e,overflow:"hidden",overflowWrap:"anywhere",textOverflow:"ellipsis",wordBreak:"break-word"}},R=function(e,t){var r,n,o={rel:'rel="noopener noreferrer"',target:'target="'.concat(t.target,'"'),href:'href="'.concat(t.href,'"'),title:'title="'.concat(t.linkTitle,'"')},i=function(e){return e.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#039;/g,"'")},a={a:j({color:"unset !important",display:"block",width:"100%",textDecoration:"none"}),container:j({display:"flex",alignItems:"center",flexWrap:"wrap",gap:"10px",borderRadius:"12px",border:"1px solid var(--vp-c-bg-soft)",backgroundColor:"var(--vp-c-bg-soft)",boxSizing:"border-box",width:"100%",height:"130px",transition:"border-color 0.25s, background-color 0.25s"}),img:j({borderRadius:"0px 12px 12px 0px",maxWidth:"40%",height:"129px",flexShrink:0,objectFit:"contain",overflow:"hidden"}),texts:j({flex:"1 1 0%",minWidth:"0"}),title:j(E(E({},C(2)),{},{opacity:1,fontSize:"16px",lineHeight:"22px",margin:"0 16px 8px 16px",fontWeight:"bold"})),domain:j(E(E({},C(1)),{},{opacity:1,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 8px 16px",textDecoration:"underline"})),description:j(E(E({},C(2)),{},{opacity:.8,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 0px 16px"}))},s=t.href||"",c=new URL(s).origin.replace(/^https?:\/\//,"").replace(/^www\./,"")||"Unknown domain",l=e.title,u=e.description;"github.com"==c?(l=(null===(r=e.title)||void 0===r?void 0:r.split(":")[0].replace("GitHub - ",""))||"No title",u=(null===(n=u)||void 0===n?void 0:n.replace(" - ".concat(l),"").replace("Contribute to ".concat(l," development by creating an account on GitHub."),""))||""):(l=e.title||"No title",u=e.description||"");return'<span style="display:block;">\n  <a '.concat(o.rel," ").concat(o.target," ").concat(o.href," ").concat(o.title," ").concat(a.a,'>\n    <span class="vitepress-linkcard-container" ').concat(a.container,">\n      <span ").concat(a.texts,">\n        <span ").concat(a.title,">\n          ").concat(i(l),"\n        </span>\n        <span ").concat(a.domain,">\n          ").concat(i(c),"\n        </span>\n        <span ").concat(a.description,">\n          ").concat(i(u),'\n        </span>\n      </span>\n      <img src="').concat(null==e?void 0:e.logo,'" ').concat(a.img,"/>\n    </span>\n  </a>\n</span>")};function D(e){return new URL(e)}var A="https://resources.whatwg.org/logo-url.svg",L=/(<[A-Za-z]+\s*[^>]*>(.*)<\/[A-Za-z]+>)/,q=/content=["|']([^>]*)["|']/,P=/href=["|']([^>]*)["|']/,H=/(<title\s*[^>]*>(.*)<\/title>)/g,F=function(e){return new RegExp("<".concat(arguments.length>1&&void 0!==arguments[1]?arguments[1]:"meta","\\s[^>]*\\w+=['|\"]([a-zA-Z]|:|\\s)*").concat(e,"['|\"][^>]*\\/?>"))};function _(e){var t,r=e.match(F("title"));if(null!=r&&r.length){var n=r[0].match(q);n&&x(n[1])&&(t=n[1])}else{var o=e.match(H);if(null!=o&&o.length){var i=o[0].match(L);i&&x(i[2])&&(t=i[2])}}return t}function I(e){var t,r=e.match(F("description"));if(null!=r&&r.length){var n=r[0].match(q);n&&x(n[1])&&(t=n[1])}return t}function U(e){var t,r=e.match(F("image"));if(null!=r&&r.length){var n=r[0].match(q);n&&x(n[1])&&(t=n[1])}else{var o=e.match(F("icon","link"));if(null!=o&&o.length){var i=o[0].match(P);i&&x(i[1])&&(t=i[1])}}return t}function M(e,t){var r,n,o,i={title:_(e),description:I(e),logo:(r=U(e),r?D(r)?r:"".concat(null===(n=D(t))||void 0===n?void 0:n.origin).concat("/".concat(r).replace(/\/\//g,"/")):A)};return o=i,Object.values(o).filter(function(e){return x(e)}).length?i:null}function B(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var J,G={};
 /**
  * Wrapper for built-in http.js to emulate the browser XMLHttpRequest object.
  *

package/dist/.esm.min.js

@@ -1,5 +1,5 @@
 /*!
-  * vitepress-linkcard v2.0.0
+  * vitepress-linkcard v2.0.1
   * (c) 2022 - 2026 luckrya
   * Released under the MIT License.
   */
@@ -8,7 +8,7 @@ import e from"url";import t from"child_process";import r from"fs";import n from"
   * @luckrya/utility v0.1.0
   * (c) 2022 - 2022 Y.R
   * Released under the MIT License.
-  */(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function p(e){var t=function(e,t){if("object"!=typeof e||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t||"default");if("object"!=typeof n)return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:t+""}var d,h;(h=d||(d={})).Array="[object Array]",h.Object="[object Object]",h.Function="[object Function]",h.Number="[object Number]",h.String="[object String]",h.Boolean="[object Boolean]",h.Undefined="[object Undefined]",h.Null="[object Null]",h.Error="[object Error]";var v=function(e){return Object.prototype.toString.call(e)===d.String},g=function(e){return Object.prototype.toString.call(e)===d.Function},y="undefined"!=typeof window,b=function(){var e,t="".concat(process.cwd(),"/.linkcard_cache.json"),r="".concat(process.cwd(),"/.config/.linkcard_cache.json");if(i.existsSync(t))e=t;else if(i.existsSync(r))e=r;else{e=t;i.writeFileSync(e,JSON.stringify({"https://example.com/":{description:"Example Website",logo:"https://example.com/example.png",title:"Example Title"}},null,2))}return e},m=function(){return function(e,t,r){return t&&s(e.prototype,t),r&&s(e,r),Object.defineProperty(e,"prototype",{writable:!1}),e}(function e(){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,e)},[{key:"setFile",value:function(e){var t=e,r=this.readFile();r&&(t=Object.assign(r,t)),i.writeFileSync(b(),JSON.stringify(t)),function(){var e=b(),t=i.readFileSync(e,"utf-8").trim();if(t){var r=JSON.parse(t),n=JSON.stringify(r,null,2)+"\n";i.writeFileSync(e,n)}}()}},{key:"readFile",value:function(){var e=i.readFileSync(b(),"utf-8"),t=JSON.parse(e);if(function(e){return Object.prototype.toString.call(e)===d.Object}(t))return t}},{key:"has",value:function(e){return!!this.get(e)}},{key:"get",value:function(e){var t=this.readFile();return null==t?void 0:t[e]}},{key:"set",value:function(e,t){this.setFile(c({},e,t))}}])}(),E=new m;function w(e){return'style="'.concat(function(e){return Object.entries(e).map(function(e){var t,r=f(e,2),n=r[0],o=r[1];if(n&&o)return"".concat((t=n,t.replace(/\B([A-Z])/g,"-$1").toLowerCase()),": ").concat(o,";")}).filter(Boolean).join(" ")}(e),'"')}var x=function(e){return{"-webkit-box-orient":"vertical","-webkit-line-clamp":e,display:"-webkit-box",hyphens:"auto",lineClamp:e,overflow:"hidden",overflowWrap:"anywhere",textOverflow:"ellipsis",wordBreak:"break-word"}},S=function(e,t){var r,n,o={rel:'rel="noopener noreferrer"',target:'target="'.concat(t.target,'"'),href:'href="'.concat(t.href,'"'),title:'title="'.concat(t.linkTitle,'"')},i=function(e){return e.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#039;/g,"'")},a={a:w({color:"unset !important",display:"block",width:"100%",textDecoration:"none"}),container:w({display:"flex",alignItems:"center",flexWrap:"wrap",gap:"10px",borderRadius:"12px",border:"1px solid var(--vp-c-bg-soft)",backgroundColor:"var(--vp-c-bg-soft)",boxSizing:"border-box",width:"100%",height:"130px",transition:"border-color 0.25s, background-color 0.25s"}),img:w({borderRadius:"0px 12px 12px 0px",maxWidth:"40%",height:"128px",flexShrink:0,objectFit:"contain",overflow:"hidden"}),texts:w({flex:"1 1 0%",minWidth:"0"}),title:w(u(u({},x(2)),{},{opacity:1,fontSize:"16px",lineHeight:"22px",margin:"0 16px 8px 16px",fontWeight:"bold"})),domain:w(u(u({},x(1)),{},{opacity:1,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 8px 16px",textDecoration:"underline"})),description:w(u(u({},x(2)),{},{opacity:.8,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 0px 16px"}))},s=t.href||"",c=new URL(s).origin.replace(/^https?:\/\//,"").replace(/^www\./,"")||"Unknown domain",l=e.title,f=e.description;"github.com"==c?(l=(null===(r=e.title)||void 0===r?void 0:r.split(":")[0].replace("GitHub - ",""))||"No title",f=(null===(n=f)||void 0===n?void 0:n.replace(" - ".concat(l),"").replace("Contribute to ".concat(l," development by creating an account on GitHub."),""))||""):(l=e.title||"No title",f=e.description||"");return'<span style="display:block;">\n  <a '.concat(o.rel," ").concat(o.target," ").concat(o.href," ").concat(o.title," ").concat(a.a,'>\n    <span class="vitepress-linkcard-container" ').concat(a.container,">\n      <span ").concat(a.texts,">\n        <span ").concat(a.title,">\n          ").concat(i(l),"\n        </span>\n        <span ").concat(a.domain,">\n          ").concat(i(c),"\n        </span>\n        <span ").concat(a.description,">\n          ").concat(i(f),'\n        </span>\n      </span>\n      <img src="').concat(null==e?void 0:e.logo,'" ').concat(a.img,"/>\n    </span>\n  </a>\n</span>")};function O(e){return new URL(e)}var k="https://resources.whatwg.org/logo-url.svg",N=/(<[A-Za-z]+\s*[^>]*>(.*)<\/[A-Za-z]+>)/,T=/content=["|']([^>]*)["|']/,j=/href=["|']([^>]*)["|']/,C=/(<title\s*[^>]*>(.*)<\/title>)/g,R=function(e){return new RegExp("<".concat(arguments.length>1&&void 0!==arguments[1]?arguments[1]:"meta","\\s[^>]*\\w+=['|\"]([a-zA-Z]|:|\\s)*").concat(e,"['|\"][^>]*\\/?>"))};function D(e){var t,r=e.match(R("title"));if(null!=r&&r.length){var n=r[0].match(T);n&&v(n[1])&&(t=n[1])}else{var o=e.match(C);if(null!=o&&o.length){var i=o[0].match(N);i&&v(i[2])&&(t=i[2])}}return t}function A(e){var t,r=e.match(R("description"));if(null!=r&&r.length){var n=r[0].match(T);n&&v(n[1])&&(t=n[1])}return t}function L(e){var t,r=e.match(R("image"));if(null!=r&&r.length){var n=r[0].match(T);n&&v(n[1])&&(t=n[1])}else{var o=e.match(R("icon","link"));if(null!=o&&o.length){var i=o[0].match(j);i&&v(i[1])&&(t=i[1])}}return t}function P(e,t){var r,n,o,i={title:D(e),description:A(e),logo:(r=L(e),r?O(r)?r:"".concat(null===(n=O(t))||void 0===n?void 0:n.origin).concat("/".concat(r).replace(/\/\//g,"/")):k)};return o=i,Object.values(o).filter(function(e){return v(e)}).length?i:null}function q(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var H,F={};
+  */(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function p(e){var t=function(e,t){if("object"!=typeof e||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t||"default");if("object"!=typeof n)return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:t+""}var d,h;(h=d||(d={})).Array="[object Array]",h.Object="[object Object]",h.Function="[object Function]",h.Number="[object Number]",h.String="[object String]",h.Boolean="[object Boolean]",h.Undefined="[object Undefined]",h.Null="[object Null]",h.Error="[object Error]";var v=function(e){return Object.prototype.toString.call(e)===d.String},g=function(e){return Object.prototype.toString.call(e)===d.Function},y="undefined"!=typeof window,b=function(){var e,t="".concat(process.cwd(),"/.linkcard_cache.json"),r="".concat(process.cwd(),"/.config/.linkcard_cache.json");if(i.existsSync(t))e=t;else if(i.existsSync(r))e=r;else{e=t;i.writeFileSync(e,JSON.stringify({"https://example.com/":{description:"Example Website",logo:"https://example.com/example.png",title:"Example Title"}},null,2))}return e},m=function(){return function(e,t,r){return t&&s(e.prototype,t),r&&s(e,r),Object.defineProperty(e,"prototype",{writable:!1}),e}(function e(){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,e)},[{key:"setFile",value:function(e){var t=e,r=this.readFile();r&&(t=Object.assign(r,t)),i.writeFileSync(b(),JSON.stringify(t)),function(){var e=b(),t=i.readFileSync(e,"utf-8").trim();if(t){var r=JSON.parse(t),n=JSON.stringify(r,null,2)+"\n";i.writeFileSync(e,n)}}()}},{key:"readFile",value:function(){var e=i.readFileSync(b(),"utf-8"),t=JSON.parse(e);if(function(e){return Object.prototype.toString.call(e)===d.Object}(t))return t}},{key:"has",value:function(e){return!!this.get(e)}},{key:"get",value:function(e){var t=this.readFile();return null==t?void 0:t[e]}},{key:"set",value:function(e,t){this.setFile(c({},e,t))}}])}(),E=new m;function w(e){return'style="'.concat(function(e){return Object.entries(e).map(function(e){var t,r=f(e,2),n=r[0],o=r[1];if(n&&o)return"".concat((t=n,t.replace(/\B([A-Z])/g,"-$1").toLowerCase()),": ").concat(o,";")}).filter(Boolean).join(" ")}(e),'"')}var x=function(e){return{"-webkit-box-orient":"vertical","-webkit-line-clamp":e,display:"-webkit-box",hyphens:"auto",lineClamp:e,overflow:"hidden",overflowWrap:"anywhere",textOverflow:"ellipsis",wordBreak:"break-word"}},S=function(e,t){var r,n,o={rel:'rel="noopener noreferrer"',target:'target="'.concat(t.target,'"'),href:'href="'.concat(t.href,'"'),title:'title="'.concat(t.linkTitle,'"')},i=function(e){return e.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#039;/g,"'")},a={a:w({color:"unset !important",display:"block",width:"100%",textDecoration:"none"}),container:w({display:"flex",alignItems:"center",flexWrap:"wrap",gap:"10px",borderRadius:"12px",border:"1px solid var(--vp-c-bg-soft)",backgroundColor:"var(--vp-c-bg-soft)",boxSizing:"border-box",width:"100%",height:"130px",transition:"border-color 0.25s, background-color 0.25s"}),img:w({borderRadius:"0px 12px 12px 0px",maxWidth:"40%",height:"129px",flexShrink:0,objectFit:"contain",overflow:"hidden"}),texts:w({flex:"1 1 0%",minWidth:"0"}),title:w(u(u({},x(2)),{},{opacity:1,fontSize:"16px",lineHeight:"22px",margin:"0 16px 8px 16px",fontWeight:"bold"})),domain:w(u(u({},x(1)),{},{opacity:1,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 8px 16px",textDecoration:"underline"})),description:w(u(u({},x(2)),{},{opacity:.8,fontSize:"12px",lineHeight:"16px",margin:"8px 16px 0px 16px"}))},s=t.href||"",c=new URL(s).origin.replace(/^https?:\/\//,"").replace(/^www\./,"")||"Unknown domain",l=e.title,f=e.description;"github.com"==c?(l=(null===(r=e.title)||void 0===r?void 0:r.split(":")[0].replace("GitHub - ",""))||"No title",f=(null===(n=f)||void 0===n?void 0:n.replace(" - ".concat(l),"").replace("Contribute to ".concat(l," development by creating an account on GitHub."),""))||""):(l=e.title||"No title",f=e.description||"");return'<span style="display:block;">\n  <a '.concat(o.rel," ").concat(o.target," ").concat(o.href," ").concat(o.title," ").concat(a.a,'>\n    <span class="vitepress-linkcard-container" ').concat(a.container,">\n      <span ").concat(a.texts,">\n        <span ").concat(a.title,">\n          ").concat(i(l),"\n        </span>\n        <span ").concat(a.domain,">\n          ").concat(i(c),"\n        </span>\n        <span ").concat(a.description,">\n          ").concat(i(f),'\n        </span>\n      </span>\n      <img src="').concat(null==e?void 0:e.logo,'" ').concat(a.img,"/>\n    </span>\n  </a>\n</span>")};function O(e){return new URL(e)}var k="https://resources.whatwg.org/logo-url.svg",N=/(<[A-Za-z]+\s*[^>]*>(.*)<\/[A-Za-z]+>)/,T=/content=["|']([^>]*)["|']/,j=/href=["|']([^>]*)["|']/,C=/(<title\s*[^>]*>(.*)<\/title>)/g,R=function(e){return new RegExp("<".concat(arguments.length>1&&void 0!==arguments[1]?arguments[1]:"meta","\\s[^>]*\\w+=['|\"]([a-zA-Z]|:|\\s)*").concat(e,"['|\"][^>]*\\/?>"))};function D(e){var t,r=e.match(R("title"));if(null!=r&&r.length){var n=r[0].match(T);n&&v(n[1])&&(t=n[1])}else{var o=e.match(C);if(null!=o&&o.length){var i=o[0].match(N);i&&v(i[2])&&(t=i[2])}}return t}function A(e){var t,r=e.match(R("description"));if(null!=r&&r.length){var n=r[0].match(T);n&&v(n[1])&&(t=n[1])}return t}function L(e){var t,r=e.match(R("image"));if(null!=r&&r.length){var n=r[0].match(T);n&&v(n[1])&&(t=n[1])}else{var o=e.match(R("icon","link"));if(null!=o&&o.length){var i=o[0].match(j);i&&v(i[1])&&(t=i[1])}}return t}function P(e,t){var r,n,o,i={title:D(e),description:A(e),logo:(r=L(e),r?O(r)?r:"".concat(null===(n=O(t))||void 0===n?void 0:n.origin).concat("/".concat(r).replace(/\/\//g,"/")):k)};return o=i,Object.values(o).filter(function(e){return v(e)}).length?i:null}function q(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var H,F={};
 /**
  * Wrapper for built-in http.js to emulate the browser XMLHttpRequest object.
  *

package/dist/api.js

@@ -1,37 +1,11 @@
 import { xhr, generateCardDomFragment, parserMetadata } from './assemble';
-/**
- * Internal cache storing generated card responses by URL.
- * This prevents redundant network requests and parsing operations for the same URLs.
- * @internal
- */
 const cache = new Map();
 /**
  * Generates a link card by fetching and parsing metadata from a URL.
  *
- * This function performs the following operations:
- * 1. Fetches the HTML content from the provided URL synchronously
- * 2. Parses metadata (title, description, logo) from the HTML
- * 3. Generates an HTML card fragment with the metadata
- * 4. Caches the result for subsequent calls
- *
- * The function is primarily used by the link-to-card plugin during markdown processing
- * but can also be used standalone for programmatic card generation.
- *
  * @param url - The URL to fetch metadata from
- * @param options - Rendering options for the card (excluding href, which is set to the url parameter)
+ * @param options - Rendering options for the card
  * @returns A promise that resolves to a CardResponse containing the card data and HTML
- *
- * @example
- * ```typescript
- * const card = await generateCard('https://example.com', {
- *   linkTitle: 'Example Site',
- *   target: '_blank'
- * })
- * console.log(card.dom) // HTML string of the card
- * ```
- *
- * @see {@link parserMetadata} for details on metadata extraction
- * @see {@link generateCardDomFragment} for details on card HTML generation
  */
 export function generateCard(url, options) {
     return new Promise((resolve) => {

package/dist/assemble/html.js

@@ -2,55 +2,9 @@ import { STYLE } from './style';
 /**
  * Generates the HTML DOM fragment for a link card display.
  *
- * This is the default card renderer that creates a rich preview card with:
- * - Card title (with 2-line ellipsis)
- * - Domain name (with underline)
- * - Description (with 2-line ellipsis)
- * - Logo/icon image
- * - Smooth border transition for hover effects
- *
- * The function includes special handling for GitHub URLs to improve the display
- * of repository cards by cleaning up redundant text patterns.
- *
- * @param data - The metadata extracted from the URL (title, description, logo)
- * @param options - Rendering options including href, target, colors, etc.
- * @returns An HTML string containing the complete card markup with inline styles
- *
- * @example
- * ```typescript
- * const html = generateCardDomFragment(
- *   { title: 'Example', description: 'A site', logo: 'https://...' },
- *   { href: 'https://example.com', linkTitle: 'Link', target: '_blank' }
- * )
- * ```
- *
- * @remarks
- * - HTML entities in title/description are automatically escaped
- * - For GitHub URLs, the title is cleaned to remove "GitHub - " prefix and redundant text
- * - The card uses flexbox layout for responsive design
- * - All styles are inlined for maximum compatibility
- * - Container has class `vitepress-linkcard-container` for custom styling
- * - Uses CSS custom properties for theming:
- *   - `--vitepress-linkcard-border-color`: Customize border color
- *   - `--vitepress-linkcard-bg-color`: Customize background color
- * - Styling options in your VitePress theme's custom CSS:
- *   ```css
- *   .vitepress-linkcard-container {
- *     --vitepress-linkcard-border-color: #e0e0e0;
- *     --vitepress-linkcard-bg-color: #f9f9f9;
- *   }
- *
- *   .vitepress-linkcard-container {
- *     border-color: var(--vp-c-brand-2) !important;
- *     background-color: var(--vp-c-brand-soft) !important;
- *   }
- *
- *   .vitepress-linkcard-container:hover {
- *     border-color: var(--vp-c-brand-1) !important;
- *   }
- *   ```
- *
- * @see {@link STYLE} for the styling implementation
+ * @param data - The metadata extracted from the URL
+ * @param options - Rendering options including href, target, etc.
+ * @returns An HTML string containing the card markup
  */
 export const generateCardDomFragment = (data, options) => {
     const aa = {
@@ -62,13 +16,6 @@ export const generateCardDomFragment = (data, options) => {
     const inject = (s) => {
         return s;
     };
-    /**
-     * Escapes HTML entities in a string to prevent XSS and display issues.
-     *
-     * @param str - The string to escape
-     * @returns The escaped string safe for HTML insertion
-     * @internal
-     */
     const escapeHTML = (str) => str
         .replace(/&/g, '&')
         .replace(/&lt;/g, '<')
@@ -81,12 +28,12 @@ export const generateCardDomFragment = (data, options) => {
         'Unknown domain';
     let title = data.title;
     let description = data.description;
-    // Special handling for gitub.com
     if (domain == 'github.com') {
         title = data.title?.split(':')[0].replace('GitHub - ', '') || 'No title';
         description =
-            description?.replace(` - ${title}`, '').replace(`Contribute to ${title} development by creating an account on GitHub.`, // 定型句
-            '') || '';
+            description
+                ?.replace(` - ${title}`, '')
+                .replace(`Contribute to ${title} development by creating an account on GitHub.`, '') || '';
     }
     else {
         title = data.title || 'No title';

package/dist/assemble/local-file-cache.js

@@ -1,27 +1,5 @@
-/**
- * Local file-based cache implementation for persisting URL metadata.
- *
- * This module provides a simple key-value cache that persists data to a JSON file
- * on disk. It's used to cache fetched URL metadata to avoid redundant network requests
- * across different build sessions.
- *
- * @module local-file-cache
- */
 import { isPureObject } from '@luckrya/utility';
 import fs from 'node:fs';
-/**
- * Determines the path to the cache file.
- *
- * Checks for cache file existence in two locations:
- * 1. `.linkcard_cache.json` in the project root (preferred)
- * 2. `.config/.linkcard_cache.json` as fallback
- *
- * If neither exists, creates a new cache file with example data.
- *
- * @returns The absolute path to the cache file
- *
- * @internal
- */
 const CONFIG_FILE = () => {
     let filePath;
     const defaultPath = `${process.cwd()}/.linkcard_cache.json`;
@@ -45,14 +23,6 @@ const CONFIG_FILE = () => {
     }
     return filePath;
 };
-/**
- * Formats the cache file with consistent indentation.
- *
- * Reads the cache file, parses it, and rewrites it with proper JSON formatting
- * (2-space indentation) and a trailing newline.
- *
- * @internal
- */
 const format = () => {
     const filePath = CONFIG_FILE();
     const content = fs.readFileSync(filePath, 'utf-8').trim();
@@ -64,53 +34,9 @@ const format = () => {
 };
 /**
  * A simple file-based cache for storing and retrieving structured data.
- *
- * This class provides a Map-like interface for caching data that persists to disk
- * in JSON format. Each cache entry is keyed by URL and stores structured metadata.
- *
- * The cache file is automatically created if it doesn't exist, and all writes are
- * synchronized and formatted for readability.
- *
- * @template V - The value type, must extend Record<string, unknown>
- *
- * @example
- * ```typescript
- * const cache = new LocalFileCache<UrlMetadata>()
- *
- * // Store metadata
- * cache.set('https://example.com', {
- *   title: 'Example',
- *   description: 'A site',
- *   logo: 'https://example.com/logo.png'
- * })
- *
- * // Retrieve metadata
- * const metadata = cache.get('https://example.com')
- *
- * // Check if URL is cached
- * if (cache.has('https://example.com')) {
- *   console.log('URL is cached')
- * }
- * ```
- *
- * @remarks
- * - Cache is stored in `.linkcard_cache.json` at project root
- * - All operations are synchronous
- * - Cache persists across process restarts
- * - Merges new data with existing cache entries
  */
 export default class LocalFileCache {
     constructor() { }
-    /**
-     * Writes data to the cache file.
-     *
-     * Merges the provided data with existing cache content and writes the result
-     * to disk. The file is automatically formatted after writing.
-     *
-     * @param data - Object mapping URLs to cached data
-     *
-     * @private
-     */
     setFile(data) {
         let content = data;
         const _content = this.readFile();
@@ -120,13 +46,6 @@ export default class LocalFileCache {
         fs.writeFileSync(CONFIG_FILE(), JSON.stringify(content));
         format();
     }
-    /**
-     * Reads and parses the cache file.
-     *
-     * @returns The parsed cache data, or undefined if the file is empty or invalid
-     *
-     * @private
-     */
     readFile() {
         const content = fs.readFileSync(CONFIG_FILE(), 'utf-8');
         const data = JSON.parse(content);
@@ -134,58 +53,13 @@ export default class LocalFileCache {
             return data;
         return undefined;
     }
-    /**
-     * Checks if a URL exists in the cache.
-     *
-     * @param url - The URL to check
-     * @returns true if the URL has cached data, false otherwise
-     *
-     * @example
-     * ```typescript
-     * if (cache.has('https://example.com')) {
-     *   console.log('Cache hit!')
-     * }
-     * ```
-     */
     has(url) {
         return !!this.get(url);
     }
-    /**
-     * Retrieves cached data for a URL.
-     *
-     * @param url - The URL to retrieve data for
-     * @returns The cached data for the URL, or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * const metadata = cache.get('https://example.com')
-     * if (metadata) {
-     *   console.log(metadata.title)
-     * }
-     * ```
-     */
     get(url) {
         const cache = this.readFile();
         return cache?.[url];
     }
-    /**
-     * Stores data in the cache for a URL.
-     *
-     * Adds or updates the cache entry for the specified URL. The data is merged
-     * with existing cache content and persisted to disk.
-     *
-     * @param url - The URL to cache data for
-     * @param data - The data to cache
-     *
-     * @example
-     * ```typescript
-     * cache.set('https://example.com', {
-     *   title: 'Example Domain',
-     *   description: 'Example description',
-     *   logo: 'https://example.com/logo.png'
-     * })
-     * ```
-     */
     set(url, data) {
         this.setFile({ [url]: data });
     }

package/dist/assemble/metadata.js

@@ -1,37 +1,11 @@
 import { parserMetadata, xhr } from '.';
 import LocalFileCache from './local-file-cache';
-/**
- * Local file cache instance for storing fetched URL metadata.
- * This cache persists metadata to disk to avoid repeated network requests.
- * @internal
- */
 const cache = new LocalFileCache();
 /**
  * Retrieves metadata for a given URL, using cache when available.
  *
- * This function first checks if the metadata is already cached. If not, it fetches
- * the HTML content from the URL, parses the metadata, and caches the result for
- * future use.
- *
- * The metadata includes:
- * - Title (from `<title>` or OGP tags)
- * - Description (from meta description or OGP tags)
- * - Logo/icon (from OGP image or favicon)
- *
  * @param url - The URL to fetch metadata from
- * @returns The parsed URL metadata, or null if the URL cannot be fetched or parsed
- *
- * @example
- * ```typescript
- * const metadata = getUrlMetadata('https://example.com')
- * if (metadata) {
- *   console.log(metadata.title) // "Example Domain"
- *   console.log(metadata.description) // "Example website description"
- * }
- * ```
- *
- * @see {@link parserMetadata} for details on metadata extraction
- * @see {@link LocalFileCache} for caching implementation
+ * @returns The parsed URL metadata, or null if unavailable
  */
 export function getUrlMetadata(url) {
     if (cache.has(url))