some fixes as description

lib/front_matter.ts

@@ -32,20 +32,30 @@ function split(str: string) {
   return { content: str };
 }
 
-function parse(str: string, options?: yaml.LoadOptions) {
+export type ParseResult = Record<string, any> & Partial<{
+  _content: string;
+  title: string;
+  description: string;
+  thumbnail: string;
+  date: any;
+  updated: any;
+  permalink: string;
+}>
+
+function parse(str: string, options: yaml.LoadOptions = {}) {
   if (typeof str !== 'string') throw new TypeError('str is required!');
 
   const splitData = split(str);
   const raw = splitData.data;
 
   if (!raw) return { _content: str };
 
-  let data;
+  let data: ParseResult;
 
   if (splitData.separator.startsWith(';')) {
     data = parseJSON(raw);
   } else {
-    data = parseYAML(raw, options);
+    data = <any>parseYAML(raw, options);
   }
 
   if (!data) return { _content: str };
@@ -55,26 +65,28 @@ function parse(str: string, options?: yaml.LoadOptions) {
     const item = data[key];
 
     if (item instanceof Date) {
-      data[key] = new Date(item.getTime() + (item.getTimezoneOffset() * 60 * 1000));
+      data[key] = new Date(
+        item.getTime() + (item.getTimezoneOffset() * 60 * 1000)
+      );
     }
   });
 
   data._content = splitData.content;
   return data;
 }
 
-function parseYAML(str, options: yaml.LoadOptions) {
+function parseYAML(str: string, options: yaml.LoadOptions) {
   const result = yaml.load(escapeYAML(str), options);
   if (typeof result !== 'object') return;
 
   return result;
 }
 
-function parseJSON(str) {
+function parseJSON(str: string) {
   try {
     return JSON.parse(`{${str}}`);
   } catch (err) {
-    return; // eslint-disable-line
+		return; // eslint-disable-line
   }
 }
 
@@ -93,12 +105,12 @@ function escapeYAML(str: string) {
 }
 
 interface Options {
-  mode?: 'json' | '',
-  prefixSeparator?: boolean,
-  separator?: string
+	mode?: 'json' | '';
+	prefixSeparator?: boolean;
+	separator?: string;
 }
 
-function stringify(obj, options: Options = {}) {
+function stringify(obj: Record<string, any>, options: Options = {}) {
   if (!obj) throw new TypeError('obj is required!');
 
   const { _content: content = '' } = obj;
@@ -123,12 +135,14 @@ function stringify(obj, options: Options = {}) {
   return result;
 }
 
-function stringifyYAML(obj, options) {
+type YamlMergedOpts = Options & yaml.DumpOptions;
+
+function stringifyYAML(obj: Record<string, any>, options: YamlMergedOpts) {
   const keys = Object.keys(obj);
   const data = {};
   const nullKeys = [];
   const dateKeys = [];
-  let key, value, i, len;
+  let key: string, value: any, i: number, len: number;
 
   for (i = 0, len = keys.length; i < len; i++) {
     key = keys[i];
@@ -162,24 +176,25 @@ function stringifyYAML(obj, options) {
 }
 
 function stringifyJSON(obj) {
-  return JSON.stringify(obj, null, '  ')
+  return (
+    JSON.stringify(obj, null, '  ')
     // Remove indention
-    .replace(/\n {2}/g, () => '\n')
+      .replace(/\n {2}/g, () => '\n')
     // Remove prefixing and trailing braces
-    .replace(/^{\n|}$/g, '');
+      .replace(/^{\n|}$/g, '')
+  );
 }
 
-function doubleDigit(num) {
+function doubleDigit(num: number) {
   return num.toString().padStart(2, '0');
 }
 
-function formatDate(date) {
-  return `${date.getFullYear()}-${doubleDigit(date.getMonth() + 1)}-${doubleDigit(date.getDate())} ${doubleDigit(date.getHours())}:${doubleDigit(date.getMinutes())}:${doubleDigit(date.getSeconds())}`;
+function formatDate(date: Date) {
+  return `${date.getFullYear()}-${doubleDigit(
+    date.getMonth() + 1
+  )}-${doubleDigit(date.getDate())} ${doubleDigit(
+    date.getHours()
+  )}:${doubleDigit(date.getMinutes())}:${doubleDigit(date.getSeconds())}`;
 }
 
-export {
-  parse,
-  split,
-  escapeYAML as escape,
-  stringify
-};
+export { parse, split, escapeYAML as escape, stringify };

package.json

@@ -2,7 +2,8 @@
   "name": "hexo-front-matter",
   "version": "4.1.0",
   "description": "Front-matter parser.",
-  "main": "dist/front_matter",
+  "main": "dist/front_matter.js",
+  "types": "./dist/front_matter.d.ts",
   "scripts": {
     "prepublish ": "npm run clean && npm run build",
     "build": "tsc -b",
@@ -13,9 +14,8 @@
     "test-cov": "c8 --reporter=lcovonly npm run test"
   },
   "files": [
-    "dist/**"
+    "dist"
   ],
-  "types": "./dist/front_matter.d.ts",
   "repository": "hexojs/hexo-front-matter",
   "keywords": [
     "front-matter",
@@ -32,7 +32,7 @@
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.5",
-    "@types/node": "^18.11.7",
+    "@types/node": "^18.16.3",
     "@typescript-eslint/eslint-plugin": "^5.41.0",
     "@typescript-eslint/parser": "^5.41.0",
     "c8": "^7.12.0",

tsconfig.json

@@ -6,9 +6,8 @@
     "outDir": "dist",
     "declaration": true,
     "esModuleInterop": true,
-    "types": [
-      "node"
-    ]
+    "skipDefaultLibCheck": true,
+    "skipLibCheck": true
   },
   "include": [
     "lib/front_matter.ts"