@vuepress/shared 2.0.0-rc.3 → 2.0.0-rc.31

package/README.md

@@ -5,7 +5,7 @@
 
 ## Documentation
 
-https://v2.vuepress.vuejs.org
+https://vuepress.vuejs.org
 
 ## License
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { MarkdownItHeader } from '@mdit-vue/types';
-
+import { MarkdownItHeader } from "@mdit-vue/types";
+//#region src/types/head.d.ts
 /**
  * Config for `<head>` tags
  */
@@ -9,11 +9,11 @@ type HeadConfig = [HeadTagEmpty, HeadAttrsConfig] | [HeadTagNonEmpty, HeadAttrsC
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/head
  */
-type HeadTag = HeadTagNonEmpty | HeadTagEmpty;
+type HeadTag = HeadTagEmpty | HeadTagNonEmpty;
 /**
  * Non-empty tags in `<head>`
  */
-type HeadTagNonEmpty = 'title' | 'style' | 'script' | 'noscript' | 'template';
+type HeadTagNonEmpty = 'noscript' | 'script' | 'style' | 'template' | 'title';
 /**
  * Empty tags in `<head>`
  */
@@ -21,8 +21,9 @@ type HeadTagEmpty = 'base' | 'link' | 'meta' | 'script';
 /**
  * Attributes to be set for tags in `<head>`
  */
-type HeadAttrsConfig = Record<string, string | boolean>;
-
+type HeadAttrsConfig = Record<string, boolean | string>;
+//#endregion
+//#region src/types/locale.d.ts
 /**
  * Locales config, a key-value object
  *
@@ -36,97 +37,95 @@ type LocaleConfig<T extends LocaleData = LocaleData> = Record<string, Partial<T>
  * Locales data
  */
 type LocaleData = Record<never, never>;
-
+//#endregion
+//#region src/types/page.d.ts
 /**
  * Base type of vuepress page
  */
-interface PageBase<ExtraPageFrontmatter extends Record<any, any> = Record<string, unknown>> {
-    /**
-     * Route path of the page
-     *
-     * Firstly inferred from the file path
-     *
-     * Might be overridden by permalink
-     *
-     * @example '/guide/index.html'
-     * @example '/2020/02/02/hello-world.html'
-     */
-    path: string;
-    /**
-     * Title of the page
-     */
-    title: string;
-    /**
-     * Language of the page
-     */
-    lang: string;
-    /**
-     * Front matter of the page
-     */
-    frontmatter: PageFrontmatter<ExtraPageFrontmatter>;
-    /**
-     * Headers of the page
-     */
-    headers: PageHeader[];
+interface PageBase<ExtraPageFrontmatter extends Record<string, unknown> = Record<string, unknown>> {
+  /**
+   * Route path of the page
+   *
+   * Firstly inferred from the file path
+   *
+   * Might be overridden by permalink
+   *
+   * @example '/guide/index.html'
+   * @example '/2020/02/02/hello-world.html'
+   */
+  path: string;
+  /**
+   * Title of the page
+   */
+  title: string;
+  /**
+   * Language of the page
+   */
+  lang: string;
+  /**
+   * Front matter of the page
+   */
+  frontmatter: PageFrontmatter<ExtraPageFrontmatter>;
 }
 /**
  * Vuepress page data
  */
-type PageData<ExtraPageData extends Record<any, any> = Record<never, never>, ExtraPageFrontmatter extends Record<any, any> = Record<string, unknown>> = PageBase<ExtraPageFrontmatter> & ExtraPageData;
+type PageData<ExtraPageData extends Record<string, unknown> = Record<string, unknown>, ExtraPageFrontmatter extends Record<string, unknown> = Record<string, unknown>> = ExtraPageData & PageBase<ExtraPageFrontmatter>;
 /**
  * Vuepress page frontmatter
  *
  * Notice that frontmatter is parsed from yaml or other languages,
  * so we cannot guarantee the type safety
  */
-type PageFrontmatter<T extends Record<any, any> = Record<string, unknown>> = Partial<T> & {
-    date?: string | Date;
-    description?: string;
-    head?: HeadConfig[];
-    lang?: string;
-    layout?: string;
-    permalink?: string;
-    permalinkPattern?: string | null;
-    routeMeta?: Record<string, unknown>;
-    title?: string;
+type PageFrontmatter<T extends Record<string, unknown> = Record<string, unknown>> = Partial<T> & {
+  date?: Date | string;
+  description?: string;
+  head?: HeadConfig[];
+  lang?: string;
+  layout?: string;
+  permalink?: string | null;
+  permalinkPattern?: string | null;
+  routeMeta?: Record<string, unknown>;
+  title?: string;
 };
 /**
  * Vuepress page header
  */
 type PageHeader = MarkdownItHeader;
-
+//#endregion
+//#region src/types/site.d.ts
 /**
  * Vuepress site data
  */
 interface SiteData extends SiteLocaleData {
-    /**
-     * The base URL the site will be deployed at
-     *
-     * It should always start and end with a slash
-     *
-     * @default '/'
-     */
-    base: '/' | `/${string}/`;
-    /**
-     * Specify locales for i18n support
-     *
-     * It will override the root-level site data in different subpath
-     *
-     * @example
-     * {
-     *   '/en/': {
-     *     lang: 'en-US',
-     *     title: 'Hello',
-     *     description: 'This will take effect under /en/ subpath',
-     *   },
-     *   '/zh/': {
-     *     lang: 'zh-CN',
-     *     title: '你好',
-     *     description: '它将会在 /zh/ 子路径下生效',
-     *   }
-     * }
-     */
-    locales: SiteLocaleConfig;
+  /**
+   * The base URL the site will be deployed at
+   *
+   * It should always start and end with a slash
+   *
+   * @default '/'
+   */
+  base: '/' | `/${string}/`;
+  /**
+   * Specify locales for i18n support
+   *
+   * It will override the root-level site data in different subpath
+   *
+   * @example
+   * {
+   *   '/en/': {
+   *     lang: 'en-US',
+   *     title: 'Hello',
+   *     description: 'This will take effect under /en/ subpath',
+   *   },
+   *   '/zh/': {
+   *     lang: 'zh-CN',
+   *     title: '你好',
+   *     description: '它将会在 /zh/ 子路径下生效',
+   *   }
+   * }
+   */
+  locales: SiteLocaleConfig;
 }
 /**
  * Locales data of vuepress site
@@ -138,76 +137,57 @@ interface SiteData extends SiteLocaleData {
  * used for specific locale
  */
 interface SiteLocaleData {
-    /**
-     * Language for the site
-     *
-     * @default 'en-US'
-     */
-    lang: string;
-    /**
-     * Title for the site
-     *
-     * @default ''
-     */
-    title: string;
-    /**
-     * Description for the site
-     *
-     * @default ''
-     */
-    description: string;
-    /**
-     * Head config
-     *
-     * Descibe the tags to be appended into the `<head>` tag
-     *
-     * @default []
-     *
-     * @example ['link', { rel: 'icon', href: '/logo.png' }]
-     * @example ['style', { type: 'text/css' }, 'p { color: red; }']
-     */
-    head: HeadConfig[];
+  /**
+   * Language for the site
+   *
+   * @default 'en-US'
+   */
+  lang: string;
+  /**
+   * Title for the site
+   *
+   * @default ''
+   */
+  title: string;
+  /**
+   * Description for the site
+   *
+   * @default ''
+   */
+  description: string;
+  /**
+   * Head config
+   *
+   * Describe the tags to be appended into the `<head>` tag
+   *
+   * @default []
+   *
+   * @example ['link', { rel: 'icon', href: '/logo.png' }]
+   * @example ['style', { type: 'text/css' }, 'p { color: red; }']
+   */
+  head: HeadConfig[];
 }
 /**
  * Site locale config
  */
 type SiteLocaleConfig = LocaleConfig<SiteLocaleData>;
-
+//#endregion
+//#region src/types/ssr.d.ts
 /**
  * Context for SSR
  */
 interface VuepressSSRContext {
-    lang: string;
-    head: HeadConfig[];
+  lang: string;
+  head: HeadConfig[];
 }
-
-/**
- * Dedupe head config with identifier
- *
- * Items that appear earlier have higher priority
- */
-declare const dedupeHead: (head: HeadConfig[]) => HeadConfig[];
-
-/**
- * Ensure a url string to have leading slash /
- */
-declare const ensureLeadingSlash: (str: string) => string;
-
-/**
- * Ensure a url string to have ending slash /
- */
-declare const ensureEndingSlash: (str: string) => string;
-
-/**
- * Format a date string to `yyyy-MM-dd`
- */
-declare const formatDateString: (str: string, defaultDateString?: string) => string;
-
+//#endregion
+//#region src/utils/links/isLinkExternal.d.ts
 /**
  * Determine a link is external or not
  */
 declare const isLinkExternal: (link: string, base?: string) => boolean;
-
+//#endregion
+//#region src/utils/links/isLinkHttp.d.ts
 /**
  * Determine a link is http link or not
  *
@@ -216,56 +196,108 @@ declare const isLinkExternal: (link: string, base?: string) => boolean;
  * - //github.com
  */
 declare const isLinkHttp: (link: string) => boolean;
-
+//#endregion
+//#region src/utils/links/isLinkWithProtocol.d.ts
 /**
  * Determine a link has protocol or not
  */
 declare const isLinkWithProtocol: (link: string) => boolean;
-
+//#endregion
+//#region src/utils/routes/inferRoutePath.d.ts
 /**
- * Check if a value is plain object, with generic type support
+ * Infer route path of the given raw path
  */
-declare const isPlainObject: <T extends Record<any, any> = Record<any, any>>(val: unknown) => val is T;
-
+declare const inferRoutePath: (rawPath: string) => string;
+//#endregion
+//#region src/utils/routes/normalizeRoutePath.d.ts
+/**
+ * Normalize the given pathname path to the final route path
+ */
+declare const normalizeRoutePath: (pathname: string, current?: string) => string;
+//#endregion
+//#region src/utils/routes/resolveLocalePath.d.ts
 /**
- * Normalize the given path to the final route path
+ * Resolve the matched locale path of route path
  */
-declare const normalizeRoutePath: (path: string) => string;
-
+declare const resolveLocalePath: (locales: LocaleConfig, routePath: string) => string;
+//#endregion
+//#region src/utils/routes/resolveRoutePathFromUrl.d.ts
+/**
+ * For a give URL, remove the origin and the site base to get the route path
+ */
+declare const resolveRoutePathFromUrl: (url: string, base?: string) => string;
+//#endregion
+//#region src/utils/routes/splitPath.d.ts
+/**
+ * Split a path into pathname and hashAndQueries
+ */
+declare const splitPath: (path: string) => {
+  pathname: string;
+  hashAndQueries: string;
+};
+//#endregion
+//#region src/utils/dedupeHead.d.ts
+/**
+ * Dedupe head config with identifier
+ *
+ * Items that appear earlier have higher priority
+ */
+declare const dedupeHead: (head: HeadConfig[]) => HeadConfig[];
+//#endregion
+//#region src/utils/ensureLeadingSlash.d.ts
+/**
+ * Ensure a url string to have leading slash /
+ */
+declare const ensureLeadingSlash: (str: string) => string;
+//#endregion
+//#region src/utils/ensureEndingSlash.d.ts
+/**
+ * Ensure a url string to have ending slash /
+ */
+declare const ensureEndingSlash: (str: string) => string;
+//#endregion
+//#region src/utils/formatDateString.d.ts
+/**
+ * Format a date string to `yyyy-MM-dd`
+ */
+declare const formatDateString: (str: string, defaultDateString?: string) => string;
+//#endregion
+//#region src/utils/omit.d.ts
 /**
  * Omit properties from an object
  */
 declare const omit: <T extends Record<string, unknown>, U extends string[]>(obj: T, ...keys: U) => Omit<T, U[number]>;
-
+//#endregion
+//#region src/utils/removeEndingSlash.d.ts
 /**
  * Remove ending slash / from a string
  */
 declare const removeEndingSlash: (str: string) => string;
-
+//#endregion
+//#region src/utils/removeLeadingSlash.d.ts
 /**
  * Remove leading slash / from a string
  */
 declare const removeLeadingSlash: (str: string) => string;
-
+//#endregion
+//#region src/utils/resolveHeadIdentifier.d.ts
 /**
  * Resolve identifier of a tag, to avoid duplicated tags in `<head>`
  */
 declare const resolveHeadIdentifier: ([tag, attrs, content]: HeadConfig) => string | null;
-
-/**
- * Resolve the matched locale path of route path
- */
-declare const resolveLocalePath: (locales: LocaleConfig, routePath: string) => string;
-
-declare const resolveRoutePathFromUrl: (url: string, base?: string) => string;
-
+//#endregion
+//#region src/utils/typeGuards.d.ts
 /**
  * Check if a value is a function
  */
 declare const isFunction: (val: unknown) => val is Function;
+/**
+ * Check if a value is plain object, with generic type support
+ */
+declare const isPlainObject: <T extends Record<any, any> = Record<any, any>>(val: unknown) => val is T;
 /**
  * Check if a value is a string
  */
 declare const isString: (val: unknown) => val is string;
-
-export { type HeadAttrsConfig, type HeadConfig, type HeadTag, type HeadTagEmpty, type HeadTagNonEmpty, type LocaleConfig, type LocaleData, type PageBase, type PageData, type PageFrontmatter, type PageHeader, type SiteData, type SiteLocaleConfig, type SiteLocaleData, type VuepressSSRContext, dedupeHead, ensureEndingSlash, ensureLeadingSlash, formatDateString, isFunction, isLinkExternal, isLinkHttp, isLinkWithProtocol, isPlainObject, isString, normalizeRoutePath, omit, removeEndingSlash, removeLeadingSlash, resolveHeadIdentifier, resolveLocalePath, resolveRoutePathFromUrl };
+//#endregion
+export { type HeadAttrsConfig, type HeadConfig, type HeadTag, type HeadTagEmpty, type HeadTagNonEmpty, type LocaleConfig, type LocaleData, type PageBase, type PageData, type PageFrontmatter, type PageHeader, type SiteData, type SiteLocaleConfig, type SiteLocaleData, type VuepressSSRContext, dedupeHead, ensureEndingSlash, ensureLeadingSlash, formatDateString, inferRoutePath, isFunction, isLinkExternal, isLinkHttp, isLinkWithProtocol, isPlainObject, isString, normalizeRoutePath, omit, removeEndingSlash, removeLeadingSlash, resolveHeadIdentifier, resolveLocalePath, resolveRoutePathFromUrl, splitPath };

package/dist/index.js

@@ -1,145 +1,196 @@
-// src/utils/resolveHeadIdentifier.ts
-var TAGS_ALLOWED = ["link", "meta", "script", "style", "noscript", "template"];
-var TAGS_UNIQUE = ["title", "base"];
-var resolveHeadIdentifier = ([tag, attrs, content]) => {
-  if (TAGS_UNIQUE.includes(tag)) {
-    return tag;
-  }
-  if (!TAGS_ALLOWED.includes(tag)) {
-    return null;
-  }
-  if (tag === "meta" && attrs.name) {
-    return `${tag}.${attrs.name}`;
-  }
-  if (tag === "template" && attrs.id) {
-    return `${tag}.${attrs.id}`;
-  }
-  return JSON.stringify([
-    tag,
-    Object.entries(attrs).map(([key, value]) => {
-      if (typeof value === "boolean") {
-        return value ? [key, ""] : null;
-      }
-      return [key, value];
-    }).filter((item) => item != null).sort(([keyA], [keyB]) => keyA.localeCompare(keyB)),
-    content
-  ]);
+//#region src/utils/links/isLinkWithProtocol.ts
+/**
+* Determine a link has protocol or not
+*/
+const isLinkWithProtocol = (link) => /^[a-z][a-z0-9+.-]*:/.test(link) || link.startsWith("//");
+//#endregion
+//#region src/utils/links/isLinkExternal.ts
+const markdownLinkRegexp = /.md((\?|#).*)?$/;
+/**
+* Determine a link is external or not
+*/
+const isLinkExternal = (link, base = "/") => isLinkWithProtocol(link) || link.startsWith("/") && !link.startsWith(base) && !markdownLinkRegexp.test(link);
+//#endregion
+//#region src/utils/links/isLinkHttp.ts
+/**
+* Determine a link is http link or not
+*
+* - http://github.com
+* - https://github.com
+* - //github.com
+*/
+const isLinkHttp = (link) => /^(https?:)?\/\//.test(link);
+//#endregion
+//#region src/utils/routes/inferRoutePath.ts
+/**
+* Infer route path of the given raw path
+*/
+const inferRoutePath = (rawPath) => {
+	if (!rawPath || rawPath.endsWith("/")) return rawPath;
+	let routePath = rawPath.replace(/(^|\/)README.md$/i, "$1index.html");
+	if (routePath.endsWith(".md")) routePath = `${routePath.substring(0, routePath.length - 3)}.html`;
+	else if (!routePath.endsWith(".html")) routePath = `${routePath}.html`;
+	if (routePath.endsWith("/index.html")) routePath = routePath.substring(0, routePath.length - 10);
+	return routePath;
 };
-
-// src/utils/dedupeHead.ts
-var dedupeHead = (head) => {
-  const identifierSet = /* @__PURE__ */ new Set();
-  const result = [];
-  head.forEach((item) => {
-    const identifier = resolveHeadIdentifier(item);
-    if (identifier && !identifierSet.has(identifier)) {
-      identifierSet.add(identifier);
-      result.push(item);
-    }
-  });
-  return result;
+//#endregion
+//#region src/utils/routes/normalizeRoutePath.ts
+const FAKE_HOST = "http://.";
+/**
+* Normalize the given pathname path to the final route path
+*/
+const normalizeRoutePath = (pathname, current) => {
+	if (!pathname.startsWith("/") && current) {
+		const loc = current.slice(0, current.lastIndexOf("/"));
+		return inferRoutePath(new URL(`${loc}/${pathname}`, FAKE_HOST).pathname);
+	}
+	return inferRoutePath(pathname);
 };
-
-// src/utils/ensureLeadingSlash.ts
-var ensureLeadingSlash = (str) => str[0] === "/" ? str : `/${str}`;
-
-// src/utils/ensureEndingSlash.ts
-var ensureEndingSlash = (str) => str[str.length - 1] === "/" || str.endsWith(".html") ? str : `${str}/`;
-
-// src/utils/formatDateString.ts
-var formatDateString = (str, defaultDateString = "") => {
-  const dateMatch = str.match(/\b(\d{4})-(\d{1,2})-(\d{1,2})\b/);
-  if (dateMatch === null) {
-    return defaultDateString;
-  }
-  const [, yearStr, monthStr, dayStr] = dateMatch;
-  return [yearStr, monthStr.padStart(2, "0"), dayStr.padStart(2, "0")].join("-");
+//#endregion
+//#region src/utils/routes/resolveLocalePath.ts
+/**
+* Resolve the matched locale path of route path
+*/
+const resolveLocalePath = (locales, routePath) => {
+	const localePaths = Object.keys(locales).sort((a, b) => {
+		const levelDelta = b.split("/").length - a.split("/").length;
+		if (levelDelta !== 0) return levelDelta;
+		return b.length - a.length;
+	});
+	for (const localePath of localePaths) if (routePath.startsWith(localePath)) return localePath;
+	return "/";
 };
-
-// src/utils/isLinkHttp.ts
-var isLinkHttp = (link) => /^(https?:)?\/\//.test(link);
-
-// src/utils/isLinkExternal.ts
-var markdownLinkRegexp = /.md((\?|#).*)?$/;
-var isLinkExternal = (link, base = "/") => {
-  if (isLinkHttp(link)) {
-    return true;
-  }
-  if (link.startsWith("/") && !link.startsWith(base) && !markdownLinkRegexp.test(link)) {
-    return true;
-  }
-  return false;
+//#endregion
+//#region src/utils/routes/resolveRoutePathFromUrl.ts
+/**
+* For a give URL, remove the origin and the site base to get the route path
+*/
+const resolveRoutePathFromUrl = (url, base = "/") => {
+	const pathname = url.replace(/^(?:https?:)?\/\/[^/]*/, "");
+	return pathname.startsWith(base) ? `/${pathname.slice(base.length)}` : pathname;
 };
-
-// src/utils/isLinkWithProtocol.ts
-var isLinkWithProtocol = (link) => /^[a-z][a-z0-9+.-]*:/.test(link);
-
-// src/utils/isPlainObject.ts
-var isPlainObject = (val) => Object.prototype.toString.call(val) === "[object Object]";
-
-// src/utils/normalizeRoutePath.ts
-var normalizeRoutePath = (path) => {
-  const convertedMdPath = path.endsWith("README.md") ? path.substring(0, path.length - 9) : path.endsWith(".md") ? path.substring(0, path.length - 3) + ".html" : path;
-  return convertedMdPath.endsWith("/index.html") ? convertedMdPath.substring(0, convertedMdPath.length - 10) : convertedMdPath.endsWith(".html") || convertedMdPath.endsWith("/") ? convertedMdPath : convertedMdPath + ".html";
+//#endregion
+//#region src/utils/routes/splitPath.ts
+const SPLIT_CHAR_REGEXP = /(#|\?)/;
+/**
+* Split a path into pathname and hashAndQueries
+*/
+const splitPath = (path) => {
+	const [pathname, ...hashAndQueries] = path.split(SPLIT_CHAR_REGEXP);
+	return {
+		pathname,
+		hashAndQueries: hashAndQueries.join("")
+	};
 };
-
-// src/utils/omit.ts
-var omit = (obj, ...keys) => {
-  const result = { ...obj };
-  for (const key of keys) {
-    delete result[key];
-  }
-  return result;
+//#endregion
+//#region src/utils/resolveHeadIdentifier.ts
+const TAGS_ALLOWED = [
+	"link",
+	"meta",
+	"script",
+	"style",
+	"noscript",
+	"template"
+];
+const TAGS_UNIQUE = ["title", "base"];
+/**
+* Resolve identifier of a tag, to avoid duplicated tags in `<head>`
+*/
+const resolveHeadIdentifier = ([tag, attrs, content]) => {
+	if (TAGS_UNIQUE.includes(tag)) return tag;
+	if (!TAGS_ALLOWED.includes(tag)) return null;
+	if (tag === "meta" && attrs.name) return `${tag}.${attrs.name}`;
+	if (tag === "template" && attrs.id) return `${tag}.${attrs.id}`;
+	return JSON.stringify([
+		tag,
+		Object.entries(attrs).map(([key, value]) => {
+			if (typeof value === "boolean") return value ? [key, ""] : null;
+			return [key, value];
+		}).filter((item) => item != null).sort(([keyA], [keyB]) => keyA.localeCompare(keyB)),
+		content
+	]);
 };
-
-// src/utils/removeEndingSlash.ts
-var removeEndingSlash = (str) => str[str.length - 1] === "/" ? str.slice(0, -1) : str;
-
-// src/utils/removeLeadingSlash.ts
-var removeLeadingSlash = (str) => str[0] === "/" ? str.slice(1) : str;
-
-// src/utils/resolveLocalePath.ts
-var resolveLocalePath = (locales, routePath) => {
-  const localePaths = Object.keys(locales).sort((a, b) => {
-    const levelDelta = b.split("/").length - a.split("/").length;
-    if (levelDelta !== 0) {
-      return levelDelta;
-    }
-    return b.length - a.length;
-  });
-  for (const localePath of localePaths) {
-    if (routePath.startsWith(localePath)) {
-      return localePath;
-    }
-  }
-  return "/";
+//#endregion
+//#region src/utils/dedupeHead.ts
+/**
+* Dedupe head config with identifier
+*
+* Items that appear earlier have higher priority
+*/
+const dedupeHead = (head) => {
+	const identifierSet = /* @__PURE__ */ new Set();
+	const result = [];
+	head.forEach((item) => {
+		const identifier = resolveHeadIdentifier(item);
+		if (identifier && !identifierSet.has(identifier)) {
+			identifierSet.add(identifier);
+			result.push(item);
+		}
+	});
+	return result;
 };
-
-// src/utils/resolveRoutePathFromUrl.ts
-var resolveRoutePathFromUrl = (url, base = "/") => {
-  const pathname = url.replace(/^(https?:)?\/\/[^/]*/, "");
-  return pathname.startsWith(base) ? `/${pathname.slice(base.length)}` : pathname;
+//#endregion
+//#region src/utils/ensureLeadingSlash.ts
+/**
+* Ensure a url string to have leading slash /
+*/
+const ensureLeadingSlash = (str) => str.startsWith("/") ? str : `/${str}`;
+//#endregion
+//#region src/utils/ensureEndingSlash.ts
+/**
+* Ensure a url string to have ending slash /
+*/
+const ensureEndingSlash = (str) => str.endsWith("/") || str.endsWith(".html") ? str : `${str}/`;
+//#endregion
+//#region src/utils/formatDateString.ts
+/**
+* Format a date string to `yyyy-MM-dd`
+*/
+const formatDateString = (str, defaultDateString = "") => {
+	const dateMatch = str.match(/\b(\d{4})-(\d{1,2})-(\d{1,2})\b/);
+	if (dateMatch === null) return defaultDateString;
+	const [, yearStr, monthStr, dayStr] = dateMatch;
+	return [
+		yearStr,
+		monthStr.padStart(2, "0"),
+		dayStr.padStart(2, "0")
+	].join("-");
 };
-
-// src/utils/typeGuards.ts
-var isFunction = (val) => typeof val === "function";
-var isString = (val) => typeof val === "string";
-export {
-  dedupeHead,
-  ensureEndingSlash,
-  ensureLeadingSlash,
-  formatDateString,
-  isFunction,
-  isLinkExternal,
-  isLinkHttp,
-  isLinkWithProtocol,
-  isPlainObject,
-  isString,
-  normalizeRoutePath,
-  omit,
-  removeEndingSlash,
-  removeLeadingSlash,
-  resolveHeadIdentifier,
-  resolveLocalePath,
-  resolveRoutePathFromUrl
+//#endregion
+//#region src/utils/omit.ts
+/**
+* Omit properties from an object
+*/
+const omit = (obj, ...keys) => {
+	const result = { ...obj };
+	for (const key of keys) delete result[key];
+	return result;
 };
+//#endregion
+//#region src/utils/removeEndingSlash.ts
+/**
+* Remove ending slash / from a string
+*/
+const removeEndingSlash = (str) => str.endsWith("/") ? str.slice(0, -1) : str;
+//#endregion
+//#region src/utils/removeLeadingSlash.ts
+/**
+* Remove leading slash / from a string
+*/
+const removeLeadingSlash = (str) => str.startsWith("/") ? str.slice(1) : str;
+//#endregion
+//#region src/utils/typeGuards.ts
+/**
+* Check if a value is a function
+*/
+const isFunction = (val) => typeof val === "function";
+/**
+* Check if a value is plain object, with generic type support
+*/
+const isPlainObject = (val) => Object.prototype.toString.call(val) === "[object Object]";
+/**
+* Check if a value is a string
+*/
+const isString = (val) => typeof val === "string";
+//#endregion
+export { dedupeHead, ensureEndingSlash, ensureLeadingSlash, formatDateString, inferRoutePath, isFunction, isLinkExternal, isLinkHttp, isLinkWithProtocol, isPlainObject, isString, normalizeRoutePath, omit, removeEndingSlash, removeLeadingSlash, resolveHeadIdentifier, resolveLocalePath, resolveRoutePathFromUrl, splitPath };

package/package.json

@@ -1,55 +1,49 @@
 {
   "name": "@vuepress/shared",
-  "version": "2.0.0-rc.3",
+  "version": "2.0.0-rc.31",
   "description": "Utils that shared between VuePress node and client",
   "keywords": [
-    "vuepress",
     "shared",
-    "utils"
+    "utils",
+    "vuepress"
   ],
   "homepage": "https://github.com/vuepress",
   "bugs": {
     "url": "https://github.com/vuepress/core/issues"
   },
+  "license": "MIT",
+  "author": "meteorlxy",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vuepress/core.git"
   },
-  "license": "MIT",
-  "author": "meteorlxy",
+  "files": [
+    "dist"
+  ],
   "type": "module",
-  "exports": {
-    ".": "./dist/index.js",
-    "./package.json": "./package.json"
-  },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "dependencies": {
-    "@mdit-vue/types": "^2.0.0"
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
-  "tsup": {
-    "clean": true,
-    "dts": "./src/index.ts",
-    "entry": [
-      "./src/index.ts"
-    ],
-    "format": [
-      "esm"
-    ],
-    "outDir": "./dist",
-    "sourcemap": false,
-    "target": "es2022",
+  "dependencies": {
+    "@mdit-vue/types": "^3.0.2"
+  },
+  "tsdown": {
+    "dts": true,
+    "entry": "./src/index.ts",
+    "fixedExtension": false,
+    "format": "esm",
+    "target": "es2023",
     "tsconfig": "../../tsconfig.dts.json"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsdown",
     "clean": "rimraf dist"
   }
 }