@rspress/shared 2.0.14 → 2.0.16

package/dist/index.d.ts

@@ -27,6 +27,8 @@ export declare const cleanUrl: (url: string) => string;
 
 export declare type Config = UserConfig | Promise<UserConfig> | ((...args: Parameters<typeof loadConfig>) => UserConfig | Promise<UserConfig>);
 
+export declare type DarkMode = boolean | NormalizedDarkMode;
+
 export declare interface EditLink {
     /**
      * Custom repository url for edit link.
@@ -85,9 +87,12 @@ export declare interface FrontMatterMeta {
     titleSuffix?: string;
     head?: [string, Record<string, string>][];
     context?: string;
+    search?: boolean;
     [key: string]: unknown;
 }
 
+export declare const getDefaultDarkModeValue: (darkMode: DarkMode | undefined) => ThemeConfigValue;
+
 /**
  * get the sidebar group for the current page
  * @param sidebar const { sidebar } = useLocaleSiteData();
@@ -144,6 +149,7 @@ export declare interface I18nText {
     outlineTitle?: I18nTextValue;
     scrollToTopText?: I18nTextValue;
     lastUpdatedText?: I18nTextValue;
+    lastUpdatedAuthorText?: I18nTextValue;
     prevPageText?: I18nTextValue;
     nextPageText?: I18nTextValue;
     editLinkText?: I18nTextValue;
@@ -173,6 +179,8 @@ declare type I18nTextValue = {
 
 export declare const inBrowser: () => boolean;
 
+export declare const isDarkModeSwitchEnabled: (darkMode: DarkMode | undefined) => boolean;
+
 export declare function isDataUrl(url?: string): boolean;
 
 export declare const isDebugMode: () => boolean;
@@ -183,6 +191,23 @@ export declare function isExternalUrl(url?: string): boolean;
 
 export declare const isProduction: () => boolean;
 
+export declare type LastUpdated = boolean | {
+    /**
+     * Whether to display the last author of the file (from git log).
+     * - `false`: hide the author.
+     * - `true`: show the commit author's name.
+     * - function: receives `{ name, email, filePath }` and returns the display string.
+     * @default false
+     */
+    author?: LastUpdatedAuthor;
+};
+
+export declare type LastUpdatedAuthor = boolean | ((info: {
+    name: string;
+    email: string;
+    filePath: string;
+}) => string);
+
 /**
  * Configuration for LLMS UI components displayed on H1 headers.
  * When enabled, LlmsCopyButton and LlmsViewOptions will be automatically
@@ -266,7 +291,7 @@ export declare interface MarkdownOptions {
      */
     rehypePlugins?: PluggableList;
     /**
-     * @default { checkDeadLinks: true, autoPrefix: true }
+     * @default { checkDeadLinks: true, checkAnchors: false, autoPrefix: true }
      */
     link?: RemarkLinkOptions;
     /**
@@ -374,6 +399,14 @@ export declare interface NavItemWithLinkAndChildren {
     rel?: string;
 }
 
+export declare const normalizeDarkMode: (darkMode: DarkMode | undefined) => NormalizedDarkMode;
+
+export declare type NormalizedDarkMode = 'light' | 'dark' | 'auto' | 'force-light' | 'force-dark' | 'force-auto';
+
+export declare type NormalizedLastUpdated = boolean | {
+    author?: boolean;
+};
+
 export declare interface NormalizedLocales extends Omit<LocaleConfig, 'sidebar'> {
     sidebar: NormalizedSidebar;
 }
@@ -388,7 +421,8 @@ export declare interface NormalizedSidebarGroup extends Omit<SidebarGroup, 'item
     collapsed: boolean;
 }
 
-declare interface NormalizedThemeConfig extends Omit<ThemeConfig, 'locales' | 'sidebar'> {
+declare interface NormalizedThemeConfig extends Omit<ThemeConfig, 'lastUpdated' | 'locales' | 'sidebar'> {
+    lastUpdated?: NormalizedLastUpdated;
     locales: NormalizedLocales[];
     sidebar: NormalizedSidebar;
 }
@@ -411,6 +445,7 @@ export declare interface PageDataLegacy {
         headingTitle?: string;
         pagePath: string;
         lastUpdatedTime?: string;
+        lastUpdatedAuthor?: string;
         description?: string;
         pageType: PageType;
         [key: string]: unknown;
@@ -471,6 +506,13 @@ export declare type RemarkLinkOptions = {
     checkDeadLinks?: boolean | {
         excludes: string[] | ((url: string) => boolean);
     };
+    /**
+     * Whether to enable dead anchor checks
+     * @default false
+     */
+    checkAnchors?: boolean | {
+        excludes: string[] | ((url: string) => boolean);
+    };
     /**
      * [](/v3/zh/guide) [](/zh/guide) [](/guide) will be regarded as the same [](/v3/zh/guide) according to the directory.
      * @default true
@@ -769,10 +811,12 @@ declare type SocialLinkIcon = 'lark' | 'discord' | 'facebook' | 'github' | 'inst
 
 declare type ThemeConfig = {
     /**
-     * Whether to enable dark mode.
+     * Whether to enable dark mode and how to resolve the default theme.
+     * - `true`: same as `'auto'`.
+     * - `false`: same as `'force-light'`.
      * @default true
      */
