Utility Plugins

/**
 * Adds order attributes to list items during markdown processing
 * Ensures proper numbering in ordered lists
 */
const remarkAddOrderInListPlugin: $remark<'remarkAddOrderInList'>;

/**
 * Handles inline line breaks during markdown transformation
 * Converts hard breaks to proper editor nodes
 */
const remarkLineBreak: $remark<'remarkLineBreak'>;

/**
 * Wraps the remark-inline-links plugin for processing inline link syntax
 * Converts reference-style links to inline format
 */
const remarkInlineLinkPlugin: $remark<'remarkInlineLink'>;

/**
 * Transforms HTML nodes during markdown processing
 * Handles inline HTML content preservation
 */
const remarkHtmlTransformer: $remark<'remarkHTMLTransformer'>;

/**
 * Preserves original emphasis and strong markers (* vs _ and ** vs __)
 * Maintains consistency with user's preferred markdown syntax
 */
const remarkMarker: $remark<'remarkMarker'>;

/**
 * Preserves empty lines in markdown output
 * Maintains document formatting and readability
 */
const remarkPreserveEmptyLinePlugin: $remark<'remark-preserve-empty-line'>;

import { 
  remarkAddOrderInListPlugin,
  remarkLineBreak,
  remarkMarker 
} from "@milkdown/preset-commonmark";

// These plugins are automatically included in the commonmark preset
// They can also be used individually if needed
const customPreset = [
  remarkAddOrderInListPlugin,
  remarkLineBreak,
  remarkMarker,
];

/**
 * Fixes cursor positioning bug in Chrome 98+ for inline nodes
 * Ensures proper cursor placement around images, links, and other inline elements
 */
const inlineNodesCursorPlugin: $prose;

/**
 * Clears formatting marks around hard break nodes
 * Prevents marks from spanning across line breaks inappropriately
 */
const hardbreakClearMarkPlugin: $prose;

/**
 * Context configuration for nodes that should be filtered during hardbreak insertion
 * Array of node type names where hardbreaks should not be automatically inserted
 */
const hardbreakFilterNodes: $ctx<string[]>;

/**
 * Filters hardbreak insertion based on current context
 * Uses hardbreakFilterNodes context to determine where hardbreaks are allowed
 */
const hardbreakFilterPlugin: $prose;

/**
 * Synchronizes heading node IDs with their text content
 * Automatically updates heading IDs when heading text changes
 */
const syncHeadingIdPlugin: $prose;

/**
 * Synchronizes order attributes in list items
 * Maintains proper numbering in ordered lists during editing
 */
const syncListOrderPlugin: $prose;

import { 
  hardbreakFilterNodes,
  hardbreakFilterPlugin,
  syncHeadingIdPlugin 
} from "@milkdown/preset-commonmark";

// Configure hardbreak filtering
editor.config((ctx) => {
  ctx.set(hardbreakFilterNodes.key, ['codeBlock', 'heading']);
});

// The sync plugins work automatically once included
const customPlugins = [
  hardbreakFilterPlugin,
  syncHeadingIdPlugin,
];

/**
 * Combined utility plugins included in the commonmark preset
 * Contains all remark and ProseMirror plugins for full functionality
 */
const plugins: MilkdownPlugin[];

import { Editor } from "@milkdown/core";
import { 
  remarkAddOrderInListPlugin,
  remarkLineBreak,
  inlineNodesCursorPlugin,
  syncHeadingIdPlugin,
  hardbreakFilterNodes
} from "@milkdown/preset-commonmark";

// Custom editor with specific plugins
const editor = await Editor.make()
  .config((ctx) => {
    // Configure hardbreak filtering
    ctx.set(hardbreakFilterNodes.key, ['codeBlock']);
  })
  .use([
    // Remark plugins for markdown processing
    remarkAddOrderInListPlugin,
    remarkLineBreak,
    
    // ProseMirror plugins for editor behavior
    inlineNodesCursorPlugin,
    syncHeadingIdPlugin,
  ])
  .create();

// Plugin types
type $remark<T> = any; // Remark plugin type
type $prose = any; // ProseMirror plugin type
type $ctx<T> = any; // Context configuration type
type MilkdownPlugin = any; // Core plugin type

// Context value types
type HardbreakFilterNodes = string[]; // Array of node type names