import { VFileWithOutput, Plugin } from 'unified';
import { Root } from 'mdast';
import { ExpressiveCodeConfig, ExpressiveCodeBlockOptions, ExpressiveCodeBlock, BundledShikiTheme, ExpressiveCodeTheme, ExpressiveCodeThemeInput, ExpressiveCode } from 'expressive-code';
export * from 'expressive-code';

type RemarkExpressiveCodeOptions = Omit<ExpressiveCodeConfig, 'themes'> & {
    /**
     * The color themes that should be available for your code blocks.
     *
     * CSS variables will be generated for all themes, allowing to select the theme to display
     * using CSS. If you specify one dark and one light theme, a `prefers-color-scheme` media query
     * will also be generated by default. You can customize this to match your site's needs
     * through the `useDarkModeMediaQuery` and `themeCssSelector` options.
     *
     * The following item types are supported in this array:
     * - any theme name bundled with Shiki (e.g. `dracula`)
     * - any theme object compatible with VS Code or Shiki (e.g. imported from an NPM theme package)
     * - any ExpressiveCodeTheme instance (e.g. using `ExpressiveCodeTheme.fromJSONString(...)`
     *   to load a custom JSON/JSONC theme file yourself)
     *
     * Defaults to `['github-dark', 'github-light']`, two themes bundled with Shiki.
     */
    themes?: ThemeObjectOrShikiThemeName[] | undefined;
    /**
     * The number of spaces that should be used to render tabs. Defaults to 2.
     *
     * Any tabs found in code blocks in your markdown/MDX documents will be replaced
     * with the specified number of spaces. This ensures that the code blocks are
     * rendered consistently across browsers and platforms.
     *
     * If you want to preserve tabs in your code blocks, set this option to 0.
     */
    tabWidth?: number | undefined;
    /**
     * This optional function provides support for multi-language sites by allowing you
     * to customize the locale used for a given code block.
     *
     * If the function returns `undefined`, the default locale provided in the
     * Expressive Code configuration is used.
     */
    getBlockLocale?: (({ input, file }: {
        input: ExpressiveCodeBlockOptions;
        file: VFileWithOutput<null>;
    }) => string | undefined | Promise<string | undefined>) | undefined;
    /**
     * This optional function allows you to customize how `ExpressiveCodeBlock`
     * instances are created from code blocks found in the Markdown document.
     *
     * The function is called with an object containing the following properties:
     * - `input`: Block data for the `ExpressiveCodeBlock` constructor.
     * - `file`: A `VFile` instance representing the Markdown document.
     *
     * The function is expected to return an `ExpressiveCodeBlock` instance
     * or a promise resolving to one.
     */
    customCreateBlock?: (({ input, file }: {
        input: ExpressiveCodeBlockOptions;
        file: VFileWithOutput<null>;
    }) => ExpressiveCodeBlock | Promise<ExpressiveCodeBlock>) | undefined;
    /**
     * This advanced option allows you to influence the rendering process by creating
     * your own `ExpressiveCode` instance or processing the base styles and JS modules
     * added to every page.
     *
     * The return value will be cached and used for all code blocks on the site.
     */
    customCreateRenderer?: ((options: RemarkExpressiveCodeOptions) => Promise<RemarkExpressiveCodeRenderer> | RemarkExpressiveCodeRenderer) | undefined;
};
type ThemeObjectOrShikiThemeName = BundledShikiTheme | ExpressiveCodeTheme | ExpressiveCodeThemeInput;
type RemarkExpressiveCodeDocument = {
    /**
     * The full path to the source file containing the code block.
     */
    sourceFilePath?: string | undefined;
};
type RemarkExpressiveCodeRenderer = {
    ec: ExpressiveCode;
    baseStyles: string;
    themeStyles: string;
    jsModules: string[];
};
/**
 * Creates an `ExpressiveCode` instance using the given `options`,
 * including support to load themes bundled with Shiki by name.
 *
 * Returns the created `ExpressiveCode` instance together with the base styles and JS modules
 * that should be added to every page.
 */
declare function createRenderer(options?: RemarkExpressiveCodeOptions): Promise<RemarkExpressiveCodeRenderer>;
/**
 * @deprecated Please update your project to use the new package `rehype-expressive-code`,
 * which includes performance improvements and also works with current popular site generators.
 */
declare const remarkExpressiveCode: Plugin<[RemarkExpressiveCodeOptions] | unknown[], Root>;

export { RemarkExpressiveCodeDocument, RemarkExpressiveCodeOptions, RemarkExpressiveCodeRenderer, ThemeObjectOrShikiThemeName, createRenderer, remarkExpressiveCode as default };