edytor 2.0.0 → 3.0.0

package/dist/export/forms.d.ts

@@ -0,0 +1,627 @@
+/**
+ * The bundled kinds' forms as data, one rule per kind and direction: the
+ * HTML a kind writes (`html`, `plain`; a mark's `tag` and `attributes`),
+ * the HTML it reads back (`parse`, and the tags its element shows), and
+ * the Markdown it writes (`toMarkdown` only). The bundled plugins spread a
+ * kind's halves into its record (`codeForms()`, …), so the clipboard,
+ * `toHTML`, `toMarkdown` and `fromHTML` read the same functions, in a view
+ * (its records) and on a server ({@link bundledForms}); each conversion
+ * reads only its own direction's tables. No Svelte, no DOM state:
+ * Worker-safe.
+ */
+import type { JSONBlock } from '../utils/json.js';
+import { type AtomForms, type BlockForms, type ExportKinds, type MarkForms, type SiblingsHtml } from '../clipboard/serializeClipboardFragment.js';
+import { type EmbedProvider } from '../plugins/media/sources.js';
+import { type PagePluginOptions } from '../plugins/page/page.js';
+export type { AtomForms, BlockForms, MarkForms };
+/**
+ * Kind, mark and atom forms by name: what `toHTML`, `toMarkdown` and
+ * `fromHTML` read ({@link bundledForms} for the bundled ones). A kind
+ * record of your own plugin is a valid row: list your kinds beside the
+ * bundled ones (`{ blocks: { ...bundledForms.blocks, mine } }`).
+ */
+export type KindForms = {
+    blocks?: Record<string, BlockForms>;
+    marks?: Record<string, MarkForms>;
+    inlineBlocks?: Record<string, AtomForms>;
+};
+type Data = Record<string, unknown> | undefined;
+/** A kind's forms as its plugin spreads them (the plugin lists its own presets). */
+type Form = Omit<BlockForms, 'presets'>;
+type Rows = Record<string, Form>;
+/** Tables of rows by name as one: each name's rows merged, in the first table's order. */
+export declare const joined: <T extends object = Form>(...tables: Record<string, Partial<NoInfer<T>>>[]) => Record<string, T>;
+/**
+ * Notion's three heading levels: a missing level is h1, any other (a
+ * stored `h4`–`h6`, as HTML import reads them) h3.
+ */
+export declare const headingLevel: (level: unknown) => "h1" | "h2" | "h3";
+/** A code block's language as stored: a short name, else none. */
+export declare const languageOf: (name: unknown) => string | undefined;
+/** The heading levels the rich text kinds create (their presets' data). */
+export declare const HEADING_LEVELS: readonly ["h1", "h2", "h3"];
+/**
+ * A list's elements without list semantics (`role="none"`): a list's items
+ * are sibling blocks, never the only children of one `ul` or `ol`, so an
+ * `li` would be an orphan list item to assistive technology (WCAG 1.3.1);
+ * the tags stay for styles and the HTML export.
+ */
+export declare const unlisted: (tag: "li" | "ul" | "ol") => {
+    tag: "li" | "ol" | "ul";
+    attributes: {
+        role: string;
+    };
+};
+export declare const headingWrite: Form;
+export declare const headingRead: Form;
+export declare const itemWrite: Form;
+export declare const itemRead: Form;
+export declare const numberedRead: Form;
+export declare const todoWrite: Form;
+export declare const toggleRead: Form;
+export declare const toggleHeadingWrite: Form;
+export declare const toggleHeadingRead: Form;
+/** A callout's HTML; `icon` is the one a callout without its own shows. */
+export declare const calloutWrite: (icon: (data: Data) => string) => Form;
+export declare const calloutRead: Form;
+export declare const quoteWrite: Form;
+export declare const quoteRead: Form;
+export declare const dividerWrite: Form;
+export declare const dividerRead: Form;
+export declare const orderedRead: Form;
+export declare const unorderedRead: Form;
+export declare const orderedWrite: Form;
+export declare const unorderedWrite: Form;
+/**
+ * The rich text kinds' forms as one table (a server's). `callout` is the icon a
+ * callout without one of its own shows.
+ */
+export declare const richTextForms: (callout: (data: Data) => string) => Rows;
+/** The rich text marks' forms, in their registration order (export wraps the first innermost). */
+export declare const richTextMarkForms: {
+    bold: {
+        tag: string;
+        parse: (el: HTMLElement) => true | undefined;
+    };
+    italic: {
+        tag: string;
+        parse: (el: HTMLElement) => true | undefined;
+    };
+    underline: {
+        tag: string;
+        parse: (el: HTMLElement) => true | undefined;
+    };
+    strike: {
+        tag: string;
+        parse: (el: HTMLElement) => true | undefined;
+    };
+    code: {
+        tag: string;
+    };
+    link: {
+        tag: string;
+        attributes: (mark: {
+            href?: unknown;
+            target?: string;
+        }) => {
+            href: string | undefined;
+            target: string | undefined;
+        };
+        parse: (el: HTMLElement) => {
+            target?: string | undefined;
+            href: string;
+        } | undefined;
+        edge: "side-dependent";
+    };
+    superscript: {
+        tag: string;
+    };
+    subscript: {
+        tag: string;
+    };
+    color: {
+        tag: string;
+        attributes: (value: unknown) => {
+            style: string | undefined;
+        };
+        parse: (el: HTMLElement) => string | undefined;
+    };
+    highlight: {
+        tag: string;
+        attributes: (value: unknown) => {
+            style: string | undefined;
+        };
+        parse: (el: HTMLElement) => string | undefined;
+    };
+};
+/** The code plugin's forms: a block of `codeLine`s. */
+export declare const codeForms: () => Rows;
+/** A table's HTML: its rows, the header row's and column's cells as `th`. */
+export declare const tableHtml: (data: Record<string, unknown>, rows: string) => string;
+/** An imported `<table>`'s data: a column per cell of its widest row, its header flags. */
+export declare const parseTable: (table: HTMLElement) => {
+    headerColumn?: boolean | undefined;
+    headerRow?: boolean | undefined;
+    columns: {
+        id: string;
+    }[];
+};
+/** An imported cell's column: its position in its row (`c1`, `c2`, … as its table's). */
+export declare const parseCell: (cell: HTMLElement) => {
+    column: string;
+};
+/** The table plugin's forms. */
+export declare const tableForms: () => Rows;
+/** The image plugin's forms: a `figure`. */
+export declare const imageForms: () => Rows;
+/** A bookmark's stored text field: trimmed, capped. */
+export declare const capped: (value: unknown, max: number) => string | undefined;
+/** The media plugins' forms; `providers` are the embed players the view allows. */
+export declare const mediaForms: (providers?: readonly EmbedProvider[]) => Rows;
+/** The page plugin's forms; `untitled` names a page without a title. */
+export declare const pageForms: (options?: PagePluginOptions, untitled?: string) => Rows;
+/** The table of contents plugin's forms: drawn from the document, never carried. */
+export declare const tocForms: () => Rows;
+/** MathML for a TeX source: KaTeX's in a view once loaded, else the source in its annotation. */
+export type MathML = (tex: string, display: boolean) => string;
+/** The equation plugin's forms. */
+export declare const equationForms: (mathml?: MathML) => {
+    blocks: {
+        equation: {
+            itemKind?: string;
+            island?: boolean;
+            rendersContent: boolean;
+            defaultChild?: string;
+            void: boolean;
+            lines?: boolean;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string);
+            markdown?: (block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string;
+            plain?: (block: JSONBlock, content: string, children: string) => string;
+            parse?: (element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined;
+            element?: import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement);
+            contentElement?: import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement);
+        };
+    };
+    inlineBlocks: {
+        inlineEquation: {
+            html?: (data: import("../utils/json.js").JSONInlineBlock["data"]) => string;
+            markdown?: (data: import("../utils/json.js").JSONInlineBlock["data"]) => string;
+            plain?: (data: import("../utils/json.js").JSONInlineBlock["data"]) => string;
+            parse?: (element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined;
+        };
+    };
+};
+/** A column's weight: `data.width`, a positive number, else 1. */
+export declare const weightOf: (data: Data) => number;
+/** The columns plugin's forms. */
+export declare const columnsForms: () => Rows;
+/** A mention atom's forms (`@Ada`): `kind` is its atom type, `char` its trigger. */
+export declare const mentionForms: (kind?: string, char?: string) => AtomForms;
+/** A page link atom's forms: its title. */
+export declare const pageLinkForms: () => AtomForms;
+/**
+ * The HTML forms a view's clipboard does without, filled in by `toHTML` for
+ * the records that lack them: a toggle's `<details>`, a code block's one
+ * `<pre>` naming its language.
+ */
+export declare const htmlExtras: () => Rows;
+/** The import hooks a view's paste does without, filled in by `fromHTML`. */
+export declare const parseExtras: () => Rows;
+/** The records `toHTML` reads by default: every bundled kind's, mark's and atom's HTML writing. */
+export declare const bundledWrite: () => {
+    blocks: Rows;
+    marks: Record<string, MarkForms>;
+    inlineBlocks: {
+        mention: AtomForms;
+        pageLink: AtomForms;
+        inlineEquation: AtomForms;
+    };
+};
+/**
+ * The records `fromHTML` reads by default: every bundled kind's roles, its
+ * presets' data (HTML import finds a kind by a preset's tag: an `h2`, a
+ * `blockquote`) and its HTML reading, in the plugins' order (the first
+ * kind claiming an element wins).
+ */
+export declare const bundledRead: () => {
+    blocks: {
+        paragraph: {};
+        heading: {
+            presets: {
+                data: {
+                    level: "h1" | "h2" | "h3";
+                };
+            }[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        'bulleted-list-item': {
+            presets: {}[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        'numbered-list-item': {
+            presets: {}[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        'todo-item': {
+            presets: {
+                data: {
+                    checked: false;
+                };
+            }[];
+        };
+        toggle: {
+            presets: {}[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        'toggle-heading': {
+            presets: {
+                data: {
+                    level: "h1" | "h2" | "h3";
+                };
+            }[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        callout: {
+            presets: {}[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        quote: {
+            presets: {}[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        divider: {
+            presets: {}[];
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        'ordered-list': {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild: string;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        'unordered-list': {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild: string;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        'list-item': Form;
+        code: {
+            island: true;
+            lines: true;
+            rendersContent: false;
+            defaultChild: string;
+        };
+        codeLine: {};
+        table: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild: string;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            table: true;
+        };
+        tableRow: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild: string;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        tableCell: {
+            itemKind?: string | undefined;
+            island: boolean;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        image: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        embed: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        bookmark: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        file: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        video: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        audio: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent?: boolean | undefined;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        page: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        toc: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        equation: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild?: string | undefined;
+            void: boolean;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+        columns: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild: string;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            layout: true;
+        };
+        column: {
+            itemKind?: string | undefined;
+            island?: boolean | undefined;
+            rendersContent: boolean;
+            defaultChild?: string | undefined;
+            void?: boolean | undefined;
+            lines?: boolean | undefined;
+            html?: string | ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            markdown?: ((block: JSONBlock, content: string, children: string, context: import("../plugins.js").MarkdownContext) => string) | undefined;
+            plain?: ((block: JSONBlock, content: string, children: string) => string) | undefined;
+            parse?: ((element: HTMLElement) => Record<string, import("../utils/json.js").SerializableContent> | undefined) | undefined;
+            element?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+            contentElement?: (import("../plugins.js").BlockElement | ((data: Record<string, any>, id?: string) => import("../plugins.js").BlockElement)) | undefined;
+        };
+    };
+    marks: Record<string, MarkForms>;
+    inlineBlocks: {
+        mention: AtomForms;
+        inlineEquation: AtomForms;
+    };
+};
+/**
+ * Sibling blocks' HTML (`toHTML`): a run of list items no list element
+ * holds (a document's items are siblings, `<li>` alone) is wrapped in its
+ * list's tag, the one its container kind exports (`ol` for numbered items).
+ */
+export declare const listSiblings: (kinds: ExportKinds) => SiblingsHtml;
+/** The Markdown forms by name, filled in by `toMarkdown` for the records that lack them. */
+export declare const markdownExtras: () => {
+    blocks: Record<string, BlockForms>;
+    marks: Record<string, MarkForms>;
+    inlineBlocks: Record<string, AtomForms>;
+};
+/** The records `toMarkdown` reads by default: the Markdown forms, and the atoms' plain text. */
+export declare const bundledMarkdown: () => {
+    inlineBlocks: {
+        mention: {
+            plain: ((data: import("../utils/json.js").JSONInlineBlock["data"]) => string) | undefined;
+        };
+        pageLink: AtomForms;
+    };
+    blocks: Record<string, BlockForms>;
+    marks: Record<string, MarkForms>;
+};