@thescaffold/editor-addons 0.0.0

package/dist/index.d.mts

@@ -0,0 +1,864 @@
+import { AddonDefinition, EditorContext, AddonInstance, SchemaContext, CollabConfig, Addon } from '@thescaffold/editor-core';
+
+declare function CommandsAddon(): AddonDefinition;
+declare const CommandsAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare function HistoryAddon(): AddonDefinition;
+declare const HistoryAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare function InputRulesAddon(): AddonDefinition;
+declare const InputRulesAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+
+interface KeymapAddonConfig {
+    overrides?: Record<string, string>;
+    disabled?: string[];
+}
+declare function KeymapAddon(config?: KeymapAddonConfig): AddonDefinition<KeymapAddonConfig>;
+declare const KeymapAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: KeymapAddonConfig): AddonInstance;
+};
+
+interface SchemaAddonConfig {
+    nodes?: string[];
+    marks?: string[];
+}
+declare function SchemaAddon(config?: SchemaAddonConfig): AddonDefinition<SchemaAddonConfig>;
+declare const SchemaAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext, _config?: SchemaAddonConfig): void;
+    init(_ctx: EditorContext, _config?: SchemaAddonConfig): AddonInstance;
+};
+
+declare function BoldAddon(): AddonDefinition;
+declare const BoldAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function ItalicAddon(): AddonDefinition;
+declare const ItalicAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function UnderlineAddon(): AddonDefinition;
+declare const UnderlineAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function StrikethroughAddon(): AddonDefinition;
+declare const StrikethroughAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function InlineCodeAddon(): AddonDefinition;
+declare const InlineCodeAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function SubscriptAddon(): AddonDefinition;
+declare const SubscriptAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function SuperscriptAddon(): AddonDefinition;
+declare const SuperscriptAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface HighlightAddonConfig {
+    colors?: string[];
+    defaultColor?: string;
+}
+declare function HighlightAddon(config?: HighlightAddonConfig): AddonDefinition<HighlightAddonConfig>;
+declare const HighlightAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext, config?: HighlightAddonConfig): AddonInstance;
+};
+interface TextColorAddonConfig {
+    colors?: string[];
+    defaultColor?: string;
+}
+declare function TextColorAddon(config?: TextColorAddonConfig): AddonDefinition<TextColorAddonConfig>;
+declare const TextColorAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext, config?: TextColorAddonConfig): AddonInstance;
+};
+interface FontFamilyAddonConfig {
+    families: {
+        label: string;
+        value: string;
+    }[];
+}
+declare function FontFamilyAddon(config: FontFamilyAddonConfig): AddonDefinition<FontFamilyAddonConfig>;
+declare const FontFamilyAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface FontSizeAddonConfig {
+    sizes?: string[];
+    defaultSize?: string;
+}
+declare function FontSizeAddon(config?: FontSizeAddonConfig): AddonDefinition<FontSizeAddonConfig>;
+declare const FontSizeAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function ClearFormattingAddon(): AddonDefinition;
+declare const ClearFormattingAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare function AlignmentAddon(): AddonDefinition;
+declare const AlignmentAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface LineHeightAddonConfig {
+    options?: number[];
+}
+declare function LineHeightAddon(config?: LineHeightAddonConfig): AddonDefinition<LineHeightAddonConfig>;
+declare const LineHeightAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function ParagraphSpacingAddon(): AddonDefinition;
+declare const ParagraphSpacingAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function IndentAddon(): AddonDefinition;
+declare const IndentAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare function HeadingsAddon(): AddonDefinition;
+declare const HeadingsAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function BlockquoteAddon(): AddonDefinition;
+declare const BlockquoteAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function DividerAddon(): AddonDefinition;
+declare const DividerAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function PageBreakAddon(): AddonDefinition;
+declare const PageBreakAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+type CalloutType = "info" | "success" | "warning" | "error" | "tip" | "note";
+interface CalloutAddonConfig {
+    types?: CalloutType[];
+}
+declare function CalloutAddon(config?: CalloutAddonConfig): AddonDefinition<CalloutAddonConfig>;
+declare const CalloutAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext, config?: CalloutAddonConfig): AddonInstance;
+};
+declare function DetailsAddon(): AddonDefinition;
+declare const DetailsAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface ColumnsAddonConfig {
+    maxColumns?: number;
+    ratios?: string[];
+}
+declare function ColumnsAddon(config?: ColumnsAddonConfig): AddonDefinition<ColumnsAddonConfig>;
+declare const ColumnsAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext, config?: ColumnsAddonConfig): AddonInstance;
+};
+interface CodeBlockAddonConfig {
+    languages?: string[];
+    defaultLanguage?: string;
+    lineNumbers?: boolean;
+    lineWrapping?: boolean;
+}
+declare function CodeBlockAddon(config?: CodeBlockAddonConfig): AddonDefinition<CodeBlockAddonConfig>;
+declare const CodeBlockAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare function BulletListAddon(): AddonDefinition;
+declare const BulletListAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function OrderedListAddon(): AddonDefinition;
+declare const OrderedListAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function TaskListAddon(): AddonDefinition;
+declare const TaskListAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function ToggleListAddon(): AddonDefinition;
+declare const ToggleListAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function ListsAddon(): AddonDefinition[];
+
+interface TableAddonConfig {
+    /**
+     * For full cell-selection, Tab navigation, and column resize handles you
+     * need prosemirror-tables' `tableEditing()` and (optionally)
+     * `columnResizing()` plugins. Inject them at editor construction via
+     * `EditorConfig.extraPlugins`:
+     *
+     * ```ts
+     * import { tableEditing, columnResizing } from 'prosemirror-tables';
+     *
+     * el.config = {
+     *   addons: [TableAddon(), ...others],
+     *   extraPlugins: [columnResizing({}), tableEditing()],
+     * };
+     * ```
+     *
+     * The flag is kept on the config for API symmetry with prior versions and
+     * for downstream tooling that wants to flip a single switch — at runtime
+     * the editor itself doesn't read it, the user owns the plugin list.
+     */
+    resizable?: boolean;
+    /** Soft cap on cols inserted via insertTable. Default 20. */
+    maxCols?: number;
+    /** Soft cap on rows inserted via insertTable. Default 100. */
+    maxRows?: number;
+}
+declare function TableAddon(config?: TableAddonConfig): AddonDefinition<TableAddonConfig>;
+declare const TableAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext, config?: TableAddonConfig): AddonInstance;
+};
+
+interface ImageAddonConfig {
+    upload: (file: File) => Promise<string>;
+    maxSizeMB?: number;
+    allowedTypes?: string[];
+    defaultAlign?: "left" | "center" | "right" | "full";
+}
+declare function ImageAddon(config: ImageAddonConfig): AddonDefinition<ImageAddonConfig>;
+declare const ImageAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface VideoAddonConfig {
+    upload?: (file: File) => Promise<string>;
+    providers?: ("youtube" | "vimeo" | "loom")[];
+}
+declare function VideoAddon(config?: VideoAddonConfig): AddonDefinition<VideoAddonConfig>;
+declare const VideoAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface AudioAddonConfig {
+    upload?: (file: File) => Promise<string>;
+}
+declare function AudioAddon(config?: AudioAddonConfig): AddonDefinition<AudioAddonConfig>;
+declare const AudioAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface FileAddonConfig {
+    upload: (file: File) => Promise<{
+        url: string;
+        name: string;
+        size: number;
+        mimeType: string;
+    }>;
+    maxSizeMB?: number;
+}
+declare function FileAddon(config: FileAddonConfig): AddonDefinition<FileAddonConfig>;
+declare const FileAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface EmbedProvider {
+    id: string;
+    name: string;
+    match: RegExp;
+    toEmbedUrl: (url: string) => string;
+}
+interface EmbedAddonConfig {
+    providers?: EmbedProvider[];
+    allowedDomains?: string[];
+}
+declare function EmbedAddon(config?: EmbedAddonConfig): AddonDefinition<EmbedAddonConfig>;
+declare const EmbedAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface OGMetadata {
+    title?: string;
+    description?: string;
+    image?: string;
+    favicon?: string;
+    url: string;
+}
+interface BookmarkAddonConfig {
+    fetchMetadata: (url: string) => Promise<OGMetadata>;
+}
+declare function BookmarkAddon(config: BookmarkAddonConfig): AddonDefinition<BookmarkAddonConfig>;
+declare const BookmarkAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+interface LinkAddonConfig {
+    autoLink?: boolean;
+    defaultTarget?: "_blank" | "_self";
+    validate?: (url: string) => boolean;
+}
+declare function LinkAddon(config?: LinkAddonConfig): AddonDefinition<LinkAddonConfig>;
+declare const LinkAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext, config?: LinkAddonConfig): AddonInstance;
+};
+interface MentionItem {
+    id: string;
+    label: string;
+    [key: string]: unknown;
+}
+interface MentionType {
+    id: string;
+    trigger?: string;
+    search(query: string): Promise<MentionItem[]>;
+    renderItem?: (item: MentionItem) => HTMLElement;
+    renderNode?: (item: MentionItem) => HTMLElement;
+}
+interface MentionAddonConfig {
+    trigger?: string;
+    types: MentionType[];
+}
+declare function MentionAddon(config: MentionAddonConfig): AddonDefinition<MentionAddonConfig>;
+declare const MentionAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface EmojiAddonConfig {
+    trigger?: string;
+    skinTone?: number;
+}
+declare function EmojiAddon(config?: EmojiAddonConfig): AddonDefinition<EmojiAddonConfig>;
+declare const EmojiAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface EquationAddonConfig {
+    katexOptions?: Record<string, unknown>;
+    macros?: Record<string, string>;
+}
+declare function EquationAddon(config?: EquationAddonConfig): AddonDefinition<EquationAddonConfig>;
+declare const EquationAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function FootnoteAddon(): AddonDefinition;
+declare const FootnoteAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface PersonProvider {
+    search(query: string): Promise<{
+        id: string;
+        name: string;
+        avatar?: string;
+    }[]>;
+}
+interface FileChipProvider {
+    search(query: string): Promise<{
+        id: string;
+        name: string;
+        icon?: string;
+    }[]>;
+}
+interface SmartChipAddonConfig {
+    date?: {
+        formats?: string[];
+        relative?: boolean;
+    };
+    person?: {
+        provider: PersonProvider;
+    };
+    place?: {
+        mapProvider?: "google" | "osm";
+    };
+    file?: {
+        provider: FileChipProvider;
+    };
+    variables?: {
+        variables: Record<string, string>;
+    };
+}
+declare function SmartChipAddon(config?: SmartChipAddonConfig): AddonDefinition<SmartChipAddonConfig>;
+declare const SmartChipAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+type CommandGroupMode = "inline" | "popover";
+type CommandGroupDensity = "comfortable" | "compact";
+type CommandGroupOrientation = "horizontal" | "vertical";
+interface CommandGroupOptions {
+    /** Command IDs to render, in order. Unknown IDs are skipped. */
+    commands: string[];
+    /** Accessible label for the group (role="group" aria-label). */
+    label?: string;
+    /** Inline = toolbar style; popover = bubble/slash/link-editor style. */
+    mode?: CommandGroupMode;
+    /** Comfortable default; compact for popovers. */
+    density?: CommandGroupDensity;
+    /** Sets aria-orientation and flex direction. */
+    orientation?: CommandGroupOrientation;
+    /** Render the command label next to the icon. */
+    showLabels?: boolean;
+    /** Show the title (tooltip) attribute. */
+    showTooltips?: boolean;
+    /** Command IDs that are currently in a loading state. */
+    loading?: Set<string>;
+    /** Optional intercept; defaults to ctx.execCommand(cmd.id). */
+    onActivate?: (cmdId: string) => void;
+}
+interface CommandGroupHandle {
+    readonly el: HTMLElement;
+    /** Re-evaluate isEnabled/isActive/loading and update DOM state. Idempotent. */
+    update(): void;
+    /** Move focus to the first non-disabled button. No-op if all disabled. */
+    focusFirst(): void;
+    /** Move focus to the last non-disabled button. No-op if all disabled. */
+    focusLast(): void;
+    /** Update the loading set without recreating the group. */
+    setLoading(loading: Set<string>): void;
+    /** Remove the group and detach listeners. */
+    destroy(): void;
+}
+declare function createCommandGroup(ctx: EditorContext, opts: CommandGroupOptions): CommandGroupHandle;
+
+interface ToolbarGroup {
+    label?: string;
+    commands: string[];
+}
+interface ToolbarAddonConfig {
+    position?: "top" | "bottom" | "sticky";
+    groups?: ToolbarGroup[];
+    overflow?: "scroll" | "dropdown";
+    showLabels?: boolean;
+    showTooltips?: boolean;
+}
+declare function ToolbarAddon(config?: ToolbarAddonConfig): AddonDefinition<ToolbarAddonConfig>;
+declare const ToolbarAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: ToolbarAddonConfig): AddonInstance;
+};
+interface BubbleMenuAddonConfig {
+    commands?: string[];
+    showOnCode?: boolean;
+    delay?: number;
+}
+declare function BubbleMenuAddon(config?: BubbleMenuAddonConfig): AddonDefinition<BubbleMenuAddonConfig>;
+declare const BubbleMenuAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: BubbleMenuAddonConfig): AddonInstance;
+};
+interface SlashGroup {
+    label: string;
+    commands: string[];
+}
+interface SlashMenuAddonConfig {
+    trigger?: string;
+    groups?: SlashGroup[];
+    maxVisible?: number;
+}
+declare function SlashMenuAddon(config?: SlashMenuAddonConfig): AddonDefinition<SlashMenuAddonConfig>;
+declare const SlashMenuAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: SlashMenuAddonConfig): AddonInstance;
+};
+interface CommandPaletteAddonConfig {
+    shortcut?: string;
+    placeholder?: string;
+    maxRecent?: number;
+}
+declare function CommandPaletteAddon(config?: CommandPaletteAddonConfig): AddonDefinition<CommandPaletteAddonConfig>;
+declare const CommandPaletteAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, _config?: CommandPaletteAddonConfig): AddonInstance;
+};
+interface BlockHandlesAddonConfig {
+    showAddButton?: boolean;
+    addButtonCommand?: string;
+}
+declare function BlockHandlesAddon(config?: BlockHandlesAddonConfig): AddonDefinition<BlockHandlesAddonConfig>;
+declare const BlockHandlesAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+declare function ContextMenuAddon(): AddonDefinition;
+declare const ContextMenuAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+type StatusBarSlot = "wordCount" | "charCount" | "readingTime" | "cursorPos" | "peers" | "saveStatus";
+interface StatusBarAddonConfig {
+    slots?: StatusBarSlot[];
+}
+declare function StatusBarAddon(config?: StatusBarAddonConfig): AddonDefinition<StatusBarAddonConfig>;
+declare const StatusBarAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: StatusBarAddonConfig): AddonInstance;
+};
+
+interface TableOfContentsAddonConfig {
+    headingLevels?: number[];
+    sidePanel?: boolean;
+}
+declare function TableOfContentsAddon(config?: TableOfContentsAddonConfig): AddonDefinition<TableOfContentsAddonConfig>;
+declare const TableOfContentsAddonImpl: {
+    id: string;
+    initSchema(ctx: SchemaContext): void;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function OutlineAddon(): AddonDefinition;
+declare const OutlineAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+interface CoverAddonConfig {
+    upload?: (file: File) => Promise<string>;
+    gradients?: string[];
+}
+declare function CoverAddon(config?: CoverAddonConfig): AddonDefinition<CoverAddonConfig>;
+declare const CoverAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface BreadcrumbItem {
+    id: string;
+    label: string;
+    href?: string;
+}
+interface BreadcrumbProvider {
+    getPath(docId: string): Promise<BreadcrumbItem[]>;
+}
+interface BreadcrumbAddonConfig {
+    provider: BreadcrumbProvider;
+}
+declare function BreadcrumbAddon(config: BreadcrumbAddonConfig): AddonDefinition<BreadcrumbAddonConfig>;
+declare const BreadcrumbAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+declare function TemplatesAddon(): AddonDefinition;
+declare const TemplatesAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface PageSetupAddonConfig {
+    size?: "A4" | "Letter" | "Legal";
+    orientation?: "portrait" | "landscape";
+    margins?: {
+        top: string;
+        right: string;
+        bottom: string;
+        left: string;
+    };
+}
+declare function PageSetupAddon(config?: PageSetupAddonConfig): AddonDefinition<PageSetupAddonConfig>;
+declare const PageSetupAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare function ContentAddon(): AddonDefinition;
+declare const ContentAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function DocxAddon(): AddonDefinition;
+declare const DocxAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function PdfAddon(): AddonDefinition;
+declare const PdfAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function PrintAddon(): AddonDefinition;
+declare const PrintAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare function SearchAddon(): AddonDefinition;
+declare const SearchAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function SpellCheckAddon(): AddonDefinition;
+declare const SpellCheckAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+declare function GrammarAddon(): AddonDefinition;
+declare const GrammarAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+interface AutoSaveAddonConfig {
+    save: (content: string, format: string) => Promise<void>;
+    interval?: number;
+    format?: "json" | "html" | "markdown";
+}
+declare function AutoSaveAddon(config: AutoSaveAddonConfig): AddonDefinition<AutoSaveAddonConfig>;
+declare const AutoSaveAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config: AutoSaveAddonConfig): AddonInstance;
+};
+interface ReadOnlyAddonConfig {
+    readOnly?: boolean;
+}
+declare function ReadOnlyAddon(config?: ReadOnlyAddonConfig): AddonDefinition<ReadOnlyAddonConfig>;
+declare const ReadOnlyAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: ReadOnlyAddonConfig): AddonInstance;
+};
+
+declare function CollabAddon(config?: CollabConfig): AddonDefinition<CollabConfig>;
+declare const CollabAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, _config?: CollabConfig): AddonInstance;
+};
+interface AwarenessAddonConfig {
+    identity?: {
+        id: string;
+        name: string;
+        color: string;
+    };
+    /**
+     * Opaque schema version stamped into awareness state. The binder emits
+     * `collab:error { phase: 'schema-mismatch' }` if a peer's schemaVersion
+     * differs from this one. Pin per-release so a rolling deploy with an
+     * incompatible PM schema fails loudly instead of silently diverging.
+     */
+    schemaVersion?: string;
+}
+declare function AwarenessAddon(config?: AwarenessAddonConfig): AddonDefinition<AwarenessAddonConfig>;
+declare const AwarenessAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: AwarenessAddonConfig): AddonInstance;
+};
+declare function PresenceAddon(): AddonDefinition;
+declare const PresenceAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+interface CommentProvider {
+    getComments(docId: string): Promise<Comment[]>;
+    addComment(docId: string, range: {
+        from: number;
+        to: number;
+    }, text: string): Promise<Comment>;
+    resolveComment(id: string): Promise<void>;
+    deleteComment(id: string): Promise<void>;
+}
+interface Comment {
+    id: string;
+    from: number;
+    to: number;
+    text: string;
+    author: string;
+    createdAt: string;
+    resolved: boolean;
+    replies: Comment[];
+}
+interface CommentsAddonConfig {
+    provider: CommentProvider;
+}
+declare function CommentsAddon(config: CommentsAddonConfig): AddonDefinition<CommentsAddonConfig>;
+declare const CommentsAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function SuggestionsAddon(): AddonDefinition;
+declare const SuggestionsAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function VersionAddon(): AddonDefinition;
+declare const VersionAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+interface CodeAddonConfig {
+    language?: string;
+    theme?: string;
+    lineNumbers?: boolean;
+}
+declare function CodeAddon(config?: CodeAddonConfig): AddonDefinition<CodeAddonConfig>;
+declare const CodeAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+declare function LineNumbersAddon(): AddonDefinition;
+declare const LineNumbersAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+declare function CodeFoldingAddon(): AddonDefinition;
+declare const CodeFoldingAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function BracketMatchingAddon(): AddonDefinition;
+declare const BracketMatchingAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+interface CodeAutoCompleteAddonConfig {
+    completionSource?: unknown;
+}
+declare function CodeAutoCompleteAddon(config?: CodeAutoCompleteAddonConfig): AddonDefinition<CodeAutoCompleteAddonConfig>;
+declare const CodeAutoCompleteAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+interface CodeLintAddonConfig {
+    linter: unknown;
+    delay?: number;
+}
+declare function CodeLintAddon(config: CodeLintAddonConfig): AddonDefinition<CodeLintAddonConfig>;
+declare const CodeLintAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+interface DiffAddonConfig {
+    original: string;
+    mode?: "side-by-side" | "unified";
+    highlightChanges?: boolean;
+    gutter?: boolean;
+}
+declare function DiffAddon(config: DiffAddonConfig): AddonDefinition<DiffAddonConfig>;
+declare const DiffAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function MiniMapAddon(): AddonDefinition;
+declare const MiniMapAddonImpl: {
+    id: string;
+    init(_ctx: EditorContext): AddonInstance;
+};
+
+interface PlaceholderAddonConfig {
+    text: string;
+    showOnlyWhenFocused?: boolean;
+}
+declare function PlaceholderAddon(config: PlaceholderAddonConfig): AddonDefinition<PlaceholderAddonConfig>;
+declare const PlaceholderAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config: PlaceholderAddonConfig): AddonInstance;
+};
+interface CountAddonConfig {
+    wordsPerMinute?: number;
+    showIn?: ("statusbar" | "tooltip")[];
+}
+declare function CountAddon(config?: CountAddonConfig): AddonDefinition<CountAddonConfig>;
+declare const CountAddonImpl: {
+    id: string;
+    init(ctx: EditorContext, config?: CountAddonConfig): AddonInstance;
+};
+declare function ReadingTimeAddon(): AddonDefinition;
+declare const ReadingTimeAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface FocusModeAddonConfig {
+    dimInactive?: boolean;
+    typewriterScroll?: boolean;
+}
+declare function FocusModeAddon(config?: FocusModeAddonConfig): AddonDefinition<FocusModeAddonConfig>;
+declare const FocusModeAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function FullScreenAddon(): AddonDefinition;
+declare const FullScreenAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+declare function AccessibilityAddon(): AddonDefinition;
+declare const AccessibilityAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+interface MarkdownAddonConfig {
+    defaultMode?: "wysiwyg" | "raw";
+    showPreview?: boolean;
+    sanitizeHtml?: (html: string) => string;
+}
+declare function MarkdownAddon(config?: MarkdownAddonConfig): AddonDefinition<MarkdownAddonConfig>;
+declare const MarkdownAddonImpl: {
+    id: string;
+    init(ctx: EditorContext): AddonInstance;
+};
+
+declare const ADDON_IMPLEMENTATIONS: Map<string, Addon>;
+
+export { ADDON_IMPLEMENTATIONS, AccessibilityAddon, AccessibilityAddonImpl, AlignmentAddon, AlignmentAddonImpl, AudioAddon, type AudioAddonConfig, AudioAddonImpl, AutoSaveAddon, type AutoSaveAddonConfig, AutoSaveAddonImpl, AwarenessAddon, type AwarenessAddonConfig, AwarenessAddonImpl, BlockHandlesAddon, type BlockHandlesAddonConfig, BlockHandlesAddonImpl, BlockquoteAddon, BlockquoteAddonImpl, BoldAddon, BoldAddonImpl, BookmarkAddon, type BookmarkAddonConfig, BookmarkAddonImpl, BracketMatchingAddon, BracketMatchingAddonImpl, BreadcrumbAddon, type BreadcrumbAddonConfig, BreadcrumbAddonImpl, type BreadcrumbItem, type BreadcrumbProvider, BubbleMenuAddon, type BubbleMenuAddonConfig, BubbleMenuAddonImpl, BulletListAddon, BulletListAddonImpl, CalloutAddon, type CalloutAddonConfig, CalloutAddonImpl, type CalloutType, ClearFormattingAddon, ClearFormattingAddonImpl, CodeAddon, type CodeAddonConfig, CodeAddonImpl, CodeAutoCompleteAddon, type CodeAutoCompleteAddonConfig, CodeAutoCompleteAddonImpl, CodeBlockAddon, type CodeBlockAddonConfig, CodeBlockAddonImpl, CodeFoldingAddon, CodeFoldingAddonImpl, CodeLintAddon, type CodeLintAddonConfig, CodeLintAddonImpl, CollabAddon, CollabAddonImpl, ColumnsAddon, type ColumnsAddonConfig, ColumnsAddonImpl, type CommandGroupDensity, type CommandGroupHandle, type CommandGroupMode, type CommandGroupOptions, type CommandGroupOrientation, CommandPaletteAddon, type CommandPaletteAddonConfig, CommandPaletteAddonImpl, CommandsAddon, CommandsAddonImpl, type Comment, type CommentProvider, CommentsAddon, type CommentsAddonConfig, CommentsAddonImpl, ContentAddon, ContentAddonImpl, ContextMenuAddon, ContextMenuAddonImpl, CountAddon, type CountAddonConfig, CountAddonImpl, CoverAddon, type CoverAddonConfig, CoverAddonImpl, DetailsAddon, DetailsAddonImpl, DiffAddon, type DiffAddonConfig, DiffAddonImpl, DividerAddon, DividerAddonImpl, DocxAddon, DocxAddonImpl, EmbedAddon, type EmbedAddonConfig, EmbedAddonImpl, type EmbedProvider, EmojiAddon, type EmojiAddonConfig, EmojiAddonImpl, EquationAddon, type EquationAddonConfig, EquationAddonImpl, FileAddon, type FileAddonConfig, FileAddonImpl, type FileChipProvider, FocusModeAddon, type FocusModeAddonConfig, FocusModeAddonImpl, FontFamilyAddon, type FontFamilyAddonConfig, FontFamilyAddonImpl, FontSizeAddon, type FontSizeAddonConfig, FontSizeAddonImpl, FootnoteAddon, FootnoteAddonImpl, FullScreenAddon, FullScreenAddonImpl, GrammarAddon, GrammarAddonImpl, HeadingsAddon, HeadingsAddonImpl, HighlightAddon, type HighlightAddonConfig, HighlightAddonImpl, HistoryAddon, HistoryAddonImpl, ImageAddon, type ImageAddonConfig, ImageAddonImpl, IndentAddon, IndentAddonImpl, InlineCodeAddon, InlineCodeAddonImpl, InputRulesAddon, InputRulesAddonImpl, ItalicAddon, ItalicAddonImpl, KeymapAddon, type KeymapAddonConfig, KeymapAddonImpl, LineHeightAddon, type LineHeightAddonConfig, LineHeightAddonImpl, LineNumbersAddon, LineNumbersAddonImpl, LinkAddon, type LinkAddonConfig, LinkAddonImpl, ListsAddon, MarkdownAddon, type MarkdownAddonConfig, MarkdownAddonImpl, MentionAddon, type MentionAddonConfig, MentionAddonImpl, type MentionItem, type MentionType, MiniMapAddon, MiniMapAddonImpl, type OGMetadata, OrderedListAddon, OrderedListAddonImpl, OutlineAddon, OutlineAddonImpl, PageBreakAddon, PageBreakAddonImpl, PageSetupAddon, type PageSetupAddonConfig, PageSetupAddonImpl, ParagraphSpacingAddon, ParagraphSpacingAddonImpl, PdfAddon, PdfAddonImpl, type PersonProvider, PlaceholderAddon, type PlaceholderAddonConfig, PlaceholderAddonImpl, PresenceAddon, PresenceAddonImpl, PrintAddon, PrintAddonImpl, ReadOnlyAddon, type ReadOnlyAddonConfig, ReadOnlyAddonImpl, ReadingTimeAddon, ReadingTimeAddonImpl, SchemaAddon, type SchemaAddonConfig, SchemaAddonImpl, SearchAddon, SearchAddonImpl, type SlashGroup, SlashMenuAddon, type SlashMenuAddonConfig, SlashMenuAddonImpl, SmartChipAddon, type SmartChipAddonConfig, SmartChipAddonImpl, SpellCheckAddon, SpellCheckAddonImpl, StatusBarAddon, type StatusBarAddonConfig, StatusBarAddonImpl, type StatusBarSlot, StrikethroughAddon, StrikethroughAddonImpl, SubscriptAddon, SubscriptAddonImpl, SuggestionsAddon, SuggestionsAddonImpl, SuperscriptAddon, SuperscriptAddonImpl, TableAddon, type TableAddonConfig, TableAddonImpl, TableOfContentsAddon, type TableOfContentsAddonConfig, TableOfContentsAddonImpl, TaskListAddon, TaskListAddonImpl, TemplatesAddon, TemplatesAddonImpl, TextColorAddon, type TextColorAddonConfig, TextColorAddonImpl, ToggleListAddon, ToggleListAddonImpl, ToolbarAddon, type ToolbarAddonConfig, ToolbarAddonImpl, type ToolbarGroup, UnderlineAddon, UnderlineAddonImpl, VersionAddon, VersionAddonImpl, VideoAddon, type VideoAddonConfig, VideoAddonImpl, createCommandGroup };