init

vendor/oh-my-cv/packages/front-matter/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ohmycv/front-matter",
+  "version": "0.1.1",
+  "description": "A better `js-yaml`, for extracting and parsing YAML front matter from strings.",
+  "keywords": [
+    "yaml",
+    "front matter",
+    "meta data"
+  ],
+  "homepage": "https://github.com/Renovamen/oh-my-cv/tree/main/packages/front-matter",
+  "bugs": {
+    "url": "https://github.com/Renovamen/oh-my-cv"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Renovamen/oh-my-cv.git",
+    "directory": "packages/front-matter"
+  },
+  "license": "MIT",
+  "author": "Renovamen <renovamenzxh@gmail.com>",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "require": "./dist/index.js",
+    "import": "./dist/index.mjs"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build-fast:pkg": "tsup src/index.ts --format cjs,esm",
+    "build:pkg": "pnpm run build-fast:pkg --dts"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.14.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

vendor/oh-my-cv/packages/front-matter/src/front-matter.ts

@@ -0,0 +1,146 @@
+// Adapted from and improved upon https://github.com/jxson/front-matter
+
+import * as yamlParser from "js-yaml";
+
+const OPTIONAL_BYTE_ORDER_MARK = "\\ufeff?";
+const PLATFORM = typeof process !== "undefined" ? process.platform : "";
+const PATTERN =
+  "^(" +
+  OPTIONAL_BYTE_ORDER_MARK +
+  "(= yaml =|---)" +
+  "$([\\s\\S]*?)" +
+  "^(?:\\2|\\.\\.\\.)\\s*" +
+  "$" +
+  (PLATFORM === "win32" ? "\\r?" : "") +
+  "(?:\\n)?)";
+
+export interface FrontMatterResults<T> {
+  /**
+   * Body content (without front matter).
+   */
+  readonly body: string;
+
+  /**
+   * Line number where the body begins.
+   */
+  readonly bodyBegin: number;
+
+  /**
+   * Parsed front matter object.
+   */
+  readonly frontMatter: T;
+
+  /**
+   * Front matter string.
+   */
+  readonly frontMatterString?: string;
+}
+
+export interface FrontMatterOptions {
+  /**
+   * Behavior when an error occurs while parsing the front matter YAML.
+   * - "last": Returns the last successfully parsed front matter.
+   * - "empty": Returns an empty front matter object.
+   * - "error": Throws an error.
+   * @default "error"
+   */
+  errorBehavior?: "last" | "empty" | "error";
+}
+
+export class FrontMatterParser<T = { [key: string]: any }> {
+  private options: FrontMatterOptions;
+  private _lastFrontMatter: T = {} as T;
+
+  constructor(options: FrontMatterOptions = {}) {
+    this.options = options;
+    this.options.errorBehavior = options.errorBehavior || "error";
+  }
+
+  private _emptyResults = (body: string) => ({
+    frontMatter: {} as T,
+    body,
+    bodyBegin: 1
+  });
+
+  /**
+   * Get the line number where the body begins.
+   */
+  private _bodyBegin(match: RegExpExecArray, content: string) {
+    const offset = match.index + match[0].length;
+    const lines = content.slice(0, offset).split("\n");
+    return lines.length;
+  }
+
+  /**
+   * Split the content into front matter and body.
+   *
+   * @param content Markdown content, including front matter and body.
+   * @returns
+   * - `false` if the content does not contain front matter
+   * - `{ frontMatterString, body, bodyBegin }` if contains
+   * @see {@link FrontMatterResults}
+   */
+  public split(content: string) {
+    const regex = new RegExp(PATTERN, "m");
+    const match = regex.exec(content);
+
+    if (!match) return false;
+
+    const frontMatterString = match[match.length - 1].trim();
+    const body = content.slice(match[0].length);
+    const bodyBegin = this._bodyBegin(match, content);
+
+    return {
+      frontMatterString,
+      body,
+      bodyBegin
+    };
+  }
+
+  private _parse(content: string): FrontMatterResults<T> {
+    const split = this.split(content);
+
+    if (!split) return this._emptyResults(content);
+
+    try {
+      const frontMatter = (yamlParser.load(split.frontMatterString) || {}) as T;
+      this._lastFrontMatter = frontMatter;
+
+      return { ...split, frontMatter };
+    } catch (e) {
+      const frontMatter =
+        this.options.errorBehavior === "error"
+          ? (() => {
+              throw e;
+            })()
+          : this.options.errorBehavior === "last"
+            ? this._lastFrontMatter
+            : ({} as T);
+
+      return { ...split, frontMatter };
+    }
+  }
+
+  /**
+   * Extract and parse front matter from a markdown document. A front matter should look like:
+   *
+   * ```
+   * ---
+   * key: value
+   * ---
+   * ```
+   *
+   * @param content Markdown content, including front matter and body.
+   * @returns `{ body, bodyBegin, frontMatter, frontMatterString }`
+   * @see {@link FrontMatterResults}
+   */
+  public parse(content: string): FrontMatterResults<T> {
+    const lines = content.split(/(\r?\n)/);
+
+    if (lines[0] && /= yaml =|---/.test(lines[0])) {
+      return this._parse(content);
+    } else {
+      return this._emptyResults(content);
+    }
+  }
+}

vendor/oh-my-cv/packages/front-matter/src/index.ts

@@ -0,0 +1,4 @@
+import { FrontMatterParser } from "./front-matter";
+
+export default FrontMatterParser;
+export * from "./front-matter";

vendor/oh-my-cv/packages/front-matter/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["./src"]
+}