@vuepress/markdown 2.0.0-beta.49 → 2.0.0-beta.50-pre.1

package/dist/index.d.ts

@@ -0,0 +1,272 @@
+import { SfcPluginOptions } from '@mdit-vue/plugin-sfc';
+export { MarkdownSfcBlocks, SfcPluginOptions, sfcPlugin } from '@mdit-vue/plugin-sfc';
+import { MarkdownItEnv } from '@mdit-vue/types';
+import { PageHeader, PageFrontmatter } from '@vuepress/shared';
+import MarkdownIt, { PluginWithOptions } from 'markdown-it';
+import { FrontmatterPluginOptions } from '@mdit-vue/plugin-frontmatter';
+export { FrontmatterPluginOptions, frontmatterPlugin } from '@mdit-vue/plugin-frontmatter';
+import { HeadersPluginOptions } from '@mdit-vue/plugin-headers';
+export { HeadersPluginOptions, headersPlugin } from '@mdit-vue/plugin-headers';
+import { TocPluginOptions } from '@mdit-vue/plugin-toc';
+export { TocPluginOptions, tocPlugin } from '@mdit-vue/plugin-toc';
+import anchorPlugin from 'markdown-it-anchor';
+export { default as anchorPlugin } from 'markdown-it-anchor';
+import emojiPlugin from 'markdown-it-emoji';
+export { default as emojiPlugin } from 'markdown-it-emoji';
+export { ComponentPluginOptions, componentPlugin } from '@mdit-vue/plugin-component';
+export { titlePlugin } from '@mdit-vue/plugin-title';
+import { RuleBlock } from 'markdown-it/lib/parser_block.js';
+
+declare type AnchorPluginOptions = anchorPlugin.AnchorOptions;
+
+interface AssetsPluginOptions {
+    /**
+     * Prefix to add to relative assets links
+     */
+    relativePathPrefix?: string;
+}
+/**
+ * Plugin to handle assets links
+ */
+declare const assetsPlugin: PluginWithOptions<AssetsPluginOptions>;
+
+declare const resolveLink: (link: string, relativePathPrefix: string, env: MarkdownEnv) => string;
+
+interface CodePluginOptions {
+    /**
+     * Enable highlight lines or not
+     */
+    highlightLines?: boolean;
+    /**
+     * Enable line numbers or not
+     *
+     * - A `boolean` value is to enable line numbers or not.
+     * - A `number` value is the minimum number of lines to enable line numbers
+     */
+    lineNumbers?: boolean | number;
+    /**
+     * Wrap the `<pre>` tag with an extra `<div>` or not. Do not disable it unless you
+     * understand what's it for
+     *
+     * - Required for `highlightLines`
+     * - Required for `lineNumbers`
+     * - Required for language display of default theme
+     */
+    preWrapper?: boolean;
+    /**
+     * Add `v-pre` directive or not
+     */
+    vPre?: {
+        /**
+         * Add `v-pre` directive to `<pre>` tag of code block or not
+         */
+        block?: boolean;
+        /**
+         * Add `v-pre` directive to `<code>` tag of inline code or not
+         */
+        inline?: boolean;
+    };
+}
+/**
+ * Code plugin
+ */
+declare const codePlugin: PluginWithOptions<CodePluginOptions>;
+
+/**
+ * Language type for syntax highlight
+ */
+interface HighlightLanguage {
+    /**
+     * Name of the language
+     *
+     * The name to be used for the class name,
+     * e.g. `class="language-typescript"`
+     */
+    name: string;
+    /**
+     * Extension of the language
+     *
+     * The file extension, which will be used for the
+     * class name, e.g. `class="ext-ts"`
+     */
+    ext: string;
+    /**
+     * Aliases that point to this language
+     *
+     * Do not conflict with other languages
+     */
+    aliases: string[];
+}
+declare const languageBash: HighlightLanguage;
+declare const languageCsharp: HighlightLanguage;
+declare const languageDocker: HighlightLanguage;
+declare const languageFsharp: HighlightLanguage;
+declare const languageJavascript: HighlightLanguage;
+declare const languageKotlin: HighlightLanguage;
+declare const languageMarkdown: HighlightLanguage;
+declare const languagePython: HighlightLanguage;
+declare const languageRuby: HighlightLanguage;
+declare const languageRust: HighlightLanguage;
+declare const languageStylus: HighlightLanguage;
+declare const languageTypescript: HighlightLanguage;
+declare const languageYaml: HighlightLanguage;
+
+declare type HighlightLinesRange = [number, number];
+/**
+ * Resolve highlight-lines ranges from token info
+ */
+declare const resolveHighlightLines: (info: string) => HighlightLinesRange[] | null;
+/**
+ * Check if a line number is in ranges
+ */
+declare const isHighlightLine: (lineNumber: number, ranges: HighlightLinesRange[]) => boolean;
+
+/**
+ * Resolve language for highlight from token info
+ */
+declare const resolveLanguage: (info: string) => HighlightLanguage;
+
+/**
+ * Resolve the `:line-numbers` / `:no-line-numbers` mark from token info
+ */
+declare const resolveLineNumbers: (info: string) => boolean | null;
+
+/**
+ * Resolve the `:v-pre` / `:no-v-pre` mark from token info
+ */
+declare const resolveVPre: (info: string) => boolean | null;
+
+declare type EmojiPluginOptions = emojiPlugin.Options;
+
+interface ImportCodePluginOptions {
+    /**
+     * A function to handle the import path
+     */
+    handleImportPath?: (str: string) => string;
+}
+declare const importCodePlugin: PluginWithOptions<ImportCodePluginOptions>;
+
+declare const createImportCodeBlockRule: ({ handleImportPath }: ImportCodePluginOptions) => RuleBlock;
+
+interface ImportCodeTokenMeta {
+    importPath: string;
+    lineStart: number;
+    lineEnd?: number;
+}
+
+declare const resolveImportCode: ({ importPath, lineStart, lineEnd }: ImportCodeTokenMeta, { filePath }: MarkdownEnv) => {
+    importFilePath: string | null;
+    importCode: string;
+};
+
+interface LinksPluginOptions {
+    /**
+     * Tag for internal links
+     *
+     * @default 'RouterLink'
+     */
+    internalTag?: 'a' | 'RouterLink';
+    /**
+     * Additional attributes for external links
+     *
+     * @default
+     * ```js
+     * ({
+     *   target: '_blank',
+     *   rel: 'noopener noreferrer',
+     * })
+     * ```
+     */
+    externalAttrs?: Record<string, string>;
+}
+/**
+ * Process links in markdown file
+ *
+ * - internal links: convert them into `<RouterLink>`
+ * - external links: add extra attrs and external icon
+ */
+declare const linksPlugin: PluginWithOptions<LinksPluginOptions>;
+
+/**
+ * Resolve relative and absolute paths according to the `base` and `filePathRelative`
+ */
+declare const resolvePaths: (rawPath: string, base: string, filePathRelative: string | null) => {
+    absolutePath: string;
+    relativePath: string;
+};
+
+declare type Markdown = MarkdownIt;
+
+interface MarkdownOptions extends MarkdownIt.Options {
+    anchor?: false | AnchorPluginOptions;
+    assets?: false | AssetsPluginOptions;
+    code?: false | CodePluginOptions;
+    component?: false;
+    emoji?: false | EmojiPluginOptions;
+    frontmatter?: false | FrontmatterPluginOptions;
+    headers?: false | HeadersPluginOptions;
+    title?: false;
+    importCode?: false | ImportCodePluginOptions;
+    links?: false | LinksPluginOptions;
+    sfc?: false | SfcPluginOptions;
+    slugify?: MarkdownSlugifyFunction;
+    toc?: false | TocPluginOptions;
+}
+/**
+ * Headers in markdown file
+ */
+declare type MarkdownHeader = PageHeader;
+/**
+ * Internal links in markdown file
+ *
+ * Used for file existence check
+ */
+interface MarkdownLink {
+    raw: string;
+    relative: string;
+    absolute: string;
+}
+/**
+ * The `env` object to be passed to markdown-it render function
+ *
+ * Input some meta data for markdown file parsing and rendering
+ *
+ * Output some resources from the markdown file
+ */
+interface MarkdownEnv extends MarkdownItEnv {
+    /**
+     * Base / publicPath of current site
+     */
+    base?: string;
+    /**
+     * Absolute file path of the markdown file
+     */
+    filePath?: string | null;
+    /**
+     * Relative file path of the markdown file
+     */
+    filePathRelative?: string | null;
+    /**
+     * Frontmatter of the markdown file
+     */
+    frontmatter?: PageFrontmatter;
+    /**
+     * Imported file that extracted by importCodePlugin
+     */
+    importedFiles?: string[];
+    /**
+     * Links that extracted by linksPlugin
+     */
+    links?: MarkdownLink[];
+}
+/**
+ * Type of `slugify` function
+ */
+declare type MarkdownSlugifyFunction = (str: string) => string;
+
+/**
+ * Create vuepress customized markdown-it instance
+ */
+declare const createMarkdown: ({ anchor, assets, code, component, emoji, frontmatter, headers, title, importCode, links, sfc, slugify, toc, ...markdownItOptions }?: MarkdownOptions) => Markdown;
+
+export { AnchorPluginOptions, AssetsPluginOptions, CodePluginOptions, EmojiPluginOptions, HighlightLanguage, HighlightLinesRange, ImportCodePluginOptions, ImportCodeTokenMeta, LinksPluginOptions, Markdown, MarkdownEnv, MarkdownHeader, MarkdownLink, MarkdownOptions, MarkdownSlugifyFunction, assetsPlugin, codePlugin, createImportCodeBlockRule, createMarkdown, importCodePlugin, isHighlightLine, languageBash, languageCsharp, languageDocker, languageFsharp, languageJavascript, languageKotlin, languageMarkdown, languagePython, languageRuby, languageRust, languageStylus, languageTypescript, languageYaml, linksPlugin, resolveHighlightLines, resolveImportCode, resolveLanguage, resolveLineNumbers, resolveLink, resolvePaths, resolveVPre };