@rspress/plugin-algolia 1.42.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-present Bytedance, Inc. and its affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @rspress/plugin-algolia
+
+[Algolia](https://www.algolia.com/)

package/dist/index.d.ts

@@ -0,0 +1,751 @@
+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.
+ */
+declare interface AdditionalPage {
+    routePath: string;
+    content?: string;
+    filepath?: string;
+}
+
+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;
+}
+
+declare interface DocFooter {
+    /**
+     * Custom label for previous page button.
+     */
+    prev?: SidebarItem;
+    /**
+     * Custom label for next page button.
+     */
+    next?: SidebarItem;
+}
+
+declare interface EditLink {
+    /**
+     * Custom repository url for edit link.
+     */
+    docRepoBaseUrl: string;
+    /**
+     * Custom text for edit link.
+     *
+     * @default 'Edit this page'
+     */
+    text?: string;
+}
+
+declare interface Feature {
+    icon: string;
+    title: string;
+    details: string;
+    span?: number;
+    link?: string;
+}
+
+/**
+ * The config of filter component
+ */
+declare interface FilterConfig {
+    filterNameText?: string;
+    filterPlaceholderText?: string;
+    filterNoResultText?: string;
+}
+
+declare interface Footer {
+    message?: string;
+}
+
+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;
+}
+
+declare interface Header {
+    id: string;
+    text: string;
+    depth: number;
+    charIndex: number;
+}
+
+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 interface Locale {
+    lang: string;
+    label: string;
+    title?: string;
+    description?: string;
+}
+
+/**
+ * locale config
+ */
+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;
+}
+
+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;
+};
+
+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;
+}
+
+declare interface MdxRsOptions {
+    /**
+     * Determine whether the file use mdxRs compiler
+     */
+    include?: (filepath: string) => boolean;
+}
+
+declare type Nav = NavItem[] | {
+    [key: string]: NavItem[];
+};
+
+declare type NavItem = NavItemWithLink | NavItemWithChildren | NavItemWithLinkAndChildren;
+
+declare interface NavItemWithChildren {
+    text?: string;
+    tag?: string;
+    items: NavItemWithLink[];
+    position?: 'left' | 'right';
+}
+
+declare type NavItemWithLink = {
+    text: string;
+    link: string;
+    tag?: string;
+    activeMatch?: string;
+    position?: 'left' | 'right';
+};
+
+declare interface NavItemWithLinkAndChildren {
+    text: string;
+    link: string;
+    items: NavItemWithLink[];
+    tag?: string;
+    activeMatch?: string;
+    position?: 'left' | 'right';
+}
+
+declare interface Options {
+    selector?: string;
+}
+
+/**
+ * @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).
+ */
+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;
+}
+
+declare type PageType = 'home' | 'doc' | 'custom' | '404' | 'blank';
+
+export declare function pluginAlgolia(options?: Options): RspressPlugin;
+
+declare type RemoteSearchIndexInfo = string | {
+    value: string;
+    label: string;
+};
+
+declare type RemoteSearchOptions = SearchHooks & {
+    mode: 'remote';
+    apiUrl: string;
+    domain?: string;
+    indexName: string;
+    searchIndexes?: RemoteSearchIndexInfo[];
+    searchLoading?: boolean;
+};
+
+declare interface ReplaceRule {
+    search: string | RegExp;
+    replace: string;
+}
+
+declare interface RouteMeta {
+    routePath: string;
+    absolutePath: string;
+    relativePath: string;
+    pageName: string;
+    lang: string;
+    version: string;
+}
+
+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;
+}
+
+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>;
+}
+
+declare interface SearchHooks {
+    /**
+     * The search hook function path. The corresponding file should export a function named `onSearch`.
+     */
+    searchHooks?: string;
+}
+
+declare type SearchOptions = LocalSearchOptions | RemoteSearchOptions | false;
+
+declare interface Sidebar {
+    [path: string]: (SidebarGroup | SidebarItem | SidebarDivider | SidebarSectionHeader)[];
+}
+
+declare type SidebarDivider = {
+    dividerType: 'dashed' | 'solid';
+};
+
+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;
+}
+
+declare type SidebarItem = {
+    text: string;
+    link: string;
+    tag?: string;
+    /**
+     * For hmr usage in development
+     */
+    _fileKey?: string;
+    overviewHeaders?: number[];
+    context?: string;
+};
+
+declare type SidebarSectionHeader = {
+    sectionHeaderText: string;
+    tag?: string;
+};
+
+declare interface SocialLink {
+    icon: SocialLinkIcon;
+    mode: 'link' | 'text' | 'img' | 'dom';
+    content: string;
+}
+
+declare type SocialLinkIcon = 'lark' | 'discord' | 'facebook' | 'github' | 'instagram' | 'linkedin' | 'slack' | 'x' | 'youtube' | 'wechat' | 'qq' | 'juejin' | 'zhihu' | 'bilibili' | 'weibo' | 'gitlab' | 'X' | 'bluesky' | {
+    svg: string;
+};
+
+declare type SSGConfig = boolean | {
+    strict?: boolean;
+};
+
+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[];
+    };
+}
+
+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 { }

package/dist/index.js

@@ -0,0 +1,16 @@
+function pluginAlgolia(options = {}) {
+    return {
+        name: '@rspress/plugin-algolia',
+        builderConfig: {
+            html: {
+                meta: {
+                    'algolia-site-verification': {
+                        name: 'algolia-site-verification',
+                        content: '0F854AB11EB1D255'
+                    }
+                }
+            }
+        }
+    };
+}
+export { pluginAlgolia };

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@rspress/plugin-algolia",
+  "version": "1.42.1",
+  "description": "A plugin for rspress to search with algolia in docs.",
+  "bugs": "https://github.com/web-infra-dev/rspress/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/web-infra-dev/rspress",
+    "directory": "packages/plugin-algolia"
+  },
+  "license": "MIT",
+  "sideEffects": [
+    "*.css",
+    "*.less",
+    "*.sass",
+    "*.scss"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "static"
+  ],
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.51.1",
+    "@rslib/core": "0.5.3",
+    "@types/node": "^18.11.17",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "react": "^18.3.1",
+    "typescript": "^5.5.3",
+    "@rspress/config": "1.0.0",
+    "@rspress/shared": "2.0.0-alpha.0"
+  },
+  "peerDependencies": {
+    "@rspress/runtime": "^1.42.1"
+  },
+  "engines": {
+    "node": ">=14.17.6"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "rslib build",
+    "dev": "rslib build -w",
+    "reset": "rimraf ./**/node_modules"
+  }
+}