@meowdown/core 0.70.0 → 0.71.0

package/dist/index.d.ts

@@ -1,17 +1,20 @@
 import { Editor, Extension, ExtractMarkBuilders, ExtractNodeBuilders, PlainExtension, Priority, Union, withPriority } from "@prosekit/core";
 import { CodeBlockAttrs, CodeBlockAttrs as CodeBlockAttrs$1, defineCodeBlockPreviewPlugin, isCodeBlockPreviewHiddenDecoration } from "@prosekit/extensions/code-block";
-import { PlaceholderOptions, definePlaceholder } from "@prosekit/extensions/placeholder";
-import { defineReadonly } from "@prosekit/extensions/readonly";
-import { SearchStatus, SearchStatusHandler, defineSearchStatusHandler, getSearchStatus } from "@prosekit/extensions/search";
+import { PlaceholderOptions, PlaceholderOptions as PlaceholderOptions$1, definePlaceholder } from "@prosekit/extensions/placeholder";
 import { Command, EditorState, PluginKey } from "@prosekit/pm/state";
+import { SearchStatus, SearchStatusHandler, defineSearchStatusHandler, getSearchStatus } from "@prosekit/extensions/search";
 import { EditorView } from "@prosekit/pm/view";
 import { EditorNode, Mark, ProseMirrorNode } from "@prosekit/pm/model";
 import { ListAttrs } from "@prosekit/extensions/list";
+import { parseXPostId } from "@post-embed/schema";
 import { HorizontalRuleExtension } from "@prosekit/extensions/horizontal-rule";
 import { Resolver } from "@post-embed/elements/x";
 import { render } from "katex";
 import { XPost, YouTubeVideo } from "@post-embed/types";
 import { VirtualElement } from "@floating-ui/dom";
+//#region src/extensions/readonly.d.ts
+export declare function defineReadonly(getReadonly?: (state: EditorState) => boolean): PlainExtension;
+//#endregion
 //#region src/converters/check-roundtrip.d.ts
 /**
  * How faithfully markdown survives a parse-then-serialize round trip:
@@ -502,212 +505,554 @@ type PendingReplacementHandler = (event: PendingReplacementEvent) => void;
  */
 export declare function definePendingReplacementHandler(handler: PendingReplacementHandler): PlainExtension;
 //#endregion
-//#region src/extensions/mark-chunk.d.ts
-/**
- * Contiguous range with a uniform inline-mark set.
- */
-type MarkChunk = readonly [from: number, to: number, marks: readonly Mark[]];
-//#endregion
-//#region src/extensions/reference-links.d.ts
-interface ReferenceDefinition {
-  key: string;
-  href: string;
-  title: string;
-}
-type ReferenceDefinitions = ReadonlyMap<string, ReferenceDefinition>;
-interface ReferenceDefinitionIndex {
-  definitions: ReferenceDefinitions;
-  nodes: ReadonlySet<EditorNode>;
-}
-export declare function isReferenceDefinitionNode(node: EditorNode, parent: EditorNode | null, index: number): boolean;
-export declare function collectReferenceDefinitions(doc: EditorNode): ReferenceDefinitionIndex;
-//#endregion
-//#region src/extensions/wiki-embed.d.ts
+//#region src/extensions/exit-boundary.d.ts
 /**
- * The parsed source payload of an Obsidian-style `![[target]]` embed.
+ * Payload for {@link ExitBoundaryHandler}.
  */
