@rspress-theme-anatole/shared 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,939 @@
+import type { loadConfig } from '@rsbuild/core';
+import type { PluggableList } from 'unified';
+import type { RsbuildConfig } from '@rsbuild/core';
+import type { RsbuildPlugin } from '@rsbuild/core';
+
+/**
+ * There are two ways to define what addition routes represent.
+ * 1. Define filepath, then the content will be read from the file.
+ * 2. Define content, then then content will be written to temp file and read from it.
+ */
+export declare interface AdditionalPage {
+    routePath: string;
+    content?: string;
+    filepath?: string;
+}
+
+export declare function addLeadingSlash(url: string): string;
+
+export declare function addTrailingSlash(url: string): string;
+
+export declare type AnyFunction = (...args: any[]) => any;
+
+export declare const APPEARANCE_KEY = "rspress-theme-appearance";
+
+export declare type BaseRuntimePageInfo = Omit<RemoveUnderscoreProps<PageIndexInfo>, 'id' | 'content' | 'domain'>;
+
+export declare const cleanUrl: (url: string) => string;
+
+export declare type Config = UserConfig | Promise<UserConfig> | ((...args: Parameters<typeof loadConfig>) => UserConfig | Promise<UserConfig>);
+
+export declare const DEFAULT_HIGHLIGHT_LANGUAGES: string[][];
+
+export declare interface DefaultThemeConfig {
+    /**
+     * Whether to enable dark mode.
+     * @default true
+     */
+    darkMode?: boolean;
+    /**
+     * Custom outline title in the aside component.
+     *
+     * @default 'ON THIS PAGE'
+     */
+    outlineTitle?: string;
+    /**
+     * Whether to show the sidebar in right position.
+     */
+    outline?: boolean;
+    /**
+     * The nav items. When it's an object, the key is the version of current doc.
+     */
+    nav?: NavItem[] | {
+        [key: string]: NavItem[];
+    };
+    /**
+     * The sidebar items.
+     */
+    sidebar?: Sidebar;
+    /**
+     * Info for the edit link. If it's undefined, the edit link feature will
+     * be disabled.
+     */
+    editLink?: EditLink;
+    /**
+     * Set custom last updated text.
+     *
+     * @default 'Last updated'
+     */
+    lastUpdatedText?: string;
+    /**
+     * Set custom last updated text.
+     *
+     * @default false
+     */
+    lastUpdated?: boolean;
+    /**
+     * Set custom prev/next labels.
+     */
+    docFooter?: DocFooter;
+    /**
+     * 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.
+     */
+    socialLinks?: SocialLink[];
+    /**
+     * The footer configuration.
+     */
+    footer?: Footer;
+    /**
+     * The prev page text.
+     */
+    prevPageText?: string;
+    /**
+     * The next page text.
+     */
+    nextPageText?: string;
+    /**
+     * The source code text.
+     */
+    sourceCodeText?: string;
+    /**
+     * Locale config
+     */
+    locales?: LocaleConfig[];
+    /**
+     * Whether to open the full text search
+     */
+    search?: boolean;
+    /**
+     * The placeholder of search input
+     */
+    searchPlaceholderText?: string;
+    /**
+     * The text of no search result
+     */
+    searchNoResultsText?: string;
+    /**
+     * The text of suggested query text when no search result
+     */
+    searchSuggestedQueryText?: string;
+    /**
+     * The text of overview filter
+     */
+    overview?: FilterConfig;
+    /**
+     * The behavior of hiding navbar
+     */
+    hideNavbar?: 'always' | 'auto' | 'never';
+    /**
+     * Whether to enable view transition animation for pages switching
+     */
+    enableContentAnimation?: boolean;
+    /**
+     * Whether to enable view transition animation for the theme
+     */
+    enableAppearanceAnimation?: boolean;
+    /**
+     * Enable scroll to top button on documentation
+     * @default false
+     */
+    enableScrollToTop?: boolean;
+    /**
+     * Whether to redirect to the closest locale when the user visits the site
+     * @default 'auto'
+     */
+    localeRedirect?: 'auto' | 'never';
+    /**
+     * Whether to show the fallback heading title when the heading title is not presented but `frontmatter.title` exists
+     * @default true
+     */
+    fallbackHeadingTitle?: boolean;
+}
+
+export declare interface DocFooter {
+    /**
+     * Custom label for previous page button.
+     */
+    prev?: SidebarItem;
+    /**
+     * Custom label for next page button.
+     */
+    next?: SidebarItem;
+}
+
+export declare interface EditLink {
+    /**
+     * Custom repository url for edit link.
+     */
+    docRepoBaseUrl: string;
+    /**
+     * Custom text for edit link.
+     *
+     * @default 'Edit this page'
+     */
+    text?: string;
+}
+
+export declare interface Feature {
+    icon: string;
+    title: string;
+    details: string;
+    span?: number;
+    link?: string;
+}
+
+/**
+ * The config of filter component
+ */
+export declare interface FilterConfig {
+    filterNameText?: string;
+    filterPlaceholderText?: string;
+    filterNoResultText?: string;
+}
+
+export declare interface Footer {
+    message?: string;
+}
+
+export declare interface FrontMatterMeta {
+    title?: string;
+    description?: string;
+    overview?: boolean;
+    pageType?: PageType;
+    features?: Feature[];
+    hero?: Hero;
+    sidebar?: boolean;
+    outline?: boolean;
+    lineNumbers?: boolean;
+    overviewHeaders?: number[];
+    titleSuffix?: string;
+    head?: [string, Record<string, string>][];
+    context?: string;
+    [key: string]: unknown;
+}
+
+export declare const HASH_REGEXP: RegExp;
+
+export declare interface Header {
+    id: string;
+    text: string;
+    depth: number;
+    charIndex: number;
+}
+
+export declare interface Hero {
+    name: string;
+    text: string;
+    tagline: string;
+    image?: {
+        src: string | {
+            dark: string;
+            light: string;
+        };
+        alt: string;
+        /**
+         * `srcset` and `sizes` are attributes of `<img>` tag. Please refer to https://mdn.io/srcset for the usage.
+         * When the value is an array, rspress will join array members with commas.
+         **/
+        sizes?: string | string[];
+        srcset?: string | string[];
+    };
+    actions: {
+        text: string;
+        link: string;
+        theme: 'brand' | 'alt';
+    }[];
+}
+
+declare type Image_2 = string | {
+    src: string;
+    alt?: string;
+};
+export { Image_2 as Image }
+
+export declare const inBrowser: () => boolean;
+
+export declare function isDataUrl(url?: string): boolean;
+
+export declare const isDebugMode: () => boolean;
+
+export declare const isDevDebugMode: () => boolean;
+
+export declare function isExternalUrl(url?: string): boolean;
+
+export declare const isProduction: () => boolean;
+
+export declare const isSCM: () => boolean;
+
+export declare interface Locale {
+    lang: string;
+    label: string;
+    title?: string;
+    description?: string;
+}
+
+/**
+ * locale config
+ */
+export declare interface LocaleConfig {
+    /**
+     * Site i18n config, which will recover the locales config in the site level.
+     */
+    lang: string;
+    title?: string;
+    description?: string;
+    label: string;
+    /**
+     * Theme i18n config
+     */
+    nav?: Nav;
+    sidebar?: Sidebar;
+    outlineTitle?: string;
+    lastUpdatedText?: string;
+    lastUpdated?: boolean;
+    editLink?: EditLink;
+    prevPageText?: string;
+    nextPageText?: string;
+    sourceCodeText?: string;
+    langRoutePrefix?: string;
+    searchPlaceholderText?: string;
+    searchNoResultsText?: string;
+    searchSuggestedQueryText?: string;
+    overview?: FilterConfig;
+}
+
+export declare interface LocaleLink {
+    text: string;
+    link: string;
+}
+
+export declare interface LocaleLinks {
+    text: string;
+    items: LocaleLink[];
+}
+
+export declare type LocalSearchOptions = SearchHooks & {
+    mode?: 'local';
+    /**
+     * Whether to generate separate search index for each version
+     */
+    versioned?: boolean;
+    /**
+     * If enabled, the search index will include code block content, which allows users to search code blocks.
+     * @default false
+     */
+    codeBlocks?: boolean;
+};
+
+export declare interface MarkdownOptions {
+    remarkPlugins?: PluggableList;
+    rehypePlugins?: PluggableList;
+    /**
+     * Whether to enable check dead links, default is false
+     */
+    checkDeadLinks?: boolean;
+    showLineNumbers?: boolean;
+    /**
+     * Whether to wrap code by default, default is false
+     */
+    defaultWrapCode?: boolean;
+    /**
+     * Register global components in mdx files
+     */
+    globalComponents?: string[];
+    /**
+     * Code highlighter, default is prism for performance reason
+     */
+    codeHighlighter?: 'prism' | 'shiki';
+    /**
+     * Register prism languages
+     */
+    highlightLanguages?: (string | [string, string])[];
+    /**
+     * Whether to enable mdx-rs, default is true
+     */
+    mdxRs?: boolean | MdxRsOptions;
+    /**
+     * @deprecated, use `mdxRs` instead
+     */
+    experimentalMdxRs?: boolean;
+}
+
+export declare const MDX_OR_MD_REGEXP: RegExp;
+
+export declare interface MdxRsOptions {
+    /**
+     * Determine whether the file use mdxRs compiler
+     */
+    include?: (filepath: string) => boolean;
+}
+
+export declare type Nav = NavItem[] | {
+    [key: string]: NavItem[];
+};
+
+export declare type NavItem = NavItemWithLink | NavItemWithChildren | NavItemWithLinkAndChildren;
+
+export declare interface NavItemWithChildren {
+    text?: string;
+    tag?: string;
+    items: NavItemWithLink[];
+    position?: 'left' | 'right';
+}
+
+export declare type NavItemWithLink = {
+    text: string;
+    link: string;
+    tag?: string;
+    activeMatch?: string;
+    position?: 'left' | 'right';
+};
+
+export declare interface NavItemWithLinkAndChildren {
+    text: string;
+    link: string;
+    items: NavItemWithLink[];
+    tag?: string;
+    activeMatch?: string;
+    position?: 'left' | 'right';
+}
+
+declare interface NormalizedConfig extends Omit<DefaultThemeConfig, 'locales' | 'sidebar'> {
+    locales: NormalizedLocales[];
+    sidebar: NormalizedSidebar;
+}
+export { NormalizedConfig }
+export { NormalizedConfig as NormalizedDefaultThemeConfig }
+
+export declare interface NormalizedLocales extends Omit<LocaleConfig, 'sidebar'> {
+    sidebar: NormalizedSidebar;
+}
+
+export declare interface NormalizedSidebar {
+    [path: string]: (NormalizedSidebarGroup | SidebarItem | SidebarDivider)[];
+}
+
+export declare interface NormalizedSidebarGroup extends Omit<SidebarGroup, 'items'> {
+    items: (SidebarDivider | SidebarItem | NormalizedSidebarGroup)[];
+    collapsible: boolean;
+    collapsed: boolean;
+}
+
+export declare function normalizeHref(url?: string, cleanUrls?: boolean): string;
+
+export declare function normalizePosixPath(id: string): string;
+
+export declare function normalizeSlash(url: string): string;
+
+export declare interface PageData {
+    siteData: SiteData<DefaultThemeConfig>;
+    page: BaseRuntimePageInfo & {
+        headingTitle?: string;
+        pagePath: string;
+        lastUpdatedTime?: string;
+        description?: string;
+        pageType: PageType;
+        [key: string]: unknown;
+    };
+}
+
+/**
+ * @description search-index.json file
+ * "_foo" is the private field that won't be written to search-index.json file
+ * and should not be used in the runtime (usePageData).
+ */
+export declare interface PageIndexInfo {
+    id: number;
+    title: string;
+    routePath: string;
+    toc: Header[];
+    content: string;
+    _html: string;
+    frontmatter: FrontMatterMeta;
+    lang: string;
+    version: string;
+    domain: string;
+    _filepath: string;
+    _relativePath: string;
+}
+
+export declare interface PageModule<T extends React.ComponentType<unknown>> {
+    default: T;
+    frontmatter?: FrontMatterMeta;
+    content?: string;
+    [key: string]: unknown;
+}
+
+export declare type PageType = 'home' | 'doc' | 'custom' | '404' | 'blank';
+
+export declare const parseUrl: (url: string) => {
+    url: string;
+    hash: string;
+};
+
+export declare const QUERY_REGEXP: RegExp;
+
+export declare type RemotePageInfo = PageIndexInfo & {
+    _matchesPosition: {
+        content: {
+            start: number;
+            length: number;
+        }[];
+    };
+};
+
+export declare type RemoteSearchIndexInfo = string | {
+    value: string;
+    label: string;
+};
+
+export declare type RemoteSearchOptions = SearchHooks & {
+    mode: 'remote';
+    apiUrl: string;
+    domain?: string;
+    indexName: string;
+    searchIndexes?: RemoteSearchIndexInfo[];
+    searchLoading?: boolean;
+};
+
+export declare function removeBase(url: string, base: string): string;
+
+export declare function removeHash(str: string): string;
+
+export declare function removeLeadingSlash(url: string): string;
+
+export declare function removeTrailingSlash(url: string): string;
+
+declare type RemoveUnderscoreProps<T> = {
+    [K in keyof T as K extends `_${string}` ? never : K]: T[K];
+};
+
+export declare function replaceLang(rawUrl: string, lang: {
+    current: string;
+    target: string;
+    default: string;
+}, version: {
+    current: string;
+    default: string;
+}, base?: string, cleanUrls?: boolean, isPageNotFound?: boolean): string;
+
+export declare interface ReplaceRule {
+    search: string | RegExp;
+    replace: string;
+}
+
+export declare function replaceVersion(rawUrl: string, version: {
+    current: string;
+    target: string;
+    default: string;
+}, base?: string, cleanUrls?: boolean, isPageNotFound?: boolean): string;
+
+export declare interface Route {
+    path: string;
+    element: React.ReactElement;
+    filePath: string;
+    preload: () => Promise<PageModule<React.ComponentType<unknown>>>;
+    lang: string;
+}
+
+export declare interface RouteMeta {
+    routePath: string;
+    absolutePath: string;
+    relativePath: string;
+    pageName: string;
+    lang: string;
+    version: string;
+}
+
+export declare interface RouteOptions {
+    /**
+     * The extension name of the filepath that will be converted to a route
+     * @default ['js','jsx','ts','tsx','md','mdx']
+     */
+    extensions?: string[];
+    /**
+     * Include extra files from being converted to routes
+     */
+    include?: string[];
+    /**
+     * Exclude files from being converted to routes
+     */
+    exclude?: string[];
+    /**
+     * use links without .html files
+     */
+    cleanUrls?: boolean;
+}
+
+export declare const RSPRESS_TEMP_DIR = ".rspress";
+
+declare interface RspressPlugin {
+    /**
+     * Name of the plugin.
+     */
+    name: string;
+    /**
+     * Global style
+     */
+    globalStyles?: string;
+    /**
+     * Markdown options.
+     */
+    markdown?: {
+        remarkPlugins?: PluggableList;
+        rehypePlugins?: PluggableList;
+        globalComponents?: string[];
+    };
+    /**
+     * Rsbuild config.
+     */
+    builderConfig?: RsbuildConfig;
+    /**
+     * Inject global components.
+     */
+    globalUIComponents?: (string | [string, object])[];
+    /**
+     * Modify doc config.
+     */
+    config?: (config: UserConfig, utils: {
+        addPlugin: (plugin: RspressPlugin) => void;
+        removePlugin: (pluginName: string) => void;
+    }, isProd: boolean) => UserConfig | Promise<UserConfig>;
+    /**
+     * Callback before build
+     */
+    beforeBuild?: (config: UserConfig, isProd: boolean) => void | Promise<void>;
+    /**
+     * Callback after build
+     */
+    afterBuild?: (config: UserConfig, isProd: boolean) => void | Promise<void>;
+    /**
+     * Extend every page's data
+     */
+    extendPageData?: (pageData: PageIndexInfo, isProd: boolean) => void | Promise<void>;
+    /**
+     * Add custom route
+     */
+    addPages?: (config: UserConfig, isProd: boolean) => AdditionalPage[] | Promise<AdditionalPage[]>;
+    /**
+     * Add runtime modules
+     */
+    addRuntimeModules?: (config: UserConfig, isProd: boolean) => Record<string, string> | Promise<Record<string, string>>;
+    /**
+     * Callback after route generated
+     */
+    routeGenerated?: (routes: RouteMeta[], isProd: boolean) => Promise<void> | void;
+    /**
+     * Add addition ssg routes, for dynamic routes.
+     */
+    addSSGRoutes?: (config: UserConfig, isProd: boolean) => {
+        path: string;
+    }[] | Promise<{
+        path: string;
+    }[]>;
+    /**
+     * @private
+     * Modify search index data.
+     */
+    modifySearchIndexData?: (data: PageIndexInfo[], isProd: boolean) => void | Promise<void>;
+}
+export { RspressPlugin as Plugin }
+export { RspressPlugin }
+
+export declare const SEARCH_INDEX_NAME = "search_index";
+
+export declare interface SearchHooks {
+    /**
+     * The search hook function path. The corresponding file should export a function named `onSearch`.
+     */
+    searchHooks?: string;
+}
+
+export declare type SearchOptions = LocalSearchOptions | RemoteSearchOptions | false;
+
+export declare interface Sidebar {
+    [path: string]: (SidebarGroup | SidebarItem | SidebarDivider | SidebarSectionHeader)[];
+}
+
+export declare type SidebarDivider = {
+    dividerType: 'dashed' | 'solid';
+};
+
+export declare interface SidebarGroup {
+    text: string;
+    link?: string;
+    tag?: string;
+    items: (SidebarItem | SidebarDivider | SidebarGroup | string)[];
+    collapsible?: boolean;
+    collapsed?: boolean;
+    /**
+     * For hmr usage in development
+     */
+    _fileKey?: string;
+    overviewHeaders?: number[];
+    context?: string;
+}
+
+export declare type SidebarItem = {
+    text: string;
+    link: string;
+    tag?: string;
+    /**
+     * For hmr usage in development
+     */
+    _fileKey?: string;
+    overviewHeaders?: number[];
+    context?: string;
+};
+
+export declare type SidebarSectionHeader = {
+    sectionHeaderText: string;
+    tag?: string;
+};
+
+export declare interface SiteData<ThemeConfig = NormalizedConfig> {
+    root: string;
+    base: string;
+    lang: string;
+    route: RouteOptions;
+    locales: {
+        lang: string;
+        label: string;
+    }[];
+    title: string;
+    description: string;
+    icon: string;
+    themeConfig: ThemeConfig;
+    logo: string | {
+        dark: string;
+        light: string;
+    };
+    logoText: string;
+    pages: BaseRuntimePageInfo[];
+    search: SearchOptions;
+    ssg: boolean;
+    markdown: {
+        showLineNumbers: boolean;
+        defaultWrapCode: boolean;
+        codeHighlighter: 'prism' | 'shiki';
+    };
+    multiVersion: {
+        default: string;
+        versions: string[];
+    };
+}
+
+export declare function slash(str: string): string;
+
+export declare interface SocialLink {
+    icon: SocialLinkIcon;
+    mode: 'link' | 'text' | 'img' | 'dom';
+    content: string;
+}
+
+export declare type SocialLinkIcon = 'lark' | 'discord' | 'facebook' | 'github' | 'instagram' | 'linkedin' | 'slack' | 'x' | 'youtube' | 'wechat' | 'qq' | 'juejin' | 'zhihu' | 'bilibili' | 'weibo' | 'gitlab' | 'X' | 'bluesky' | {
+    svg: string;
+};
+
+export declare type SSGConfig = boolean | {
+    strict?: boolean;
+};
+
+export declare interface UserConfig<ThemeConfig = DefaultThemeConfig> {
+    /**
+     * The root directory of the site.
+     * @default 'docs'
+     */
+    root?: string;
+    /**
+     * Path to the logo file in nav bar.
+     */
+    logo?: string | {
+        dark: string;
+        light: string;
+    };
+    /**
+     * The text of the logo in nav bar.
+     * @default ''
+     */
+    logoText?: string;
+    /**
+     * Base path of the site.
+     * @default '/'
+     */
+    base?: string;
+    /**
+     * Path to html icon file.
+     */
+    icon?: string;
+    /**
+     * Default language of the site.
+     */
+    lang?: string;
+    /**
+     * Title of the site.
+     * @default 'Rspress'
+     */
+    title?: string;
+    /**
+     * Description of the site.
+     * @default ''
+     */
+    description?: string;
+    /**
+     * Head tags.
+     */
+    head?: (string | [string, Record<string, string>] | ((route: RouteMeta) => string | [string, Record<string, string>] | undefined))[];
+    /**
+     * I18n config of the site.
+     */
+    locales?: Locale[];
+    /**
+     * The i18n text data source path. Default is `i18n.json` in cwd.
+     */
+    i18nSourcePath?: string;
+    /**
+     * Theme config.
+     */
+    themeConfig?: ThemeConfig;
+    /**
+     * Rsbuild Configuration
+     */
+    builderConfig?: RsbuildConfig;
+    /**
+     * The custom config of vite-plugin-route
+     */
+    route?: RouteOptions;
+    /**
+     * The custom config of markdown compile
+     */
+    markdown?: MarkdownOptions;
+    /**
+     * Doc plugins
+     */
+    plugins?: RspressPlugin[];
+    /**
+     * Replace rule, will replace the content of the page.
+     */
+    replaceRules?: ReplaceRule[];
+    /**
+     * Output directory
+     */
+    outDir?: string;
+    /**
+     * Custom theme directory
+     */
+    themeDir?: string;
+    /**
+     * Global components
+     */
+    globalUIComponents?: (string | [string, object])[];
+    /**
+     * Global styles, is a Absolute path
+     */
+    globalStyles?: string;
+    /**
+     * Search options
+     */
+    search?: SearchOptions;
+    /**
+     * Whether to enable ssg, default is true
+     */
+    ssg?: SSGConfig;
+    /**
+     * Whether to enable medium-zoom, default is true
+     */
+    mediumZoom?: boolean | {
+        selector?: string;
+        options?: ZoomOptions;
+    };
+    /**
+     * Add some extra builder plugins
+     */
+    builderPlugins?: RsbuildPlugin[];
+    /**
+     * Multi version config
+     */
+    multiVersion?: {
+        /**
+         * The default version
+         */
+        default?: string;
+        /**
+         * The version list, such as ['v1', 'v2']
+         */
+        versions: string[];
+    };
+    /**
+     * Language parity checking config
+     */
+    languageParity?: {
+        /**
+         * Whether to enable language parity checking
+         */
+        enabled?: boolean;
+        /**
+         * Directories to include in the parity check
+         */
+        include?: string[];
+        /**
+         * Directories to exclude from the parity check
+         */
+        exclude?: string[];
+    };
+}
+
+export declare function withBase(url: string, base: string): string;
+
+export declare function withoutBase(path: string, base: string): string;
+
+export declare function withoutLang(path: string, langs: string[]): string;
+
+declare interface ZoomContainer {
+    width?: number
+    height?: number
+    top?: number
+    bottom?: number
+    right?: number
+    left?: number
+}
+
+declare interface ZoomOptions {
+    /**
+     * The space outside the zoomed image.
+     *
+     * @default 0
+     */
+    margin?: number
+
+    /**
+     * The background of the overlay.
+     *
+     * @default '#fff'
+     */
+    background?: string
+
+    /**
+     * The number of pixels to scroll to close the zoom.
+     *
+     * @default 40
+     */
+    scrollOffset?: number
+
+    /**
+     * The viewport to render the zoom in.
+     *
+     * @default null
+     */
+    container?: string | HTMLElement | ZoomContainer
+
+    /**
+     * The template element to display on zoom.
+     *
+     * @default null
+     */
+    template?: string | HTMLTemplateElement
+}
+
+export { }