-    darkMode?: boolean;
+    darkMode?: DarkMode;
     /**
      * The nav items. When it's an object, the key is the version of current doc.
      * @default []
@@ -791,9 +835,10 @@ declare type ThemeConfig = {
     editLink?: EditLink;
     /**
      * Whether to display the last update time of the file.
+     * Set `author` to show the last commit author.
      * @default false
      */
-    lastUpdated?: boolean;
+    lastUpdated?: LastUpdated;
     /**
      * The social links to be displayed at the end of the nav bar. Perfect for
      * placing links to social services such as GitHub, X, Facebook, etc.
@@ -854,6 +899,8 @@ declare type ThemeConfig = {
 export { ThemeConfig as DefaultThemeConfig }
 export { ThemeConfig }
 
+declare type ThemeConfigValue = 'light' | 'dark' | 'auto';
+
 export declare interface UserConfig {
     /**
      * The root directory of the site.

package/dist/index.js

@@ -162,4 +162,15 @@ const getSidebarDataGroup = (sidebar, currentPathname)=>{
     return [];
 };
 const matchNavbar = (item, currentPathname)=>new RegExp(item.activeMatch || normalizeHref(item.link, true)).test(currentPathname);
-export { HASH_REGEXP, MDX_OR_MD_REGEXP, QUERY_REGEXP, RSPRESS_TEMP_DIR, SEARCH_INDEX_NAME, addLeadingSlash, addTrailingSlash, getSidebarDataGroup, inBrowser, isDataUrl, isDebugMode, isDevDebugMode, isExternalUrl, isProduction, matchNavbar, matchSidebar, normalizeHref, normalizePosixPath, parseUrl, removeBase, removeHash, removeLeadingSlash, removeTrailingSlash, replaceLang, replaceVersion, slash, utils_cleanUrl as cleanUrl, withBase, withoutLang };
+const normalizeDarkMode = (darkMode)=>{
+    if (false === darkMode) return 'force-light';
+    if (true === darkMode || void 0 === darkMode) return 'auto';
+    return darkMode;
+};
+const getDefaultDarkModeValue = (darkMode)=>{
+    const normalizedDarkMode = normalizeDarkMode(darkMode);
+    if (normalizedDarkMode.startsWith('force-')) return normalizedDarkMode.slice(6);
+    return normalizedDarkMode;
+};
+const isDarkModeSwitchEnabled = (darkMode)=>!normalizeDarkMode(darkMode).startsWith('force-');
+export { HASH_REGEXP, MDX_OR_MD_REGEXP, QUERY_REGEXP, RSPRESS_TEMP_DIR, SEARCH_INDEX_NAME, addLeadingSlash, addTrailingSlash, getDefaultDarkModeValue, getSidebarDataGroup, inBrowser, isDarkModeSwitchEnabled, isDataUrl, isDebugMode, isDevDebugMode, isExternalUrl, isProduction, matchNavbar, matchSidebar, normalizeDarkMode, normalizeHref, normalizePosixPath, parseUrl, removeBase, removeHash, removeLeadingSlash, removeTrailingSlash, replaceLang, replaceVersion, slash, utils_cleanUrl as cleanUrl, withBase, withoutLang };

package/dist/node-utils.d.ts

@@ -19,6 +19,8 @@ declare interface AdditionalPage {
     filepath?: string;
 }
 
+declare type DarkMode = boolean | NormalizedDarkMode;
+
 declare interface EditLink {
     /**
      * Custom repository url for edit link.
@@ -82,6 +84,7 @@ declare interface FrontMatterMeta {
     titleSuffix?: string;
     head?: [string, Record<string, string>][];
     context?: string;
+    search?: boolean;
     [key: string]: unknown;
 }
 
@@ -147,6 +150,7 @@ declare interface I18nText {
     outlineTitle?: I18nTextValue;
     scrollToTopText?: I18nTextValue;
     lastUpdatedText?: I18nTextValue;
+    lastUpdatedAuthorText?: I18nTextValue;
     prevPageText?: I18nTextValue;
     nextPageText?: I18nTextValue;
     editLinkText?: I18nTextValue;
@@ -174,6 +178,23 @@ declare type I18nTextValue = {
     [key: string]: string;
 };
 
+declare type LastUpdated = boolean | {
+    /**
+     * Whether to display the last author of the file (from git log).
+     * - `false`: hide the author.
+     * - `true`: show the commit author's name.
+     * - function: receives `{ name, email, filePath }` and returns the display string.
+     * @default false
+     */
+    author?: LastUpdatedAuthor;
+};
+
+declare type LastUpdatedAuthor = boolean | ((info: {
+    name: string;
+    email: string;
+    filePath: string;
+}) => string);
+
 /**
  * Configuration for LLMS UI components displayed on H1 headers.
  * When enabled, LlmsCopyButton and LlmsViewOptions will be automatically
@@ -263,7 +284,7 @@ declare interface MarkdownOptions {
      */
     rehypePlugins?: PluggableList;
     /**
-     * @default { checkDeadLinks: true, autoPrefix: true }
+     * @default { checkDeadLinks: true, checkAnchors: false, autoPrefix: true }
      */
     link?: RemarkLinkOptions;
     /**
@@ -362,6 +383,8 @@ declare interface NavItemWithLinkAndChildren {
     rel?: string;
 }
 
+declare type NormalizedDarkMode = 'light' | 'dark' | 'auto' | 'force-light' | 'force-dark' | 'force-auto';
+
 /**
  * @description search-index.json file
  * "_foo" is the private field that won't be written to search-index.json file
@@ -401,6 +424,13 @@ declare type RemarkLinkOptions = {
     checkDeadLinks?: boolean | {
         excludes: string[] | ((url: string) => boolean);
     };
+    /**
+     * Whether to enable dead anchor checks
+     * @default false
+     */
+    checkAnchors?: boolean | {
+        excludes: string[] | ((url: string) => boolean);
+    };
     /**
      * [](/v3/zh/guide) [](/zh/guide) [](/guide) will be regarded as the same [](/v3/zh/guide) according to the directory.
      * @default true
@@ -615,10 +645,12 @@ declare type SocialLinkIcon = 'lark' | 'discord' | 'facebook' | 'github' | 'inst
 
 declare type ThemeConfig = {
     /**
-     * Whether to enable dark mode.
+     * Whether to enable dark mode and how to resolve the default theme.
+     * - `true`: same as `'auto'`.
+     * - `false`: same as `'force-light'`.
      * @default true
      */