-interface ParsedWikiEmbed {
-  /**
-   * Target before an optional alias or size suffix.
-   */
-  target: string;
-  /**
-   * Non-size suffix after `|`, or `''` when absent.
-   */
-  display: string;
+interface ExitBoundaryOptions {
   /**
-   * Requested display width in CSS pixels, or `null`.
+   * The boundary the caret would leave: `up` at the document start, `down` at the end.
    */
-  width: number | null;
+  direction: 'up' | 'down';
   /**
-   * Requested display height in CSS pixels, or `null`.
+   * The originating arrow key press.
    */
-  height: number | null;
+  event: KeyboardEvent;
 }
 /**
- * A resolved wiki embed rendered through Meowdown's existing atom views.
+ * Called when an arrow key press would move the caret past the document
+ * boundary. Return `false` to let the editor handle the key normally; any
+ * other return value consumes it.
  */
-type WikiEmbedResolution = {
-  kind: 'image';
-  /**
-   * Source passed to `resolveImageUrl` and image click handlers. Defaults to `target`.
-   */
-  src?: string;
-  /**
-   * Image alt text. Defaults to the alias or target basename.
-   */
-  alt?: string;
-} | {
-  kind: 'file';
-  /**
-   * Destination passed to file metadata and click handlers. Defaults to `target`.
-   */
-  href?: string;
-  /**
-   * File pill label. Defaults to the alias or target basename.
-   */
-  name?: string;
-  /**
-   * Optional file title.
-   */
-  title?: string;
-} | {
-  kind: 'note';
-  /**
-   * Target passed to wikilink click handlers. Defaults to the source target.
-   */
-  target?: string;
-  /**
-   * Chip label. Defaults to the source alias or resolved target.
-   */
-  display?: string;
-};
+type ExitBoundaryHandler = (options: ExitBoundaryOptions) => boolean | void;
 /**
- * Classifies one wiki embed for rendering. Return `undefined` to leave the
- * source literal and editable. The resolver participates in the parse cache,
- * so it must be pure: the same payload must always return the same result.
+ * Call `onExitBoundary` when an arrow key press would leave the document boundary.
  */
-type WikiEmbedResolver = (embed: ParsedWikiEmbed) => WikiEmbedResolution | undefined;
+export declare function defineExitBoundaryHandler(getExitBoundaryHandler?: (state: EditorState) => ExitBoundaryHandler | undefined): PlainExtension;
+//#endregion
+//#region src/extensions/file-paste.d.ts
+type FilePasteHandler = (file: File) => string | undefined | Promise<string | undefined>;
+type FileSaveErrorHandler = (error: unknown, file: File) => void;
 /**
- * Host options for wiki-embed parsing.
+ * Options for {@link defineFilePaste}.
  */
-interface WikiEmbedOptions {
-  resolveWikiEmbed?: WikiEmbedResolver;
+interface FilePasteOptions {
+  /**
+   * Persist a pasted/dropped file and return its markdown destination, or
+   * `undefined` to decline (nothing is inserted, but the event is consumed).
+   * An image (`image/*` MIME type or a recognized image filename extension)
+   * inserts `![](src)`; any other file inserts a `[name](src)` link.
+   */
+  onFilePaste?: FilePasteHandler;
+  /**
+   * Called when persisting a pasted/dropped file throws. Defaults to `console.error`.
+   */
+  onFileSaveError?: FileSaveErrorHandler;
 }
 /**
- * Parse `![[target]]`, `![[target|alias]]`, `![[target|width]]`, or `![[target|widthxheight]]`.
- */
-export declare function parseWikiEmbed(source: string): ParsedWikiEmbed;
-/**
- * Rewrite a wiki image embed with a persisted display size.
+ * The markdown a saved file becomes: `![](destination)` for an image (a
+ * `type` starting with `image/` or a recognized image filename extension), a
+ * `[name](destination)` link otherwise, with `\`, `[`, and `]` escaped in the
+ * name. Exported so a host command that inserts file links itself (e.g. an
+ * attach-file picker) produces markdown byte-identical to a paste/drop.
  */
-export declare function formatSizedWikiEmbed(target: string, width: number, height: number): string;
+export declare function buildFileMarkdown(file: {
+  name: string;
+  type?: string;
+}, destination: string): string;
 /**
- * Last path component of a target, with a note heading/block fragment removed.
+ * Persist pasted/dropped files via `onFilePaste` and insert the returned
+ * markdown destination: `![](src)` for an image, a `[name](src)` link for any
+ * other file. Multiple files insert one link per line, in DataTransfer order.
  */
-export declare function wikiEmbedBasename(target: string): string;
+export declare function defineFilePaste(getOptions?: (state: EditorState) => FilePasteOptions | undefined): PlainExtension;
 //#endregion
-//#region src/extensions/wikilink.d.ts
+//#region src/extensions/file-view.d.ts
 /**
- * What {@link WikilinkResolver} sees for one `[[...]]` wikilink.
+ * Metadata a host resolves for one file link, shown on its pill.
  */
-interface WikilinkPayload {
+interface FileInfo {
   /**
-   * The text between the brackets, trimmed. Meowdown reads no syntax inside
-   * it: an alias form such as `[[target|alias]]` arrives here whole.
+   * File size in bytes, shown as a human-readable suffix (e.g. `1.4 MB`).
    */
-  target: string;
+  size?: number;
 }
 /**
- * A resolved wikilink.
+ * Resolve display metadata for a file `href`, directly or as a promise; the
+ * pill renders immediately and fills the metadata in when the promise
+ * settles. Return `undefined` for a file without metadata (e.g. one that no
+ * longer exists). Called once per rendered pill, so the same `href` may
+ * resolve repeatedly: cache in the host when resolving is expensive.
  */
-interface WikilinkResolution {
-  /**
-   * Target passed to click and hover handlers. Defaults to the bracketed text.
-   */
-  target?: string;
+type FileInfoResolver = (href: string) => FileInfo | undefined | Promise<FileInfo | undefined>;
+/**
+ * Options for {@link defineFileView}.
+ */
+interface FileViewOptions {
   /**
-   * Label shown in place of the source. Defaults to the target.
+   * Resolve the metadata (file size) shown on a pill. Omit to show none.
    */
-  display?: string;
+  resolveFileInfo?: FileInfoResolver;
 }
 /**
- * Resolves one `[[...]]` wikilink into the target its handlers receive and
- * the label its chip shows; the Markdown source stays as written. Return
- * `undefined` to use the bracketed text as both. The resolver participates
- * in the parse cache, so it must be pure: the same payload must always
- * return the same result.
+ * Classify a file destination for the pill's `data-file-kind` attribute.
  */
-type WikilinkResolver = (link: WikilinkPayload) => WikilinkResolution | undefined;
+export declare function getFileKind(href: string): string;
 /**
- * Host options for wikilink parsing.
+ * Render a claimed file link or wiki embed (the `mdFile` mark) as an inline
+ * pill: a file-kind icon, the file name, and the size once
+ * `resolveFileInfo` supplies it. The pill never loads the file's content;
+ * clicks are reported through `defineFileClickHandler`.
  */
-interface WikilinkOptions {
-  resolveWikilink?: WikilinkResolver;
-}
+export declare function defineFileView(getOptions?: (state: EditorState) => FileViewOptions): PlainExtension;
 //#endregion
-//#region src/extensions/inline-text-to-mark-chunks.d.ts
+//#region src/extensions/file-click.d.ts
 /**
- * What {@link FileLinkResolver} sees for one `[label](url)` link.
+ * Payload for {@link FileClickHandler}.
  */
-interface FileLinkPayload {
+interface FileClickPayload {
   /**
-   * The link destination, exactly as written in the source.
+   * The resolved destination from `[name](href)` or a claimed `![[target]]`.
    */
   href: string;
   /**
-   * The raw label slice between the brackets; may be empty or contain nested syntax.
+   * The file name shown on the pill.
    */
-  label: string;
+  name: string;
   /**
-   * The link title, or `''` when the source has none.
+   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the
+   * pill. Read modifier keys or position a popover from it.
    */
-  title: string;
+  event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
 }
+type FileClickHandler = (payload: FileClickPayload) => void;
 /**
- * Claims a `[label](url)` link as a file attachment. A claimed link carries a
- * single `mdFile` mark over its whole source (rendered as a file pill by
- * `defineFileView`) instead of the usual link marks, so link click/hover/menu
- * no longer apply to it. Must be pure: parse results are cached and diffed,
- * so the same input must always produce the same answer.
+ * Call `onClick` when the user clicks a rendered file pill, with the file's
+ * `href`, `name`, and the originating `MouseEvent`. The host decides what a
+ * click does (e.g. open the file in the OS default app).
  */
-type FileLinkResolver = (link: FileLinkPayload) => boolean;
+export declare function defineFileClickHandler(getOnClick?: (state: EditorState) => FileClickHandler | undefined): PlainExtension;
+//#endregion
+//#region src/extensions/image-click.d.ts
 /**
- * Host options that influence inline parsing.
+ * Payload for {@link ImageClickHandler}.
  */
-interface FileLinkOptions {
+interface ImageClickPayload {
   /**
-   * Claim `[label](url)` links as file attachments; see {@link FileLinkResolver}.
-   * Read once when the editor is created.
+   * The resolved source from `![alt](src)` or a claimed `![[target]]`.
    */
-  resolveFileLink?: FileLinkResolver;
-}
-/**
- * Host options that influence source-backed inline atom parsing.
- */
-type InlineMarkOptions = FileLinkOptions & WikiEmbedOptions & WikilinkOptions;
-interface InlineMarkContext {
+  src: string;
   /**
-   * Effective document-wide definitions, keyed by normalized reference label.
+   * The image alt text.
    */
-  referenceDefinitions?: ReferenceDefinitions;
+  alt: string;
   /**
-   * Prevent this definition block's own label from resolving as a shortcut reference.
+   * The originating click or touch tap, or the `Enter`/`Mod-Enter` key press
+   * that followed the selected image. Read the target or position a popover
+   * from it; a touch surface delivers the `touchend` instead of a click.
    */
-  isReferenceDefinition?: boolean;
+  event: MouseEvent | TouchEvent | KeyboardEvent;
   /**
-   * Receives every normalized key read by this block, including unresolved references.
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
    */
-  referencedKeys?: Set<string>;
+  mod: boolean;
 }
+type ImageClickHandler = (payload: ImageClickPayload) => void;
 /**
- * Walk a textblock's inline content and produce a list of mark chunks
- * with positions relative to the start of `text` (i.e. zero-based).
- * Callers shift the chunks into the document's coordinate space.
+ * Call `onClick` when the user clicks or taps a rendered image preview, with
+ * the image's markdown `src`, `alt`, and the originating event.
+ *
+ * Touch taps are handled from `touchend` rather than the synthetic click:
+ * previews live inside the editor contenteditable, and iOS WebKit's
+ * tap-to-focus is a native gesture default action that only cancelling the
+ * `touchend` can suppress — otherwise a tap briefly focuses the editor and
+ * raises the software keyboard before the handler opens its own surface
+ * (such as a lightbox).
  */
-export declare function inlineTextToMarkChunks(
-/**
- * Typed mark builders bound to the target schema.
+export declare function defineImageClickHandler(getOnClick?: (state: EditorState) => ImageClickHandler | undefined): PlainExtension;
+//#endregion
+//#region src/extensions/link-click.d.ts
+interface LinkClickPayload {
+  href: string;
+  /**
+   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the link.
+   */
+  event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
+}
+type LinkClickHandler = (payload: LinkClickPayload) => void;
+interface LinkCopyPayload {
+  href: string;
+}
+type LinkCopyHandler = (payload: LinkCopyPayload) => void;
+/**
+ * Call `onClick` when the user clicks a rendered Markdown link
+ * (`[text](url)`), or presses `Mod-Enter` with the caret on one. The `event`
+ * is the originating `MouseEvent` or `KeyboardEvent`.
+ */
+export declare function defineLinkClickHandler(getOnClick?: (state: EditorState) => LinkClickHandler | undefined): PlainExtension;
+//#endregion
+//#region src/extensions/tag-click.d.ts
+interface TagClickPayload {
+  /**
+   * The tag name, without the leading `#`.
+   */
+  tag: string;
+  /**
+   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the tag.
+   * Read modifier keys or position a popover from it.
+   */
+  event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
+}
+type TagClickHandler = (payload: TagClickPayload) => void;
+/**
+ * Call `onClick` when the user clicks a rendered `#tag`, or presses
+ * `Mod-Enter` with the caret on one. The `tag` is read from the rendered text
+ * without the leading `#`.
+ */
+export declare function defineTagClickHandler(getOnClick?: (state: EditorState) => TagClickHandler | undefined): PlainExtension;
+//#endregion
+//#region src/extensions/wikilink-click.d.ts
+interface WikilinkHit {
+  from: number;
+  to: number;
+  target: string;
+}
+interface WikilinkClickPayload {
+  target: string;
+  /**
+   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the link.
+   */
+  event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
+}
+type WikilinkClickHandler = (payload: WikilinkClickPayload) => void;
+/**
+ * Call `onClick` when the user clicks a rendered wikilink label, or presses
+ * `Mod-Enter` with the caret on one. The `event` is the originating
+ * `MouseEvent` or `KeyboardEvent`.
+ */
+export declare function defineWikilinkClickHandler(getOnClick?: (state: EditorState) => WikilinkClickHandler | undefined): PlainExtension;
+//#endregion
+//#region src/extensions/follow-link.d.ts
+interface FollowLinkHandlers {
+  onWikilinkClick?: WikilinkClickHandler;
+  onTagClick?: TagClickHandler;
+  onFileClick?: FileClickHandler;
+  onLinkClick?: LinkClickHandler;
+  onImageClick?: ImageClickHandler;
+}
+/**
+ * Binds `Mod-Enter` to follow the wikilink, tag, file pill, or Markdown link
+ * under the caret, and plain `Enter` to follow a selected atom unit (a
+ * wikilink, file pill, or image), firing the same handlers a click does.
+ * "Under the caret" means strictly inside the unit: a caret merely touching
+ * a unit's edge is next to it, not on it.
+ * Off a link, `Mod-Enter` falls through so the list keymap keeps cycling
+ * checkbox tasks; off a selected unit, `Enter` falls through to the regular
+ * split. High priority puts this ahead of every keymap binding.
+ *
+ * A selected-unit follow reports `mod: true` when the platform's mod key
+ * (`⌘` on Apple, `Ctrl` elsewhere) was held beyond its plain-`Enter` trigger;
+ * a caret follow always reports `mod: false`, its mod key being the trigger
+ * itself.
+ */
+export declare function defineFollowLinkHandler(getHandlers?: (state: EditorState) => FollowLinkHandlers): PlainExtension;
+//#endregion
+//#region src/extensions/post-embed.d.ts
+type XPostResolver = Resolver<XPost>;
+type YouTubeVideoResolver = Resolver<YouTubeVideo>;
+type PostEmbedKind = 'x-post' | 'youtube-video';
+/**
+ * The post-embed card an image `src` renders as, or `undefined` for a plain image.
+ */
+export declare function matchPostEmbed(src: string): PostEmbedKind | undefined;
+export declare const defaultResolveXPost: XPostResolver;
+export declare const defaultResolveYouTubeVideo: YouTubeVideoResolver;
+/**
+ * The `snapshot` field of an image's magic comment: the card kind and the
+ * data post-embed renders. The kind is stored explicitly, so a saved snapshot
+ * is validated once, against the schema it names.
+ */
+type PostEmbedSnapshot = {
+  kind: 'x-post';
+  data: XPost;
+} | {
+  kind: 'youtube-video';
+  data: YouTubeVideo;
+};
+/**
+ * The snapshot a card renders from a saved JSON object, or `undefined` when
+ * the object does not validate. Unknown fields are dropped, so a persisted
+ * snapshot is exactly what the card needs.
+ */
+export declare function parsePostEmbedSnapshot(value: unknown): PostEmbedSnapshot | undefined;
+//#endregion
+//#region src/extensions/image.d.ts
+type ImageUrlResolver = (src: string) => string | undefined;
+/**
+ * Options for {@link defineImage}.
+ */
+interface ImageOptions {
+  /**
+   * Map a markdown `src` to a displayable URL, or `undefined` to skip rendering
+   * that image. Defaults to `defaultResolveImageUrl`.
+   */
+  resolveImageUrl?: ImageUrlResolver;
+  /**
+   * Resolve the data behind an X post URL.
+   * When omitted, public posts use `defaultResolveXPost`.
+   */
+  resolveXPost?: XPostResolver;
+  /**
+   * Additional trusted protocols for X media URLs, such as `reflect-asset:`.
+   */
+  mediaUrlProtocols?: string[];
+  /**
+   * Resolve the data behind a YouTube video URL, rendered as a
+   * `post-embed-youtube-video` card. Defaults to `defaultResolveYouTubeVideo`,
+   * which reads YouTube's oEmbed endpoint.
+   */
+  resolveYouTubeVideo?: YouTubeVideoResolver;
+}
+/**
+ * Show an `src` as-is when it is an http(s) URL, otherwise skip rendering it.
+ */
+export declare function defaultResolveImageUrl(src: string): string | undefined;
+/**
+ * Inline image/embed rendering: a mark view on the `mdImage` mark. Images
+ * render in place from their literal Markdown source. Drag a rendered image's
+ * corner handle to write the size back into the source as a trailing comment,
+ * `![alt](src)<!-- {"width":320,"height":240} -->`, which round-trips as
+ * plain Markdown.
+ */
+export declare function defineImage(getOptions?: (state: EditorState) => ImageOptions | undefined): PlainExtension;
+//#endregion
+//#region src/extensions/mark-chunk.d.ts
+/**
+ * Contiguous range with a uniform inline-mark set.
+ */
+type MarkChunk = readonly [from: number, to: number, marks: readonly Mark[]];
+//#endregion
+//#region src/extensions/reference-links.d.ts
+interface ReferenceDefinition {
+  key: string;
+  href: string;
+  title: string;
+}
+type ReferenceDefinitions = ReadonlyMap<string, ReferenceDefinition>;
+interface ReferenceDefinitionIndex {
+  definitions: ReferenceDefinitions;
+  nodes: ReadonlySet<EditorNode>;
+}
+export declare function isReferenceDefinitionNode(node: EditorNode, parent: EditorNode | null, index: number): boolean;
+export declare function collectReferenceDefinitions(doc: EditorNode): ReferenceDefinitionIndex;
+//#endregion
+//#region src/extensions/wiki-embed.d.ts
+/**
+ * The parsed source payload of an Obsidian-style `![[target]]` embed.
+ */
+interface ParsedWikiEmbed {
+  /**
+   * Target before an optional alias or size suffix.
+   */
+  target: string;
+  /**
+   * Non-size suffix after `|`, or `''` when absent.
+   */
+  display: string;
+  /**
+   * Requested display width in CSS pixels, or `null`.
+   */
+  width: number | null;
+  /**
+   * Requested display height in CSS pixels, or `null`.
+   */
+  height: number | null;
+}
+/**
+ * A resolved wiki embed rendered through Meowdown's existing atom views.
+ */
+type WikiEmbedResolution = {
+  kind: 'image';
+  /**
+   * Source passed to `resolveImageUrl` and image click handlers. Defaults to `target`.
+   */
+  src?: string;
+  /**
+   * Image alt text. Defaults to the alias or target basename.
+   */
+  alt?: string;
+} | {
+  kind: 'file';
+  /**
+   * Destination passed to file metadata and click handlers. Defaults to `target`.
+   */
+  href?: string;
+  /**
+   * File pill label. Defaults to the alias or target basename.
+   */
+  name?: string;
+  /**
+   * Optional file title.
+   */
+  title?: string;
+} | {
+  kind: 'note';
+  /**
+   * Target passed to wikilink click handlers. Defaults to the source target.
+   */
+  target?: string;
+  /**
+   * Chip label. Defaults to the source alias or resolved target.
+   */
+  display?: string;
+};
+/**
+ * Classifies one wiki embed for rendering. Return `undefined` to leave the
+ * source literal and editable. The resolver participates in the parse cache,
+ * so it must be pure: the same payload must always return the same result.
+ */
+type WikiEmbedResolver = (embed: ParsedWikiEmbed) => WikiEmbedResolution | undefined;
+/**
+ * Host options for wiki-embed parsing.
+ */
+interface WikiEmbedOptions {
+  resolveWikiEmbed?: WikiEmbedResolver;
+}
+/**
+ * Parse `![[target]]`, `![[target|alias]]`, `![[target|width]]`, or `![[target|widthxheight]]`.
+ */
+export declare function parseWikiEmbed(source: string): ParsedWikiEmbed;
+/**
+ * Rewrite a wiki image embed with a persisted display size.
+ */
+export declare function formatSizedWikiEmbed(target: string, width: number, height: number): string;
+/**
+ * Last path component of a target, with a note heading/block fragment removed.
+ */
+export declare function wikiEmbedBasename(target: string): string;
+//#endregion
+//#region src/extensions/wikilink.d.ts
+/**
+ * What {@link WikilinkResolver} sees for one `[[...]]` wikilink.
+ */
+interface WikilinkPayload {
+  /**
+   * The text between the brackets, trimmed. Meowdown reads no syntax inside
+   * it: an alias form such as `[[target|alias]]` arrives here whole.
+   */
+  target: string;
+}
+/**
+ * A resolved wikilink.
+ */
+interface WikilinkResolution {
+  /**
+   * Target passed to click and hover handlers. Defaults to the bracketed text.
+   */
+  target?: string;
+  /**
+   * Label shown in place of the source. Defaults to the target.
+   */
+  display?: string;
+}
+/**
+ * Resolves one `[[...]]` wikilink into the target its handlers receive and
+ * the label its chip shows; the Markdown source stays as written. Return
+ * `undefined` to use the bracketed text as both. The resolver participates
+ * in the parse cache, so it must be pure: the same payload must always
+ * return the same result.
+ */
+type WikilinkResolver = (link: WikilinkPayload) => WikilinkResolution | undefined;
+/**
+ * Host options for wikilink parsing.
+ */
+interface WikilinkOptions {
+  resolveWikilink?: WikilinkResolver;
+}
+//#endregion
+//#region src/extensions/inline-text-to-mark-chunks.d.ts
+/**
+ * What {@link FileLinkResolver} sees for one `[label](url)` link.
+ */
+interface FileLinkPayload {
+  /**
+   * The link destination, exactly as written in the source.
+   */
+  href: string;
+  /**
+   * The raw label slice between the brackets; may be empty or contain nested syntax.
+   */
+  label: string;
+  /**
+   * The link title, or `''` when the source has none.
+   */
+  title: string;
+}
+/**
+ * Claims a `[label](url)` link as a file attachment. A claimed link carries a
+ * single `mdFile` mark over its whole source (rendered as a file pill by
+ * `defineFileView`) instead of the usual link marks, so link click/hover/menu
+ * no longer apply to it. Must be pure: parse results are cached and diffed,
+ * so the same input must always produce the same answer.
+ */
+type FileLinkResolver = (link: FileLinkPayload) => boolean;
+/**
+ * Host options that influence inline parsing.
+ */
+interface FileLinkOptions {
+  /**
+   * Claim `[label](url)` links as file attachments; see {@link FileLinkResolver}.
+   * Updates existing content when the configured resolver changes.
+   */
+  resolveFileLink?: FileLinkResolver;
+}
+/**
+ * Host options that influence source-backed inline atom parsing.
+ */
+type InlineMarkOptions = FileLinkOptions & WikiEmbedOptions & WikilinkOptions;
+interface InlineMarkContext {
+  /**
+   * Effective document-wide definitions, keyed by normalized reference label.
+   */
+  referenceDefinitions?: ReferenceDefinitions;
+  /**
+   * Prevent this definition block's own label from resolving as a shortcut reference.
+   */
+  isReferenceDefinition?: boolean;
+  /**
+   * Receives every normalized key read by this block, including unresolved references.
+   */
+  referencedKeys?: Set<string>;
+}
+/**
+ * Walk a textblock's inline content and produce a list of mark chunks
+ * with positions relative to the start of `text` (i.e. zero-based).
+ * Callers shift the chunks into the document's coordinate space.
+ */
+export declare function inlineTextToMarkChunks(
+/**
+ * Typed mark builders bound to the target schema.
  */
 marks: TypedMarkBuilders,
 /**
@@ -731,6 +1076,21 @@ export declare function inlineTextToMarkChunksWithContext(marks: TypedMarkBuilde
  */
 type MarkMode = 'hide' | 'focus' | 'show';
 //#endregion
+//#region src/extensions/editor-config-types.d.ts
+interface EditorConfig extends InlineMarkOptions, FollowLinkHandlers, FilePasteOptions, FileViewOptions, ImageOptions {
+  markMode?: MarkMode;
+  onExitBoundary?: ExitBoundaryHandler;
+  embedPaste?: boolean;
+  linkPaste?: boolean;
+  bulletAfterHeading?: boolean;
+  substitution?: boolean;
+  wikilinkEnabled?: boolean;
+  placeholder?: PlaceholderOptions$1['placeholder'];
+  readOnly?: boolean;
+  spellCheck?: boolean;
+  editorClassName?: string;
+}
+//#endregion
 //#region src/extensions/extension.d.ts
 declare function defineEditorExtensionImpl(options: EditorExtensionOptions): import("@prosekit/core").Union<readonly [import("@prosekit/core").Extension<{
   Nodes: import("@prosekit/core").SimplifyDeeper<{
@@ -872,7 +1232,7 @@ declare function defineEditorExtensionImpl(options: EditorExtensionOptions): imp
   Marks: {
     mdPack: MdPackAttrs;
   };
-}>]>, import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<import("@prosekit/core").ExtensionTyping<any, any, any>>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Union<readonly [import("@prosekit/core").Extension<{
+}>]>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<import("@prosekit/core").ExtensionTyping<any, any, any>>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Union<readonly [import("@prosekit/core").Extension<{
   Commands: {
     insertSoftBreak: [];
   };
@@ -890,498 +1250,151 @@ declare function defineEditorExtensionImpl(options: EditorExtensionOptions): imp
     updateLink: [attrs: LinkAttrs];
     removeLink: [];
   };
-}>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Union<readonly [import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<{
-  Commands: {
-    setMarkMode: [mode: MarkMode];
-  };
-}>]>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").BaseCommandsExtension, import("@prosekit/core").HistoryExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<{
+}>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").BaseCommandsExtension, import("@prosekit/core").HistoryExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<{
   Commands: {
     insertMarkdown: [markdown: string];
     insertTrigger: [text: string];
     scrollIntoView: [];
-    selectText: [anchor: number, head?: number | undefined];
-    selectTextBetween: [$anchor: import("@prosekit/pm/model").ResolvedPos, $head: import("@prosekit/pm/model").ResolvedPos, bias?: number | undefined];
-    turnIntoText: [];
-  };
-}>, import("@prosekit/core").Union<readonly [import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<{
-  Commands: {
-    startPendingReplacement: [options: StartPendingReplacementOptions];
-    appendPendingReplacementText: [text: string];
-    acceptPendingReplacement: [options?: AcceptPendingReplacementOptions | undefined];
-    discardPendingReplacement: [];
-  };
-}>, import("@prosekit/core").PlainExtension]>, import("@prosekit/core").Union<readonly [import("@prosekit/core").PlainExtension, import("@prosekit/extensions/search").SearchCommandsExtension, import("@prosekit/core").PlainExtension]>]>;
-type EditorExtension = ReturnType<typeof defineEditorExtensionImpl>;
-/**
- * Options for {@link defineEditorExtension}. Creation-time configuration:
- * `resolveFileLink`, `resolveWikiEmbed`, and `resolveWikilink` are baked into
- * the editor's parse pipeline, so changing them requires rebuilding the
- * editor; `markMode` is only the initial value.
- */
-type EditorExtensionOptions = InlineMarkOptions & {
-  /**
-   * The initial mark mode, applied from the first paint. Defaults to
-   * `'focus'`. Switch later with the `setMarkMode` command.
-   */
-  markMode?: MarkMode;
-};
-export declare function defineEditorExtension(options?: EditorExtensionOptions): EditorExtension;
-type TypedEditor = Editor<EditorExtension>;
-//#endregion
-//#region src/extensions/schema.d.ts
-type TypedNodeBuilders = ExtractNodeBuilders<EditorExtension>;
-type TypedMarkBuilders = ExtractMarkBuilders<EditorExtension>;
-/**
- * Typed mark builders bound to the shared schema.
- */
-export declare const getMarkBuilders: () => TypedMarkBuilders;
-//#endregion
-//#region src/converters/md-to-pm.d.ts
-/**
- * Options for {@link markdownToDoc}.
- */
-interface MarkdownToDocOptions {
-  /**
-   * Node builders to build the document with. Defaults to the shared schema's builders.
-   */
-  nodes?: TypedNodeBuilders;
-  /**
-   * Whether to peel a leading `---` frontmatter block onto the doc's `frontmatter` attribute. Off by default.
-   */
-  frontmatter?: boolean;
-}
-/**
- * Convert a markdown string into a ProseMirror document node.
- *
- * By default the document is built with the shared schema's node builders, so
- * no editor is required. When the result will be loaded into a specific editor,
- * pass that editor's `nodes` so the document uses the editor's own schema
- * instance and can be inserted without a JSON round trip.
- *
- * The output follows the extension set defined in `../extensions/extension.ts`
- * (doc, paragraph, text, heading, blockquote, list, codeBlock, table, tableRow,
- * tableCell, tableHeaderCell, horizontalRule). The function does not produce
- * inline marks because the markdown stays literal text - emphasis / link /
- * inline-code characters survive verbatim.
- */
-export declare function markdownToDoc(markdown: string, options?: MarkdownToDocOptions): ProseMirrorNode;
-//#endregion
-//#region src/converters/pm-to-md.d.ts
-/**
- * Options for {@link docToMarkdown}.
- */
-interface DocToMarkdownOptions {
-  /**
-   * Whether to serialize the doc's `frontmatter` attribute as a leading `---` block. Off by default.
-   */
-  frontmatter?: boolean;
-}
-/**
- * Convert a ProseMirror document into a Markdown string.
- *
- * Performance design:
- * - Output accumulates in a `string[]` buffer; joined once at the end.
- *   Avoids per-block intermediate strings while keeping the
- *   function-per-node-type readability of a switch dispatch.
- * - Indent stack lives as a mutable `linePrefix` on the buffer object,
- *   restored via local variables across nested calls - no fresh
- *   context objects per recursion.
- * - Inline content is walked directly (not via `node.textContent`) to
- *   skip one intermediate string allocation per leaf block.
- * - Backtick fence width and cell escaping use single linear loops, no
- *   regex on the hot path.
- */
-export declare function docToMarkdown(node: ProseMirrorNode, options?: DocToMarkdownOptions): string;
-//#endregion
-//#region src/extensions/bullet-after-heading.d.ts
-/**
- * "Type a title, press Return, start bullets." When this extension is applied,
- * pressing Enter at the end of the document's first heading (the title line)
- * drops the caret into a fresh empty bullet instead of a plain paragraph.
- */
-export declare function defineBulletAfterHeading(): PlainExtension;
-//#endregion
-//#region src/extensions/code-block-highlight.d.ts
-/**
- * Adds syntax highlighting to `codeBlock` nodes, parsing each block with the
- * matching CodeMirror/Lezer grammar (loaded on demand from
- * `@codemirror/language-data`). Tokens are tagged with `@lezer/highlight`
- * `tok-*` classes; the default theme colors them per color scheme.
- */
-export declare function defineCodeBlockSyntaxHighlight(): Extension;
-/**
- * A highlighted span of code: `[from, to)` carries the `@lezer/highlight` classes.
- */
-type CodeToken = readonly [from: number, to: number, classes: string];
-/**
- * Highlight `code` in `language` into `tok-*` token spans, the same classes the
- * editor's decorations use. Returns synchronously when the grammar is already
- * loaded (the common path, no render flash), and a `Promise` only when a grammar
- * must load on demand. Returns `[]` for an empty or unsupported language.
- */
-export declare function getCodeTokens(code: string, language: string): CodeToken[] | Promise<CodeToken[]>;
-//#endregion
-//#region src/extensions/code-block-languages.d.ts
-type LanguageItem = {
-  label: string;
-  value: string;
-};
-/**
- * A list of languages for code block syntax-highlight.
- */
-export declare const codeBlockLanguages: ReadonlyArray<LanguageItem>;
-//#endregion
-//#region src/extensions/embed-paste.d.ts
-/**
- * Auto-embed a pasted tweet or YouTube link. When the clipboard holds exactly
- * one such URL, the link is rewritten to `![](url)`, which the image pipeline
- * renders as a rich embed. Not part of `defineEditorExtension`; the React
- * package applies it via the `embedPaste` prop (on by default).
- */
-export declare function defineEmbedPaste(): PlainExtension;
-//#endregion
-//#region src/extensions/exit-boundary.d.ts
-/**
- * Payload for {@link ExitBoundaryHandler}.
- */
-interface ExitBoundaryOptions {
-  /**
-   * The boundary the caret would leave: `up` at the document start, `down` at the end.
-   */
-  direction: 'up' | 'down';
-  /**
-   * The originating arrow key press.
-   */
-  event: KeyboardEvent;
-}
-/**
- * Called when an arrow key press would move the caret past the document
- * boundary. Return `false` to let the editor handle the key normally; any
- * other return value consumes it.
- */
-type ExitBoundaryHandler = (options: ExitBoundaryOptions) => boolean | void;
-/**
- * Call `onExitBoundary` when an arrow key press would leave the document boundary.
- */
-export declare function defineExitBoundaryHandler(onExitBoundary: ExitBoundaryHandler): PlainExtension;
-//#endregion
-//#region src/extensions/file-click.d.ts
-/**
- * Payload for {@link FileClickHandler}.
- */
-interface FileClickPayload {
-  /**
-   * The resolved destination from `[name](href)` or a claimed `![[target]]`.
-   */
-  href: string;
-  /**
-   * The file name shown on the pill.
-   */
-  name: string;
-  /**
-   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the
-   * pill. Read modifier keys or position a popover from it.
-   */
-  event: MouseEvent | KeyboardEvent;
-  /**
-   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
-   * beyond the gesture that triggered the activation.
-   */
-  mod: boolean;
-}
-type FileClickHandler = (payload: FileClickPayload) => void;
-/**
- * Call `onClick` when the user clicks a rendered file pill, with the file's
- * `href`, `name`, and the originating `MouseEvent`. The host decides what a
- * click does (e.g. open the file in the OS default app).
- */
-export declare function defineFileClickHandler(onClick: FileClickHandler): PlainExtension;
-//#endregion
-//#region src/extensions/file-paste.d.ts
-type FilePasteHandler = (file: File) => string | undefined | Promise<string | undefined>;
-type FileSaveErrorHandler = (error: unknown, file: File) => void;
-/**
- * Options for {@link defineFilePaste}.
- */
-interface FilePasteOptions {
-  /**
-   * Persist a pasted/dropped file and return its markdown destination, or
-   * `undefined` to decline (nothing is inserted, but the event is consumed).
-   * An image (`image/*` MIME type or a recognized image filename extension)
-   * inserts `![](src)`; any other file inserts a `[name](src)` link.
-   */
-  onFilePaste?: FilePasteHandler;
-  /**
-   * Called when persisting a pasted/dropped file throws. Defaults to `console.error`.
-   */
-  onFileSaveError?: FileSaveErrorHandler;
-}
-/**
- * The markdown a saved file becomes: `![](destination)` for an image (a
- * `type` starting with `image/` or a recognized image filename extension), a
- * `[name](destination)` link otherwise, with `\`, `[`, and `]` escaped in the
- * name. Exported so a host command that inserts file links itself (e.g. an
- * attach-file picker) produces markdown byte-identical to a paste/drop.
- */
-export declare function buildFileMarkdown(file: {
-  name: string;
-  type?: string;
-}, destination: string): string;
-/**
- * Persist pasted/dropped files via `onFilePaste` and insert the returned
- * markdown destination: `![](src)` for an image, a `[name](src)` link for any
- * other file. Multiple files insert one link per line, in DataTransfer order.
- */
-export declare function defineFilePaste(options?: FilePasteOptions): PlainExtension;
-//#endregion
-//#region src/extensions/file-view.d.ts
-/**
- * Metadata a host resolves for one file link, shown on its pill.
- */
-interface FileInfo {
-  /**
-   * File size in bytes, shown as a human-readable suffix (e.g. `1.4 MB`).
-   */
-  size?: number;
-}
-/**
- * Resolve display metadata for a file `href`, directly or as a promise; the
- * pill renders immediately and fills the metadata in when the promise
- * settles. Return `undefined` for a file without metadata (e.g. one that no
- * longer exists). Called once per rendered pill, so the same `href` may
- * resolve repeatedly: cache in the host when resolving is expensive.
- */
-type FileInfoResolver = (href: string) => FileInfo | undefined | Promise<FileInfo | undefined>;
-/**
- * Options for {@link defineFileView}.
- */
-interface FileViewOptions {
-  /**
-   * Resolve the metadata (file size) shown on a pill. Omit to show none.
-   */
-  resolveFileInfo?: FileInfoResolver;
-}
+    selectText: [anchor: number, head?: number | undefined];
+    selectTextBetween: [$anchor: import("@prosekit/pm/model").ResolvedPos, $head: import("@prosekit/pm/model").ResolvedPos, bias?: number | undefined];
+    turnIntoText: [];
+  };
+}>, import("@prosekit/core").Union<readonly [import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<{
+  Commands: {
+    startPendingReplacement: [options: StartPendingReplacementOptions];
+    appendPendingReplacementText: [text: string];
+    acceptPendingReplacement: [options?: AcceptPendingReplacementOptions | undefined];
+    discardPendingReplacement: [];
+  };
+}>, import("@prosekit/core").PlainExtension]>, import("@prosekit/core").Union<readonly [import("@prosekit/core").PlainExtension, import("@prosekit/extensions/search").SearchCommandsExtension, import("@prosekit/core").PlainExtension]>]>;
+type EditorExtension = ReturnType<typeof defineEditorExtensionImpl>;
 /**
- * Classify a file destination for the pill's `data-file-kind` attribute.
+ * Initial configuration, updatable with `updateEditorConfig`.
  */
-export declare function getFileKind(href: string): string;
+type EditorExtensionOptions = EditorConfig;
+export declare function defineEditorExtension(options?: EditorExtensionOptions): EditorExtension;
+type TypedEditor = Editor<EditorExtension>;
+//#endregion
+//#region src/extensions/schema.d.ts
+type TypedNodeBuilders = ExtractNodeBuilders<EditorExtension>;
+type TypedMarkBuilders = ExtractMarkBuilders<EditorExtension>;
 /**
- * Render a claimed file link or wiki embed (the `mdFile` mark) as an inline
- * pill: a file-kind icon, the file name, and the size once
- * `resolveFileInfo` supplies it. The pill never loads the file's content;
- * clicks are reported through `defineFileClickHandler`.
+ * Typed mark builders bound to the shared schema.
  */
-export declare function defineFileView(options?: FileViewOptions): PlainExtension;
+export declare const getMarkBuilders: () => TypedMarkBuilders;
 //#endregion
-//#region src/extensions/image-click.d.ts
+//#region src/converters/md-to-pm.d.ts
 /**
- * Payload for {@link ImageClickHandler}.
+ * Options for {@link markdownToDoc}.
  */
-interface ImageClickPayload {
-  /**
-   * The resolved source from `![alt](src)` or a claimed `![[target]]`.
-   */
-  src: string;
-  /**
-   * The image alt text.
-   */
-  alt: string;
+interface MarkdownToDocOptions {
   /**
-   * The originating click or touch tap, or the `Enter`/`Mod-Enter` key press
-   * that followed the selected image. Read the target or position a popover
-   * from it; a touch surface delivers the `touchend` instead of a click.
+   * Node builders to build the document with. Defaults to the shared schema's builders.
    */
-  event: MouseEvent | TouchEvent | KeyboardEvent;
+  nodes?: TypedNodeBuilders;
   /**
-   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
-   * beyond the gesture that triggered the activation.
+   * Whether to peel a leading `---` frontmatter block onto the doc's `frontmatter` attribute. Off by default.
    */
-  mod: boolean;
+  frontmatter?: boolean;
 }
-type ImageClickHandler = (payload: ImageClickPayload) => void;
 /**
- * Call `onClick` when the user clicks or taps a rendered image preview, with
- * the image's markdown `src`, `alt`, and the originating event.
+ * Convert a markdown string into a ProseMirror document node.
  *
- * Touch taps are handled from `touchend` rather than the synthetic click:
- * previews live inside the editor contenteditable, and iOS WebKit's
- * tap-to-focus is a native gesture default action that only cancelling the
- * `touchend` can suppress — otherwise a tap briefly focuses the editor and
- * raises the software keyboard before the handler opens its own surface
- * (such as a lightbox).
- */
-export declare function defineImageClickHandler(onClick: ImageClickHandler): PlainExtension;
-//#endregion
-//#region src/extensions/link-click.d.ts
-interface LinkClickPayload {
-  href: string;
-  /**
-   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the link.
-   */
-  event: MouseEvent | KeyboardEvent;
-  /**
-   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
-   * beyond the gesture that triggered the activation.
-   */
-  mod: boolean;
-}
-type LinkClickHandler = (payload: LinkClickPayload) => void;
-interface LinkCopyPayload {
-  href: string;
-}
-type LinkCopyHandler = (payload: LinkCopyPayload) => void;
-/**
- * Call `onClick` when the user clicks a rendered Markdown link
- * (`[text](url)`), or presses `Mod-Enter` with the caret on one. The `event`
- * is the originating `MouseEvent` or `KeyboardEvent`.
+ * By default the document is built with the shared schema's node builders, so
+ * no editor is required. When the result will be loaded into a specific editor,
+ * pass that editor's `nodes` so the document uses the editor's own schema
+ * instance and can be inserted without a JSON round trip.
+ *
+ * The output follows the extension set defined in `../extensions/extension.ts`
+ * (doc, paragraph, text, heading, blockquote, list, codeBlock, table, tableRow,
+ * tableCell, tableHeaderCell, horizontalRule). The function does not produce
+ * inline marks because the markdown stays literal text - emphasis / link /
+ * inline-code characters survive verbatim.
  */
-export declare function defineLinkClickHandler(onClick: LinkClickHandler): PlainExtension;
+export declare function markdownToDoc(markdown: string, options?: MarkdownToDocOptions): ProseMirrorNode;
 //#endregion
-//#region src/extensions/tag-click.d.ts
-interface TagClickPayload {
-  /**
-   * The tag name, without the leading `#`.
-   */
-  tag: string;
-  /**
-   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the tag.
-   * Read modifier keys or position a popover from it.
-   */
-  event: MouseEvent | KeyboardEvent;
-  /**
-   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
-   * beyond the gesture that triggered the activation.
-   */
-  mod: boolean;
-}
-type TagClickHandler = (payload: TagClickPayload) => void;
+//#region src/converters/pm-to-md.d.ts
 /**
- * Call `onClick` when the user clicks a rendered `#tag`, or presses
- * `Mod-Enter` with the caret on one. The `tag` is read from the rendered text
- * without the leading `#`.
+ * Options for {@link docToMarkdown}.
  */
-export declare function defineTagClickHandler(onClick: TagClickHandler): PlainExtension;
-//#endregion
-//#region src/extensions/wikilink-click.d.ts
-interface WikilinkHit {
-  from: number;
-  to: number;
-  target: string;
-}
-interface WikilinkClickPayload {
-  target: string;
-  /**
-   * The originating click, or the `Enter`/`Mod-Enter` key press that followed the link.
-   */
-  event: MouseEvent | KeyboardEvent;
+interface DocToMarkdownOptions {
   /**
-   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
-   * beyond the gesture that triggered the activation.
+   * Whether to serialize the doc's `frontmatter` attribute as a leading `---` block. Off by default.
    */
-  mod: boolean;
+  frontmatter?: boolean;
 }
-type WikilinkClickHandler = (payload: WikilinkClickPayload) => void;
 /**
- * Call `onClick` when the user clicks a rendered wikilink label, or presses
- * `Mod-Enter` with the caret on one. The `event` is the originating
- * `MouseEvent` or `KeyboardEvent`.
+ * Convert a ProseMirror document into a Markdown string.
+ *
+ * Performance design:
+ * - Output accumulates in a `string[]` buffer; joined once at the end.
+ *   Avoids per-block intermediate strings while keeping the
+ *   function-per-node-type readability of a switch dispatch.
+ * - Indent stack lives as a mutable `linePrefix` on the buffer object,
+ *   restored via local variables across nested calls - no fresh
+ *   context objects per recursion.
+ * - Inline content is walked directly (not via `node.textContent`) to
+ *   skip one intermediate string allocation per leaf block.
+ * - Backtick fence width and cell escaping use single linear loops, no
+ *   regex on the hot path.
  */
-export declare function defineWikilinkClickHandler(onClick: WikilinkClickHandler): PlainExtension;
+export declare function docToMarkdown(node: ProseMirrorNode, options?: DocToMarkdownOptions): string;
 //#endregion
-//#region src/extensions/follow-link.d.ts
-interface FollowLinkHandlers {
-  onWikilinkClick?: WikilinkClickHandler;
-  onTagClick?: TagClickHandler;
-  onFileClick?: FileClickHandler;
-  onLinkClick?: LinkClickHandler;
-  onImageClick?: ImageClickHandler;
-}
+//#region src/extensions/bullet-after-heading.d.ts
 /**
- * Binds `Mod-Enter` to follow the wikilink, tag, file pill, or Markdown link
- * under the caret, and plain `Enter` to follow a selected atom unit (a
- * wikilink, file pill, or image), firing the same handlers a click does.
- * "Under the caret" means strictly inside the unit: a caret merely touching
- * a unit's edge is next to it, not on it.
- * Off a link, `Mod-Enter` falls through so the list keymap keeps cycling
- * checkbox tasks; off a selected unit, `Enter` falls through to the regular
- * split. High priority puts this ahead of every keymap binding.
- *
- * A selected-unit follow reports `mod: true` when the platform's mod key
- * (`⌘` on Apple, `Ctrl` elsewhere) was held beyond its plain-`Enter` trigger;
- * a caret follow always reports `mod: false`, its mod key being the trigger
- * itself.
+ * "Type a title, press Return, start bullets." When this extension is applied,
+ * pressing Enter at the end of the document's first heading (the title line)
+ * drops the caret into a fresh empty bullet instead of a plain paragraph.
  */
-export declare function defineFollowLinkHandler(handlers: FollowLinkHandlers): PlainExtension;
+export declare function defineBulletAfterHeading(enabled?: (state: EditorState) => boolean): PlainExtension;
 //#endregion
-//#region src/extensions/post-embed.d.ts
-type XPostResolver = Resolver<XPost>;
-type YouTubeVideoResolver = Resolver<YouTubeVideo>;
-type PostEmbedKind = 'x-post' | 'youtube-video';
+//#region src/extensions/code-block-highlight.d.ts
 /**
- * The post id of an X status URL, or `undefined` for any other `src`.
+ * Adds syntax highlighting to `codeBlock` nodes, parsing each block with the
+ * matching CodeMirror/Lezer grammar (loaded on demand from
+ * `@codemirror/language-data`). Tokens are tagged with `@lezer/highlight`
+ * `tok-*` classes; the default theme colors them per color scheme.
  */
-export declare function parseXPostId(src: string): string | undefined;
+export declare function defineCodeBlockSyntaxHighlight(): Extension;
 /**
- * The post-embed card an image `src` renders as, or `undefined` for a plain image.
+ * A highlighted span of code: `[from, to)` carries the `@lezer/highlight` classes.
  */
-export declare function matchPostEmbed(src: string): PostEmbedKind | undefined;
-export declare const defaultResolveXPost: XPostResolver;
-export declare const defaultResolveYouTubeVideo: YouTubeVideoResolver;
+type CodeToken = readonly [from: number, to: number, classes: string];
 /**
- * The `snapshot` field of an image's magic comment: the card kind and the
- * data post-embed renders. The kind is stored explicitly, so a saved snapshot
- * is validated once, against the schema it names.
+ * Highlight `code` in `language` into `tok-*` token spans, the same classes the
+ * editor's decorations use. Returns synchronously when the grammar is already
+ * loaded (the common path, no render flash), and a `Promise` only when a grammar
+ * must load on demand. Returns `[]` for an empty or unsupported language.
  */
-type PostEmbedSnapshot = {
-  kind: 'x-post';
-  data: XPost;
-} | {
-  kind: 'youtube-video';
-  data: YouTubeVideo;
+export declare function getCodeTokens(code: string, language: string): CodeToken[] | Promise<CodeToken[]>;
+//#endregion
+//#region src/extensions/code-block-languages.d.ts
+type LanguageItem = {
+  label: string;
+  value: string;
 };
 /**
- * The snapshot a card renders from a saved JSON object, or `undefined` when
- * the object does not validate. Unknown fields are dropped, so a persisted
- * snapshot is exactly what the card needs.
+ * A list of languages for code block syntax-highlight.
  */
-export declare function parsePostEmbedSnapshot(value: unknown): PostEmbedSnapshot | undefined;
+export declare const codeBlockLanguages: ReadonlyArray<LanguageItem>;
 //#endregion
-//#region src/extensions/image.d.ts
-type ImageUrlResolver = (src: string) => string | undefined;
-/**
- * Options for {@link defineImage}.
- */
-interface ImageOptions {
-  /**
-   * Map a markdown `src` to a displayable URL, or `undefined` to skip rendering
-   * that image. Defaults to `defaultResolveImageUrl`.
-   */
-  resolveImageUrl?: ImageUrlResolver;
-  /**
-   * Resolve the data behind an X post URL, rendered as a `post-embed-x-post`
-   * card. Defaults to `defaultResolveXPost`, which fetches through
-   * react-tweet's hosted proxy.
-   */
-  resolveXPost?: XPostResolver;
-  /**
-   * Resolve the data behind a YouTube video URL, rendered as a
-   * `post-embed-youtube-video` card. Defaults to `defaultResolveYouTubeVideo`,
-   * which reads YouTube's oEmbed endpoint.
-   */
-  resolveYouTubeVideo?: YouTubeVideoResolver;
-}
+//#region src/extensions/editor-config-getter.d.ts
 /**
- * Show an `src` as-is when it is an http(s) URL, otherwise skip rendering it.
+ * Read the current configuration. Callback values are live, not historical state snapshots.
  */
-export declare function defaultResolveImageUrl(src: string): string | undefined;
+export declare function getEditorConfig(state: EditorState): Readonly<EditorConfig>;
+//#endregion
+//#region src/extensions/editor-config.d.ts
+export declare function updateEditorConfig(editor: Pick<Editor, 'state' | 'view' | 'mounted' | 'updateState'>, patch: Partial<EditorConfig>): void;
+//#endregion
+//#region src/extensions/embed-paste.d.ts
 /**
- * Inline image/embed rendering: a mark view on the `mdImage` mark. Images
- * render in place from their literal Markdown source. Drag a rendered image's
- * corner handle to write the size back into the source as a trailing comment,
- * `![alt](src)<!-- {"width":320,"height":240} -->`, which round-trips as
- * plain Markdown.
+ * Auto-embed a pasted tweet or YouTube link. When the clipboard holds exactly
+ * one such URL, the link is rewritten to `![](url)`, which the image pipeline
+ * renders as a rich embed. Enable it through the `embedPaste` configuration
+ * or install this standalone extension.
  */
-export declare function defineImage(options?: ImageOptions): PlainExtension;
+export declare function defineEmbedPaste(enabled?: (state: EditorState) => boolean): PlainExtension;
 //#endregion
 //#region src/extensions/key-bindings.d.ts
 /**
@@ -1452,10 +1465,10 @@ export declare function defineLinkHoverHandler(onHoverChange: LinkHoverHandler,
  * Registered with `Priority.high` so its `handlePaste` runs before
  * `defineEmbedPaste`'s: pasting an embeddable URL (tweet/YouTube) over a
  * selection keeps the selected text as a link instead of discarding it for an
- * embed. Not part of `defineEditorExtension`; the React package applies it via
- * the `linkPaste` prop (on by default).
+ * embed. Enable it through the `linkPaste` configuration or install this
+ * standalone extension.
  */
-export declare function defineLinkPaste(): PlainExtension;
+export declare function defineLinkPaste(enabled?: (state: EditorState) => boolean): PlainExtension;
 //#endregion
 //#region src/extensions/link-preview.d.ts
 /**
@@ -1496,7 +1509,7 @@ export declare function isNodeOfType(node: ProseMirrorNode, name: NodeName): boo
 /**
  * Apply the editor's automatic plain-text substitutions.
  */
-export declare function defineSubstitution(): PlainExtension;
+export declare function defineSubstitution(enabled?: (state: EditorState) => boolean): PlainExtension;
 //#endregion
 //#region src/extensions/table.d.ts
 /**
@@ -1564,7 +1577,7 @@ export declare function defineWikilinkHoverHandler(onHoverChange: WikilinkHoverH
  * Binds `Mod-Shift-k` to open the wikilink menu, and `[` to wrap a selected
  * phrase into an open wikilink (`[[phrase`) with the menu searching it.
  */
-export declare function defineWikilinkTrigger(): PlainExtension;
+export declare function defineWikilinkTrigger(enabled?: (state: EditorState) => boolean): PlainExtension;
 //#endregion
 //#region src/utils/composition.d.ts
 export declare function getIsComposing(): boolean;
@@ -1629,4 +1642,4 @@ export declare function getSelectedText(state: EditorState): string;
  */
 export declare function getVirtualElementFromRange(view: EditorView, range: PositionRange): VirtualElement;
 //#endregion
-export { type AcceptPendingReplacementOptions, type CheckRoundTripOptions, type CodeBlockAttrs, type CodeBlockFenceStyle, type CodeToken, type DocToMarkdownOptions, type EditorExtension, type EditorExtensionOptions, type ExitBoundaryHandler, type ExitBoundaryOptions, type FileClickHandler, type FileClickPayload, type FileInfo, type FileInfoResolver, type FileLinkOptions, type FileLinkPayload, type FileLinkResolver, type FilePasteHandler, type FilePasteOptions, type FileSaveErrorHandler, type FileViewOptions, type FollowLinkHandlers, type ImageClickHandler, type ImageClickPayload, type ImageOptions, type InlineMarkContext, type InlineMarkOptions, type KaTeXRender, type LanguageItem, type LinkAttrs, type LinkClickHandler, type LinkClickPayload, type LinkCopyHandler, type LinkCopyPayload, type LinkEditHandler, type LinkEditOptions, type LinkHoverHandler, type LinkHoverOptions, type LinkPreview, type LinkPreviewResolver, type LinkUnit, type ListMarker, type MarkChunk, type MarkMode, type MarkName, type MarkdownToDocOptions, type MdFileAttrs, type MdImageAttrs, type MdLinkTextAttrs, type MdMathAttrs, type MdWikilinkAttrs, type MeowdownCodeBlockAttrs, type MeowdownHTMLCommentAttrs, type MeowdownListAttrs, type MeowdownTableCellAttrs, type NodeName, type ParsedWikiEmbed, type PendingReplacement, type PendingReplacementEvent, type PendingReplacementHandler, type PendingReplacementMode, type PendingReplacementOutcome, type PlaceholderOptions, type PositionRange, type PostEmbedKind, type PostEmbedSnapshot, Priority, type ReferenceDefinition, type ReferenceDefinitionIndex, type ReferenceDefinitions, type RoundTripFidelity, type SearchStatus, type SearchStatusHandler, type StartPendingReplacementOptions, type TableColumnAlign, type TagClickHandler, type TagClickPayload, type TypedEditor, type TypedMarkBuilders, type VirtualElement, type WikiEmbedOptions, type WikiEmbedResolution, type WikiEmbedResolver, type WikilinkClickHandler, type WikilinkClickPayload, type WikilinkHoverHandler, type WikilinkHoverHit, type WikilinkOptions, type WikilinkPayload, type WikilinkResolution, type WikilinkResolver, type XPostResolver, type YouTubeVideoResolver, defineCodeBlockPreviewPlugin, definePlaceholder, defineReadonly, defineSearchStatusHandler, getSearchStatus, isCodeBlockPreviewHiddenDecoration, withPriority };
+export { type AcceptPendingReplacementOptions, type CheckRoundTripOptions, type CodeBlockAttrs, type CodeBlockFenceStyle, type CodeToken, type DocToMarkdownOptions, type EditorConfig, type EditorExtension, type EditorExtensionOptions, type ExitBoundaryHandler, type ExitBoundaryOptions, type FileClickHandler, type FileClickPayload, type FileInfo, type FileInfoResolver, type FileLinkOptions, type FileLinkPayload, type FileLinkResolver, type FilePasteHandler, type FilePasteOptions, type FileSaveErrorHandler, type FileViewOptions, type FollowLinkHandlers, type ImageClickHandler, type ImageClickPayload, type ImageOptions, type InlineMarkContext, type InlineMarkOptions, type KaTeXRender, type LanguageItem, type LinkAttrs, type LinkClickHandler, type LinkClickPayload, type LinkCopyHandler, type LinkCopyPayload, type LinkEditHandler, type LinkEditOptions, type LinkHoverHandler, type LinkHoverOptions, type LinkPreview, type LinkPreviewResolver, type LinkUnit, type ListMarker, type MarkChunk, type MarkMode, type MarkName, type MarkdownToDocOptions, type MdFileAttrs, type MdImageAttrs, type MdLinkTextAttrs, type MdMathAttrs, type MdWikilinkAttrs, type MeowdownCodeBlockAttrs, type MeowdownHTMLCommentAttrs, type MeowdownListAttrs, type MeowdownTableCellAttrs, type NodeName, type ParsedWikiEmbed, type PendingReplacement, type PendingReplacementEvent, type PendingReplacementHandler, type PendingReplacementMode, type PendingReplacementOutcome, type PlaceholderOptions, type PositionRange, type PostEmbedKind, type PostEmbedSnapshot, Priority, type ReferenceDefinition, type ReferenceDefinitionIndex, type ReferenceDefinitions, type RoundTripFidelity, type SearchStatus, type SearchStatusHandler, type StartPendingReplacementOptions, type TableColumnAlign, type TagClickHandler, type TagClickPayload, type TypedEditor, type TypedMarkBuilders, type VirtualElement, type WikiEmbedOptions, type WikiEmbedResolution, type WikiEmbedResolver, type WikilinkClickHandler, type WikilinkClickPayload, type WikilinkHoverHandler, type WikilinkHoverHit, type WikilinkOptions, type WikilinkPayload, type WikilinkResolution, type WikilinkResolver, type XPostResolver, type YouTubeVideoResolver, defineCodeBlockPreviewPlugin, definePlaceholder, defineSearchStatusHandler, getSearchStatus, isCodeBlockPreviewHiddenDecoration, parseXPostId, withPriority };