@xyd-js/core 0.1.0-xyd.4 → 0.1.0-xyd.54

package/dist/index.d.ts

@@ -1,186 +1,1029 @@
-import React from 'react';
+import * as React from 'react';
 
-interface FrontMatter {
-    title: string | {
+/**
+ * @todo rename to PageMeta
+ *
+ * Represents metadata for a content page.
+ * Usually used as md/mdx frontmatter.
+ *
+ */
+interface Metadata<P = void> {
+    /** The main title of the content - by default visible in navigation and page title */
+    title: string;
+    /** Title to display in the sidebar navigation */
+    sidebarTitle?: string;
+    /** Disply description for SEO purposes */
+    description?: string;
+    /**  Icon identifier for the navigation item */
+    icon?: string;
+    /** Layout type for the content display */
+    layout?: PageLayout;
+    /** Max depth for table of contents */
+    maxTocDepth?: number;
+    /**
+     * @internal
+     *
+     * The type of component to render this content with
+     */
+    component?: "docs" | "atlas" | "page";
+    /**
+     * @internal
+     *
+     * Properties specific to the component type
+     */
+    componentProps?: P;
+    /**
+     * @internal
+     *
+     * Group for sidebar navigation
+    */
+    group?: string[];
+    /**
+     * Uniform for API Docs references
+     */
+    uniform?: PageMetaUniform;
+    /**
+     * @internal
+     *
+     * used for graphql references
+     */
+    graphql?: string;
+    /**
+     * @internal
+     *
+     * used for openapi references
+     */
+    openapi?: string;
+    /**
+     * If true, hide from navigation
+     */
+    hidden?: boolean;
+    /**
+     * @todo: !!! IN THE FUTURE COMPOSE API !!!
+     *
+     * Optional 'tocCard' for github references
+     *
+     * @example
+     * ```
+     * tocCard: {
+     *     link: "https://github.com/livesession/livesession-browser",
+     *     title: "Checkout the code",
+     *     description: "Check how to use the LiveSession Browser SDK",
+     *     icon: "github"
+     * }
+     * ```
+     */
+    tocCard?: {
+        /** 'link' to the card */
+        link: string;
+        /** 'title' of the card */
         title: string;
-        code: string;
+        /** 'description' of the card */
+        description: string;
+        /** 'icon' of the card */
+        icon?: string;
     };
-    group?: string[];
 }
-type PageFrontMatter = {
-    [page: string]: FrontMatter;
+type PageMetaUniform = string | PageMetaUniformDetails;
+/**
+ * Uniform details allows to specify more options than just the path, for example eager loading
+ */
+type PageMetaUniformDetails = {
+    /**
+     * Path to the uniform file / url
+     */
+    path: string;
+    /**
+     * If true, the uniform will be eagerly loaded
+     */
+    eager?: boolean;
+};
+type MetadataMap<P = void> = {
+    [page: string]: Metadata<P>;
+};
+type PageLayout = "wide" | "page" | "center";
+
+/**
+ * Interface representing all possible meta tags that can be used in HTML documents.
+ * This includes standard meta tags, Open Graph tags, Twitter cards, and various other
+ * specialized meta tags for different content types.
+ *
+ */
+interface MetaTags {
+    /** Standard meta tag for controlling search engine crawling and indexing
+     * @example "noindex"
+     */
+    robots: string;
+    /** Character encoding for the document
+     * @example "UTF-8"
+     */
+    charset: string;
+    /** Viewport settings for responsive design
+     * @example "width=device-width, initial-scale=1, maximum-scale=1"
+     */
+    viewport: string;
+    /** Brief description of the page content
+     * @example "Your page description"
+     */
+    description: string;
+    /** Keywords relevant to the page content
+     * @example "keyword, keyword2"
+     */
+    keywords: string;
+    /** Author of the page content
+     * @example "Author Name"
+     */
+    author: string;
+    /** Google-specific crawling instructions
+     * @example "index, follow"
+     */
+    googlebot: string;
+    /** Google-specific settings
+     * @example "notranslate"
+     */
+    google: string;
+    /** Google Search Console verification token
+     * @example "verification_token"
+     */
+    "google-site-verification": string;
+    /** Software used to generate the page
+     * @example "xyd"
+     */
+    generator: string;
+    /** Theme color for browser UI
+     * @example "#ffffff"
+     */
+    "theme-color": string;
+    /** Color scheme preference
+     * @example "light"
+     */
+    "color-scheme": string;
+    /** Format detection settings
+     * @example "telephone=no"
+     */
+    "format-detection": string;
+    /** Referrer policy
+     * @example "origin"
+     */
+    referrer: string;
+    /** Page refresh settings
+     * @example "0;url=https://example.com"
+     */
+    refresh: string;
+    /** Content rating
+     * @example "general"
+     */
+    rating: string;
+    /** Crawl frequency suggestion
+     * @example "7 days"
+     */
+    "revisit-after": string;
+    /** Page language
+     * @example "en-US"
+     */
+    language: string;
+    /** Copyright information
+     * @example "Copyright 2024"
+     */
+    copyright: string;
+    /** Reply-to email address
+     * @example "contact@example.com"
+     */
+    "reply-to": string;
+    /** Content distribution scope
+     * @example "global"
+     */
+    distribution: string;
+    /** Content coverage area
+     * @example "Worldwide"
+     */
+    coverage: string;
+    /** Content category
+     * @example "Technology"
+     */
+    category: string;
+    /** Target audience
+     * @example "all"
+     */
+    target: string;
+    /** Mobile device compatibility
+     * @example "true"
+     */
+    HandheldFriendly: string;
+    /** Mobile optimization settings
+     * @example "width"
+     */
+    MobileOptimized: string;
+    /** iOS web app capability
+     * @example "yes"
+     */
+    "apple-mobile-web-app-capable": string;
+    /** iOS status bar style
+     * @example "black"
+     */
+    "apple-mobile-web-app-status-bar-style": string;
+    /** iOS web app title
+     * @example "App Name"
+     */
+    "apple-mobile-web-app-title": string;
+    /** Web application name
+     * @example "My App"
+     */
+    "application-name": string;
+    /** Windows tile color
+     * @example "#2b5797"
+     */
+    "msapplication-TileColor": string;
+    /** Windows tile image
+     * @example "/mstile-144x144.png"a
+     */
+    "msapplication-TileImage": string;
+    /** Windows browser config
+     * @example "/browserconfig.xml"
+     */
+    "msapplication-config": string;
+    /** Open Graph title
+     * @example "Page Title"
+     */
+    "og:title": string;
+    /** Open Graph content type
+     * @example "website"
+     */
+    "og:type": string;
+    /** Open Graph URL
+     * @example "https://example.com"
+     */
+    "og:url": string;
+    /** Open Graph image
+     * @example "https://example.com/image.jpg"
+     */
+    "og:image": string;
+    /** Open Graph description
+     * @example "A brief description for social media"
+     */
+    "og:description": string;
+    /** Open Graph site name
+     * @example "Site Name"
+     */
+    "og:site_name": string;
+    /** Open Graph locale
+     * @example "en_US"
+     */
+    "og:locale": string;
+    /** Open Graph video
+     * @example "https://example.com/video.mp4"
+     */
+    "og:video": string;
+    /** Open Graph audio
+     * @example "https://example.com/audio.mp3"
+     */
+    "og:audio": string;
+    /** Twitter card type
+     * @example "summary"
+     */
+    "twitter:card": string;
+    /** Twitter site handle
+     * @example "@username"
+     */
+    "twitter:site": string;
+    /** Twitter creator handle
+     * @example "@author"
+     */
+    "twitter:creator": string;
+    /** Twitter title
+     * @example "Page Title"
+     */
+    "twitter:title": string;
+    /** Twitter description
+     * @example "A brief description for Twitter"
+     */
+    "twitter:description": string;
+    /** Twitter image
+     * @example "https://example.com/image.jpg"
+     */
+    "twitter:image": string;
+    /** Twitter image alt text
+     * @example "Image description"
+     */
+    "twitter:image:alt": string;
+    /** Twitter player URL
+     * @example "https://example.com/player"
+     */
+    "twitter:player": string;
+    /** Twitter player width
+     * @example "480"
+     */
+    "twitter:player:width": string;
+    /** Twitter player height
+     * @example "480"
+     */
+    "twitter:player:height": string;
+    /** Twitter iOS app name
+     * @example "App Name"
+     */
+    "twitter:app:name:iphone": string;
+    /** Twitter iOS app ID
+     * @example "123456789"
+     */
+    "twitter:app:id:iphone": string;
+    /** Twitter iOS app URL
+     * @example "app://"
+     */
+    "twitter:app:url:iphone": string;
+    /** Article publication time
+     * @example "2024-03-20T12:00:00Z"
+     */
+    "article:published_time": string;
+    /** Article modification time
+     * @example "2024-03-21T15:30:00Z"
+     */
+    "article:modified_time": string;
+    /** Article expiration time
+     * @example "2024-04-20T12:00:00Z"
+     */
+    "article:expiration_time": string;
+    /** Article author
+     * @example "John Doe"
+     */
+    "article:author": string;
+    /** Article section
+     * @example "Technology"
+     */
+    "article:section": string;
+    /** Article tags
+     * @example "Web Development"
+     */
+    "article:tag": string;
+    /** Book author
+     * @example "Jane Smith"
+     */
+    "book:author": string;
+    /** Book ISBN
+     * @example "978-3-16-148410-0"
+     */
+    "book:isbn": string;
+    /** Book release date
+     * @example "2024-01-01"
+     */
+    "book:release_date": string;
+    /** Book tags
+     * @example "Fiction"
+     */
+    "book:tag": string;
+    /** Profile first name
+     * @example "John"
+     */
+    "profile:first_name": string;
+    /** Profile last name
+     * @example "Doe"
+     */
+    "profile:last_name": string;
+    /** Profile username
+     * @example "johndoe"
+     */
+    "profile:username": string;
+    /** Profile gender
+     * @example "male"
+     */
+    "profile:gender": string;
+    /** Music duration in seconds
+     * @example "180"
+     */
+    "music:duration": string;
+    /** Music album name
+     * @example "Album Name"
+     */
+    "music:album": string;
+    /** Music album disc number
+     * @example "1"
+     */
+    "music:album:disc": string;
+    /** Music album track number
+     * @example "1"
+     */
+    "music:album:track": string;
+    /** Music musician/artist
+     * @example "Artist Name"
+     */
+    "music:musician": string;
+    /** Music song name
+     * @example "Song Name"
+     */
+    "music:song": string;
+    /** Music song disc number
+     * @example "1"
+     */
+    "music:song:disc": string;
+    /** Music song track number
+     * @example "1"
+     */
+    "music:song:track": string;
+    /** Video actor name
+     * @example "Actor Name"
+     */
+    "video:actor": string;
+    /** Video actor role
+     * @example "Character Name"
+     */
+    "video:actor:role": string;
+    /** Video director
+     * @example "Director Name"
+     */
+    "video:director": string;
+    /** Video writer
+     * @example "Writer Name"
+     */
+    "video:writer": string;
+    /** Video duration in seconds
+     * @example "120"
+     */
+    "video:duration": string;
+    /** Video release date
+     * @example "2024-01-01"
+     */
+    "video:release_date": string;
+    /** Video tags
+     * @example "Action"
+     */
+    "video:tag": string;
+    /** Video series name
+     * @example "Series Name"
+     */
+    "video:series": string;
+}
+
+type RawTheme = {
+    name?: string;
+    type?: string;
+    tokenColors?: ThemeSetting[];
+    colors?: {
+        [key: string]: string;
+    };
+    [key: string]: any;
+};
+type ThemeSetting = {
+    name?: string;
+    scope?: string | string[];
+    settings: {
+        fontStyle?: string;
+        foreground?: string;
+        background?: string;
+    };
 };
+declare const THEME_NAMES: readonly ["dark-plus", "dracula-soft", "dracula", "github-dark", "github-dark-dimmed", "github-from-css", "github-light", "light-plus", "material-darker", "material-default", "material-from-css", "material-lighter", "material-ocean", "material-palenight", "min-dark", "min-light", "monokai", "nord", "one-dark-pro", "poimandres", "slack-dark", "slack-ochin", "solarized-dark", "solarized-light"];
+type NamesTuple$1 = typeof THEME_NAMES;
+type StringTheme = NamesTuple$1[number];
+type Theme$1 = StringTheme | RawTheme;
 
+/**
+ * Main settings interface for the application
+ */
 interface Settings {
-    styling?: Styling;
-    structure?: Structure;
+    /** Theme configuration for the application */
+    theme?: Theme;
+    /** Navigation configuration */
+    navigation?: Navigation;
+    /** API configuration */
     api?: API;
+    /** Integrations configuration */
     integrations?: Integrations;
+    /** Plugins configuration */
+    plugins?: Plugins;
+    /**
+     * @internal
+     *
+     * Redirects configuration
+     */
     redirects?: Redirects[];
+    /**
+     * SEO configuration
+     */
     seo?: SEO;
+    /** Engine configuration */
+    engine?: Engine;
 }
-interface Styling {
-    name: string;
+/**
+ * Theme configuration that changes the look and feel of the project
+ */
+interface Theme {
+    /**
+     * A preset theme configuration that changes the look and feel of the project.
+     * A theme is a set of default styling configurations.
+     *
+     * Example built-in themes: `cosmo`, `gusto`, `poetry`, `picasso`
+     */
+    readonly name: ThemePresetName | (string & {});
+    /**
+     * The default color scheme to use.
+     */
+    defaultColorScheme?: "light" | "dark" | "os";
+    /**
+     * Path to logo image or object with path to "light" and "dark" mode logo images, and where the logo links to.
+     * SVG format is recommended as it does not pixelate and the file size is generally smaller.
+     */
     logo?: string | Logo | React.JSX.Element;
+    /**
+     * Coder configuration for the theme, including options like syntax highlighting.
+     */
+    coder?: Coder;
+    /**
+     * Banner configuration for the theme.
+     */
+    banner?: Banner;
+    /** Path to the favicon image. For example: /path/to/favicon.svg */
     favicon?: string;
-    colors?: Colors;
-    theme?: ThemeType;
-    layout?: LayoutType;
-    background?: Background;
-    backgroundImage?: string;
-    font?: FontDetailsType | {
-        headings?: FontDetailsType;
-        body?: FontDetailsType;
-    };
-    modeToggle?: ModeToggle;
-    sidebar?: StyleSidebar;
-    topbar?: Topbar;
-    search?: SearchType;
-    rounded?: Rounded;
+    /** The defult level of the table of contents. */
+    maxTocDepth?: number;
+    /** Head configuration */
+    head?: HeadConfig[];
+    /** The iconify library */
+    icons?: Icons;
+    /**
+     * Custom scripts to be added to the head of the every page.
+     * Paths are relative to the root of the project or absolute.
+     */
+    scripts?: Script[];
 }
+/**
+ * Coder configuration for the theme, including options like syntax highlighting.
+ */
+interface Coder {
+    /**
+     * If `true` then code blocks will have line numbers.
+     */
+    lines?: boolean;
+    /**
+     * If `true` then code blocks will have a scrollbar.
+     */
+    scroll?: boolean;
+    /**
+     * Syntax highlighting configuration.
+     */
+    syntaxHighlight?: Theme$1;
+}
+/**
+ * Configuration type for head elements that can be added to the HTML head.
+ * Format: [tagName, attributes]
+ *
+ * @example: ['script', { src: 'https://example.com/script.js', defer: true }]
+ */
+type HeadConfig = [string, Record<string, string | boolean>];
+type Script = string;
+/**
+ * Logo configuration interface
+ */
 interface Logo {
+    /** Path to the logo in light mode. For example: `/path/to/logo.svg` */
     light?: string;
+    /** Path to the logo in dark mode. For example: `/path/to/logo.svg` */
     dark?: string;
+    /** Where clicking on the logo links you to */
     href?: string;
 }
-interface Colors {
-    primary: string;
-    light?: string;
-    dark?: string;
-    background?: {
-        light: string;
-        dark: string;
-    };
-}
-interface Background {
-    style?: "gradient" | "grid" | "windows";
-}
-interface FontDetailsType {
-    family: string;
-    weight?: number;
-    url?: string;
-    format?: "woff" | "woff2";
-}
-interface ModeToggle {
-    default?: "light" | "dark";
-    isHidden?: boolean;
+/**
+ * Banner configuration interface
+ */
+interface Banner {
+    /**
+     * Banner content.
+     */
+    content: string | React.JSX.Element;
+    /**
+     * Banner label.
+     */
+    label?: string;
+    /**
+     * Banner kind.
+     */
+    kind?: "secondary";
+    /**
+     * Banner icon.
+     */
+    icon?: string;
 }
-interface StyleSidebar {
-    items: "container" | "card" | "border" | "undecorated";
+interface IconLibrary {
+    /** The iconify library name */
+    name: string;
+    /** The iconify library version */
+    version?: string;
+    /** The default iconify icon name */
+    default?: boolean;
+    /** Merge icons from the library into the default iconify library */
+    noprefix?: boolean;
 }
-interface Topbar {
-    style: "default" | "gradient";
+interface Icons {
+    /** The iconify library */
+    library?: string | string[] | IconLibrary | IconLibrary[];
 }
-type ThemeType = "gusto" | "poetry" | "plato" | "picasso";
-type LayoutType = "app" | "default";
+/** Available theme preset names */
+type ThemePresetName = "poetry" | "cosmo" | "opener" | "picasso";
+/** Search bar location options */
 type SearchType = "side" | "top";
-type Rounded = "default" | "sharp";
-interface Structure {
-    sidebar: (SidebarMulti | Sidebar)[];
+/**
+ * Navigation configuration interface
+ */
+interface Navigation {
+    /** Definition of sidebar - an array of groups with all the pages within that group */
+    sidebar: SidebarNavigation;
+    /** Array of headers */
     header?: Header[];
-    topbarCtaButton?: CallToAction;
-    versions?: string[];
+    /** Array of segments */
+    segments?: Segment[];
+    /**
+     * Array of version names. Only use this if you want to show different versions of docs
+     * with a dropdown in the navigation bar.
+     */
+    /** Anchors, includes the icon, name, and url */
     anchors?: AnchorRoot;
-    footerSocials?: FooterSocials;
-    feedback?: Feedback;
-    search?: Search;
 }
-interface SidebarMulti {
-    match: string;
-    items: Sidebar[];
+/**
+ * Sidebar navigation type
+ */
+type SidebarNavigation = (SidebarRoute | Sidebar | string)[];
+/**
+ * Sidebar multi-group configuration
+ */
+interface SidebarRoute {
+    /** Route for this sidebar group */
+    route: string;
+    /** Sidebar pages within this group */
+    pages: Sidebar[];
 }
+/**
+ * Sidebar configuration
+ */
 interface Sidebar {
+    /** The name of the group */
     group?: string;
-    pages?: (string | Sidebar)[];
+    /**
+     * The relative paths to the markdown files that will serve as pages.
+     * Note: groups are recursive, so to add a sub-folder add another group object in the page array.
+     */
+    pages?: PageURL[];
+    /**
+     * The icon of the group.
+     */
     icon?: string;
-    iconType?: string;
-}
-interface SubHeader {
-    match: string;
-    name: string;
-    items: Header[];
+    /**
+     * The sort order of the group.
+     */
+    sort?: number;
 }
-interface Header {
-    name?: string;
-    url?: string;
-    sub?: SubHeader;
+/**
+ * Page URL type
+ */
+type PageURL = string | VirtualPage | Sidebar;
+/**
+ * @internal
+ *
+ * Virtual page type
+ *
+ * Virtual pages are composition of pages, needed for templating e.g in uniform
+ *
+ * Example:
+ *
+ * {
+ *  pages: [0
+ *    ".xyd/.cache/.content/docs/rest/todo:docs/rest/todo",
+ *  ]
+ * }
+ *
+ * above will be rendered as docs/rest/todo.md using composition from xyd's `.content`
+ */
+type VirtualPage = string | {
+    /** The virtual page to use for the page */
+    virtual: string;
+    /** The page to use for the page */
+    page: string;
+    /** The template to use for the page */
+    templates?: string | string[];
+};
+/**
+ * Segment configuration
+ */
+interface Segment {
+    /** Route for this segment */
+    route: string;
+    /** Title of this segment */
+    title: string;
+    /** Items within this segment */
+    pages: SegmentPage[];
 }
-interface CallToAction {
-    type?: "link" | "github";
-    url?: string;
-    name?: string;
-    style?: "pill" | "roundedRectangle";
-    arrow?: boolean;
+interface SegmentPage {
+    page: string;
+    title: string;
 }
+/**
+ * Header configuration
+ */
+type Header = {
+    /** The name of the button */
+    title?: string;
+    /** The url once you click on the button */
+    page?: string;
+    /** Float the header to the right */
+    float?: "right";
+};
+/**
+ * Anchor configuration
+ */
 interface Anchor {
-    icon?: string | React.JSX.Element;
+    /** The iconify icon name */
+    icon?: string;
+    /** The name of the anchor label */
     name?: string;
+    /**
+     * The start of the URL that marks what pages go in the anchor.
+     * Generally, this is the name of the folder you put your pages in.
+     */
     url?: string;
 }
+/**
+ * Anchor root configuration
+ */
 interface AnchorRoot {
-    bottom: Anchor[];
-}
-interface FooterSocials {
-    [key: string]: string;
-    property: string;
-}
-interface Feedback {
-    thumbsRating?: boolean;
-    suggestEdit?: boolean;
-    raiseIssue?: boolean;
+    /** Bottom anchors */
+    bottom?: Anchor[];
 }
-interface Search {
-    prompt?: string;
-}
-type APIFile = string | string[] | {
-    [id: string]: string;
-};
+/**
+ * API configuration interface
+ */
 interface API {
-    info?: APIInfo;
+    /**
+     * OpenAPI configuration
+     */
     openapi?: APIFile;
+    /**
+     * GraphQL configuration
+     */
     graphql?: APIFile;
-    match?: {
-        graphql?: string;
-        openapi?: string;
-    };
+    /**
+     * Sources configuration
+     */
+    sources?: APIFile;
 }
+/**
+ * API file configuration. Can be a path, an array of paths, a map of paths, or an advanced configuration
+ */
+type APIFile = string | string[] | APIFileMap | APIFileAdvanced;
+/**
+ * API file map type
+ */
+type APIFileMap = {
+    [name: string]: string | APIFileAdvanced;
+};
+/**
+ * API file advanced type
+ */
+type APIFileAdvanced = {
+    /** API information configuration */
+    info?: APIInfo;
+    /** Route configuration */
+    route: string;
+};
+/**
+ * API file type - can be a string, array of strings, or a map of strings
+ */
+/**
+ * API information configuration
+ */
 interface APIInfo {
+    /**
+     * The base url for all API endpoints. If baseUrl is an array, it will enable
+     * for multiple base url options that the user can toggle.
+     */
     baseUrl?: string;
+    /** Authentication information */
     auth?: APIAuth;
+    /**
+     * The name of the authentication parameter used in the API playground.
+     * If method is basic, the format should be [usernameName]:[passwordName]
+     */
     name?: string;
+    /**
+     * The default value that's designed to be a prefisx for the authentication input field.
+     * E.g. If an inputPrefix of AuthKey would inherit the default input result of the authentication field as AuthKey.
+     */
     inputPrefix?: string;
+    /** Configurations for the API playground */
     playground?: APIPlayground;
+    /** Request configuration */
     request?: APIInfoRequest;
-    paramFields?: ApiParamFields;
 }
+/**
+ * API authentication configuration
+ */
 interface APIAuth {
+    /** The authentication strategy used for all API endpoints */
     method: "bearer" | "basic" | "key";
 }
+/**
+ * API playground configuration
+ */
 interface APIPlayground {
+    /** Playground display mode */
     mode?: "show" | "simple" | "hide";
 }
+/**
+ * API request configuration
+ */
 interface APIInfoRequest {
+    /** Configurations for the auto-generated API request examples */
     example?: {
+        /**
+         * An array of strings that determine the order of the languages of the auto-generated request examples.
+         * You can either define custom languages utilizing x-codeSamples or use our default languages which include
+         * bash, python, javascript, php, go, java
+         */
         languages?: string[];
     };
 }
-interface ApiParamFields {
-    expanded: "all" | "topLevel" | "topLevelOneOfs" | "none";
-}
+/**
+ * Integrations configuration
+ */
 interface Integrations {
-    analytics?: Analytics;
+    /**
+     * Configurations to add third-party analytics integrations.
+     * See full list of supported analytics here.
+     */
+    analytics?: IntegrationAnalytics;
+    /**
+     * Configurations to add third-party search integrations.
+     * See full list of supported search here.
+     */
+    search?: IntegrationSearch;
+    apps?: IntegrationApps;
 }
-interface Analytics {
-    livesession: {
+/**
+ * Analytics configuration
+ */
+interface IntegrationAnalytics {
+    /** Livesession analytics configuration */
+    livesession?: {
+        /** Livesession's TrackID */
         trackId: string;
     };
 }
+/**
+ * Search configuration
+ */
+interface IntegrationSearch {
+    /** Algolia search configuration */
+    algolia?: {
+        /** Algolia application ID */
+        appId: string;
+        /** Algolia API key */
+        apiKey: string;
+    };
+    orama?: {
+        /** Orama endpoint */
+        endpoint: string;
+        /** Orama API key */
+        apiKey: string;
+        /** Orama suggestions */
+        suggestions?: string[];
+    } | boolean;
+}
+interface IntegrationApps {
+    /**
+     * Github star app configuration.
+     * List of all [options](https://github.com/buttons/react-github-btn).
+     */
+    githubStar?: IntegrationAppGithubStar;
+}
+interface IntegrationAppGithubStar {
+    /**
+     * The title of the Github button
+     */
+    title: string;
+    /**
+     * The label of the Github Button
+     */
+    label?: string;
+    /**
+     * The href of the Github project
+     */
+    href: string;
+    /**
+     * The data-show-count of the Github project
+     */
+    dataShowCount?: boolean;
+    /**
+     * The data-icon of the Github button
+     */
+    dataIcon?: string;
+    /**
+     * The data-size of the Github button
+     */
+    dataSize?: string;
+    /**
+     * The aria-label of the Github button
+     */
+    ariaLabel?: string;
+}
+/**
+ * Plugin configuration
+ *
+ * @example
+ * 1)
+ * {
+ *  plugins: [
+ *    "livesession",
+ *  ]
+ * }
+ *
+ * or 2)
+ * {
+ *  plugins: [
+ *    [
+ *      "livesession",
+ *      "accountID.websiteID",
+ *      {
+ *          keystrokes: true
+ *      }
+ *    ]
+ *  ]
+ * }
+ *
+ * @example [audience:dev]
+ * You can also use the type to define the plugin config in your code:
+ *
+ * const livesessionPlugin: PluginConfig<"livesession", [string, { keystrokes: boolean }]> = [
+ *    "livesession",
+ *    "accountID.websiteID",
+ *    {
+ *        keystrokes: true
+ *    }
+ * ]
+ */
+type Plugins = (string | PluginConfig)[];
+type PluginConfig<PluginName extends string = string, PluginArgs extends unknown[] = unknown[]> = [PluginName, ...PluginArgs];
+/**
+ * Redirects configuration
+ */
 interface Redirects {
+    /** Source path to redirect from */
     source: string;
+    /** Destination path to redirect to */
     destination: string;
 }
+/**
+ * SEO configuration
+ */
 interface SEO {
-    indexHiddenPages: boolean;
+    /**
+     * Domain name
+     */
+    domain?: string;
+    /**
+     * Meta tags
+     */
+    metatags?: {
+        [tag: string]: string;
+    };
 }
+/**
+ * Config configuration
+ */
+interface Engine {
+    /**
+     * Path aliases for imports. Avoid long relative paths by creating shortcuts.
+     *
+     * @example
+     * ```json
+     * {
+     *   "paths": {
+     *     "@my-package/*": ["../my-package/src/*"],
+     *     "@livesession-go/*": ["https://github.com/livesession/livesession-go/*"]
+     *   }
+     * }
+     * ```
+     *
+     * Usage:
+     * ```typescript
+     * // Instead of
+     * @importCode("../../../my-package/src/components/Badge.tsx")
+     *
+     * // Use
+     * @importCode("@my-package/src/components/Badge.tsx")
+     * ```
+     */
+    paths?: EnginePaths;
+    /**
+     *
+     * Uniform configuration
+     *
+     */
+    uniform?: EngineUniform;
+}
+type EnginePaths = {
+    [key: string]: string[];
+};
+type EngineUniform = {
+    /**
+     * If `true` then virtual pages will not created and generated content will be stored on disk
+     */
+    store?: boolean;
+};
 
-export type { API, APIAuth, APIFile, APIInfo, APIInfoRequest, APIPlayground, Analytics, Anchor, AnchorRoot, ApiParamFields, Background, CallToAction, Colors, Feedback, FontDetailsType, FooterSocials, FrontMatter, Header, Integrations, LayoutType, Logo, ModeToggle, PageFrontMatter, Redirects, Rounded, SEO, Search, SearchType, Settings, Sidebar, SidebarMulti, Structure, StyleSidebar, Styling, SubHeader, ThemeType, Topbar };
+export type { API, APIAuth, APIFile, APIFileAdvanced, APIFileMap, APIInfo, APIInfoRequest, APIPlayground, Anchor, AnchorRoot, Banner, Coder, Engine, EnginePaths, EngineUniform, HeadConfig, Header, IconLibrary, Icons, IntegrationAnalytics, IntegrationAppGithubStar, IntegrationApps, IntegrationSearch, Integrations, Logo, MetaTags, Metadata, MetadataMap, Navigation, PageLayout, PageMetaUniform, PageMetaUniformDetails, PageURL, PluginConfig, Plugins, Redirects, SEO, Script, SearchType, Segment, SegmentPage, Settings, Sidebar, SidebarNavigation, SidebarRoute, Theme, ThemePresetName, VirtualPage };