-    darkMode?: boolean;
+    darkMode?: DarkMode;
     /**
      * The nav items. When it's an object, the key is the version of current doc.
      * @default []
@@ -637,9 +669,10 @@ declare type ThemeConfig = {
     editLink?: EditLink;
     /**
      * Whether to display the last update time of the file.
+     * Set `author` to show the last commit author.
      * @default false
      */
-    lastUpdated?: boolean;
+    lastUpdated?: LastUpdated;
     /**
      * The social links to be displayed at the end of the nav bar. Perfect for
      * placing links to social services such as GitHub, X, Facebook, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rspress/shared",
-  "version": "2.0.14",
+  "version": "2.0.16",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/web-infra-dev/rspress.git",
@@ -44,22 +44,22 @@
     "dist"
   ],
   "dependencies": {
-    "@rsbuild/core": "^2.0.9",
-    "@shikijs/rehype": "^4.0.2",
+    "@rsbuild/core": "^2.0.15",
+    "@shikijs/rehype": "^4.2.0",
     "unified": "^11.0.5"
   },
   "devDependencies": {
-    "@rslib/core": "0.22.0",
+    "@rslib/core": "0.23.0",
     "@types/lodash-es": "^4.17.12",
     "@types/node": "^22.8.1",
-    "@types/react": "^19.2.15",
+    "@types/react": "^19.2.17",
     "github-slugger": "^2.0.0",
     "gray-matter": "4.0.3",
     "lodash-es": "^4.18.1",
     "mdast-util-mdx-jsx": "^3.2.0",
     "medium-zoom": "1.1.0",
     "rimraf": "^6.1.3",
-    "rsbuild-plugin-publint": "^0.3.4",
+    "rsbuild-plugin-publint": "^1.0.0",
     "typescript": "^6.0.3"
   },
   "publishConfig": {