@owomark/core 0.1.6 → 0.1.8

package/dist/dom-adapter-C8wuoffZ.d.ts

@@ -1,471 +0,0 @@
-/** A position within a specific block. */
-type VirtualPosition = {
-    blockId: string;
-    offset: number;
-};
-/** A selection expressed as two virtual positions. */
-type VirtualSelection = {
-    anchor: VirtualPosition;
-    focus: VirtualPosition;
-};
-/** Convert a linear character offset to a VirtualPosition. */
-declare function linearToVirtualPosition(doc: OwoMarkDocument, linearOffset: number): VirtualPosition;
-/** Convert a linear OwoMarkSelection to a VirtualSelection. */
-declare function linearToVirtual(doc: OwoMarkDocument, selection: OwoMarkSelection): VirtualSelection;
-/** Convert a VirtualPosition to a linear character offset. */
-declare function virtualPositionToLinear(doc: OwoMarkDocument, vpos: VirtualPosition): number;
-/** Convert a VirtualSelection to a linear OwoMarkSelection. */
-declare function virtualToLinear(doc: OwoMarkDocument, vsel: VirtualSelection): OwoMarkSelection;
-/** Check if two virtual positions point to the same location. */
-declare function virtualPositionsEqual(a: VirtualPosition, b: VirtualPosition): boolean;
-/** Check if a virtual selection is collapsed (cursor, no range). */
-declare function isVirtualSelectionCollapsed(vsel: VirtualSelection): boolean;
-/** Get the block index for a VirtualPosition, or -1 if not found. */
-declare function getBlockIndexForPosition(doc: OwoMarkDocument, vpos: VirtualPosition): number;
-
-type BlockType = 'paragraph' | 'heading' | 'unordered-list' | 'ordered-list' | 'blockquote' | 'code-fence' | 'directive-container' | 'thematic-break' | 'math-block' | 'table';
-type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
-type Leaf = {
-    text: string;
-};
-type DecoratorType = InlineTokenType;
-type Decorator = {
-    type: DecoratorType;
-    style?: string;
-    leaves: Leaf[];
-};
-type BlockBase = {
-    raw: string;
-    id: string;
-    depth: number;
-    decorators: Decorator[];
-};
-type BlockNode = (BlockBase & {
-    type: 'heading';
-    headingLevel: HeadingLevel;
-}) | (BlockBase & {
-    type: 'code-fence';
-    language: string;
-    isFenceBoundary?: boolean;
-}) | (BlockBase & {
-    type: 'directive-container';
-    directiveName: string;
-}) | (BlockBase & {
-    type: 'math-block';
-}) | (BlockBase & {
-    type: 'table';
-}) | (BlockBase & {
-    type: 'paragraph' | 'unordered-list' | 'ordered-list' | 'blockquote' | 'thematic-break';
-});
-type OwoMarkDocument = {
-    blocks: BlockNode[];
-};
-type OwoMarkSelection = {
-    anchor: number;
-    focus: number;
-};
-type CompositionState = {
-    active: boolean;
-    range: VirtualSelection | null;
-};
-declare const INLINE_TOKEN_TYPES: readonly ["text", "strong-marker", "strong", "emphasis-marker", "emphasis", "code-marker", "code", "link-bracket", "link-text", "link-url", "image-marker", "image-alt", "image-url", "heading-marker", "list-marker", "task-marker", "task-marker-checked", "table-separator", "blockquote-marker", "fence-marker", "fence-lang", "code-block-text", "strikethrough-marker", "strikethrough", "math-marker", "math-text", "hr", "html"];
-type InlineTokenType = (typeof INLINE_TOKEN_TYPES)[number];
-declare const CLASSLESS_INLINE_TOKEN_TYPES: readonly ["text"];
-type InlineToken = {
-    type: InlineTokenType;
-    text: string;
-    start: number;
-    end: number;
-};
-/**
- * Extended block type for host consumption.
- * Derived from BlockType — remaps code-fence to code-block
- * and adds empty for blank paragraphs.
- */
-type BlockContextType = Exclude<BlockType, 'code-fence'> | 'code-block' | 'empty';
-/**
- * Rich block context at the current cursor position.
- * Hosts consume this instead of implementing their own block identification.
- */
-type BlockContext = {
-    /** High-level block category at cursor */
-    type: BlockContextType;
-    /** Heading level (1-6) when type is 'heading' */
-    headingLevel?: HeadingLevel;
-    /** Code fence language when type is 'code-block' */
-    language?: string;
-    /** Nesting depth (lists, blockquotes) */
-    depth: number;
-    /** Block index in document */
-    blockIndex: number;
-    /** Stable block ID */
-    blockId: string;
-};
-type BlockContextListener = (context: BlockContext) => void;
-/**
- * Block types that can be inserted via toolbar or command palette.
- * Maps directly to dispatch command IDs.
- */
-type BlockInsertType = 'code-fence' | 'blockquote' | 'math' | 'table' | 'image' | 'thematic-break';
-type OwoMarkCommands = {
-    focus(): void;
-    undo(): void;
-    redo(): void;
-    toggleBold(): void;
-    toggleItalic(): void;
-    insertLink(url?: string): void;
-    insertCodeFence(language?: string): void;
-    insertMath(): void;
-    insertSideAnnotation(type?: string): void;
-    getMarkdown(): string;
-    setMarkdown(markdown: string): void;
-    /** Replace markdown with explicit selection target and undo support. */
-    replaceMarkdown(markdown: string, selection: OwoMarkSelection): void;
-};
-type DirtyRange = {
-    startBlock: number;
-    endBlock: number;
-};
-type PreviewBlockKind = 'paragraph' | 'heading' | 'unordered-list' | 'ordered-list' | 'blockquote' | 'code-fence' | 'thematic-break' | 'table' | 'math-block' | 'html-block' | 'custom';
-type JsonPrimitive = string | number | boolean | null;
-type JsonValue = JsonPrimitive | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-type PreviewBlock = {
-    /**
-     * Content-based identity: `{renderKey}#{occurrenceIndex}`.
-     * Stable across blank line edits — only changes when block content changes.
-     * Used as the DOM wrapper lifecycle key by the virtual preview engine.
-     * For line-range positional mapping (scroll sync), use startLine/endLine.
-     */
-    blockId: string;
-    kind: PreviewBlockKind;
-    raw: string;
-    startLine: number;
-    endLine: number;
-    renderKey: string;
-    language?: string | null;
-    headingLevel?: HeadingLevel;
-    attributes?: Record<string, JsonValue>;
-};
-/**
- * A block transform enriches PreviewBlocks during projection.
- *
- * Transforms run in `projectToPreviewBlocks` — the single source of truth
- * for both preview rendering and static build. This guarantees identical
- * block output in both pipelines.
- *
- * Examples: image size extraction, custom block attribute injection.
- */
-type BlockTransform = (block: PreviewBlock) => PreviewBlock;
-type PreviewDirtyReason = 'text-edit' | 'structure-edit' | 'theme-change' | 'renderer-change' | 'custom-block-change' | 'full-rebuild';
-type OwoMarkSharedState = {
-    document: OwoMarkDocument;
-    previewBlocks: PreviewBlock[];
-    dirtyRange: DirtyRange | null;
-    dirtyReason: PreviewDirtyReason | null;
-    selection: OwoMarkSelection | null;
-    compositionActive: boolean;
-    visibleBlockIds: string[];
-    version: number;
-    markdown: string;
-};
-type OwoMarkSharedStateStore = {
-    getState(): OwoMarkSharedState;
-    subscribe(listener: (state: OwoMarkSharedState) => void): () => void;
-};
-/**
- * Minimal interface for connecting to shared state.
- * Both OwoMarkCore and OwoMarkEditorInstance satisfy this.
- */
-type OwoMarkEditorLike = {
-    getMarkdown(): string;
-    setMarkdown(markdown: string): void;
-    onChange(callback: (markdown: string) => void): () => void;
-    onSelectionChange(callback: (selection: OwoMarkSelection) => void): () => void;
-    onCompositionStateChange(callback: (active: boolean) => void): () => void;
-};
-type OwoMarkSharedStateController = OwoMarkSharedStateStore & {
-    setMarkdown(markdown: string): void;
-    updateVisibleBlockIds(ids: string[]): void;
-    getEditorInstance(): OwoMarkEditorLike | null;
-    connectEditor(instance: OwoMarkEditorLike): () => void;
-    /** Change theme key, re-derive all renderKeys, and emit 'theme-change'. */
-    setThemeKey(themeKey: string): void;
-    /** Signal that the host renderer pipeline changed. Invalidates all blocks. */
-    notifyRendererChange(): void;
-    /** Signal that a custom block plugin changed. Invalidates all blocks. */
-    notifyCustomBlockChange(): void;
-};
-type HistoryEntry = {
-    markdown: string;
-    selection: OwoMarkSelection;
-};
-type OwoMarkEditorInstance = {
-    mount(root: HTMLElement): void;
-    destroy(): void;
-    getMarkdown(): string;
-    setMarkdown(markdown: string): void;
-    replaceMarkdown(markdown: string, selection: OwoMarkSelection): void;
-    getSelection(): OwoMarkSelection | null;
-    /** Return the current immutable document model. */
-    getDocument(): OwoMarkDocument;
-    focus(): void;
-    dispatch(command: string, payload?: unknown): void;
-    setIndentMode(mode: 'auto' | '2' | '4'): void;
-    onChange(callback: (markdown: string) => void): () => void;
-    onSelectionChange(callback: (selection: OwoMarkSelection) => void): () => void;
-    onCompositionStateChange(callback: (active: boolean) => void): () => void;
-    /**
-     * Register a document change callback.
-     * When registered, the editor enters "sovereign mode": it no longer
-     * renders DOM directly — the view layer is responsible for rendering.
-     * Selection is passed as VirtualSelection (blockId + offset pairs).
-     */
-    onDocumentChange(callback: (doc: OwoMarkDocument, selection: VirtualSelection) => void): () => void;
-};
-
-type CoreSelectionSnapshot = {
-    linear: OwoMarkSelection | null;
-    virtual: VirtualSelection | null;
-};
-type CoreStateSnapshot = {
-    markdown: string;
-    document: OwoMarkDocument;
-    selection: CoreSelectionSnapshot;
-    composition: CompositionState;
-};
-type BeforeInputIntent = {
-    inputType: string;
-    data: string | null;
-};
-type KeyDownIntent = {
-    key: string;
-    ctrlKey: boolean;
-    metaKey: boolean;
-    altKey: boolean;
-    shiftKey: boolean;
-};
-type PasteIntent = {
-    text: string;
-};
-type CoreApplyAction = 'handled' | 'allow-native' | 'composition-sync';
-type CoreApplyResult = {
-    action: CoreApplyAction;
-    snapshot: CoreStateSnapshot;
-};
-
-/**
- * Tab indent handling for code fences.
- * Migrated from admin-editor-indent.ts — pure function.
- */
-type IndentMode = 'auto' | '2' | '4';
-type IndentResult = {
-    handled: boolean;
-    value: string;
-    selectionStart: number;
-    selectionEnd: number;
-    indentSize: number;
-    language: string;
-};
-declare function resolveIndentSize(language: string, mode: IndentMode): number;
-declare function applyMarkdownIndent(params: {
-    text: string;
-    selectionStart: number;
-    selectionEnd: number;
-    shiftKey: boolean;
-    mode: IndentMode;
-}): IndentResult;
-
-type CommandDefinition = {
-    /** Unique identifier, e.g. 'side-annotation', 'code-fence' */
-    id: string;
-    /** Display label for menu, e.g. 'Side Annotation' */
-    label: string;
-    /** Optional description shown in menu subtitle */
-    description?: string;
-    /** Keywords for substring matching (e.g. ['brace', 'margin', 'note']) */
-    keywords?: string[];
-    /** Icon identifier or inline SVG string */
-    icon?: string;
-    /** Keyboard shortcut (informational, binding is separate) */
-    shortcut?: string;
-    /** Menu category for grouping (e.g. 'basic', 'insert', 'format') */
-    category?: string;
-    /** Sort priority within category (lower = higher in list, default 100) */
-    priority?: number;
-    /** Whether this command appears in the slash menu (default: true) */
-    slashMenu?: boolean;
-    /** Predicate: can this command execute given current editor state? */
-    canExecute?: (ctx: CommandContext) => boolean;
-    /**
-     * Execute the command. Supports sync and async.
-     * Core awaits the Promise if returned; adapter may show loading indicator.
-     */
-    execute: (ctx: CommandContext, payload?: unknown) => void | Promise<void>;
-};
-type CommandContext = {
-    /** Current full markdown text (/query already removed when invoked from slash menu) */
-    text: string;
-    /** Linear selection start offset */
-    selectionStart: number;
-    /** Linear selection end offset */
-    selectionEnd: number;
-    /** Low-level: apply a text + selection update to the document (atomic — single undo entry) */
-    applyUpdate: (newText: string, selection: {
-        anchor: number;
-        focus: number;
-    }) => void;
-    /** Access to current document model (read-only) */
-    document: OwoMarkDocument;
-    /** Current block type at cursor */
-    blockType: BlockType;
-    /** Structural depth info for context-aware commands */
-    blockDepth: number;
-    /**
-     * Slash trigger info (only present when invoked from slash menu).
-     * Null when invoked via dispatch() or keyboard shortcut.
-     */
-    triggerInfo: SlashTriggerInfo | null;
-    /** Feature flags from editor config */
-    enableSideAnnotation: boolean;
-    enableMath: boolean;
-    /** Replace the /query trigger text with new content (cursor placed at end) */
-    replaceTriggerText: (text: string) => void;
-    /** Convert the current block to a different type by replacing its structural prefix */
-    turnIntoBlock: (prefix: string) => void;
-    /** Insert a new block below the current one */
-    insertBlockBelow: (markdown: string) => void;
-    /** Replace the current block with a temporary placeholder block and return its stable block ID. */
-    insertPlaceholderBlock: (markdown: string) => string | null;
-    /** Replace a block by its stable block ID. Returns false if the block no longer exists. */
-    replaceBlockById: (blockId: string, markdown: string) => boolean;
-    /** Remove a block by its stable block ID. Returns false if the block no longer exists. */
-    removeBlockById: (blockId: string) => boolean;
-};
-type SlashTriggerInfo = {
-    /** Position of '/' in the document */
-    startOffset: number;
-    /** Cursor position when command was selected */
-    endOffset: number;
-    /** Text typed after '/' (e.g. 'side' for '/side') */
-    query: string;
-};
-type SlashState = {
-    /** Whether the slash menu is currently open */
-    active: boolean;
-    /** Position of '/' in the document */
-    triggerOffset: number;
-    /** Characters typed after '/' */
-    query: string;
-    /** Keyboard-navigated highlight index */
-    selectedIndex: number;
-    /** registry.search(query) result (readonly — consumers must not mutate) */
-    filteredCommands: readonly CommandDefinition[];
-    /** True while async command is executing */
-    pending: boolean;
-};
-type CommandRegistry = {
-    register(def: CommandDefinition): () => void;
-    unregister(id: string): void;
-    get(id: string): CommandDefinition | undefined;
-    getAll(): CommandDefinition[];
-    /** Filter commands matching a query string (for slash menu) */
-    search(query: string): CommandDefinition[];
-};
-type SlashStateListener = (state: SlashState) => void;
-
-/**
- * Pure logic editor core. Owns document, history, selection, composition,
- * and input interpretation. No DOM dependency.
- *
- * Adapters (React / Vanilla) call Core input methods and subscribe to
- * state changes. Core never reads or writes DOM.
- */
-
-/** Callback for sovereign mode: View layer subscribes to Model changes. */
-type DocumentChangeCallback = (doc: OwoMarkDocument, selection: VirtualSelection) => void;
-type OwoMarkCore = {
-    getSnapshot(): CoreStateSnapshot;
-    getMarkdown(): string;
-    getSelection(): OwoMarkSelection | null;
-    getDocument(): OwoMarkDocument;
-    getVirtualSelection(): VirtualSelection | null;
-    getComposition(): CompositionState;
-    setMarkdown(markdown: string): void;
-    replaceMarkdown(markdown: string, selection: OwoMarkSelection): void;
-    dispatch(command: string, payload?: unknown): void;
-    setIndentMode(mode: IndentMode): void;
-    setEnableSideAnnotation(enabled: boolean): void;
-    setEnableMath(enabled: boolean): void;
-    /**
-     * Apply a document update from an external source (e.g. DOM sync after
-     * unknown inputType or composition end). Core reconciles, updates state,
-     * and emits changes.
-     */
-    syncText(text: string, selection: OwoMarkSelection | null): void;
-    applyBeforeInput(intent: BeforeInputIntent, selection: OwoMarkSelection | null): CoreApplyResult;
-    applyKeyDown(intent: KeyDownIntent, selection: OwoMarkSelection | null): CoreApplyResult;
-    applyPaste(intent: PasteIntent, selection: OwoMarkSelection | null): CoreApplyResult;
-    handleCompositionStart(selection: OwoMarkSelection | null): void;
-    handleCompositionUpdate(): void;
-    handleCompositionEnd(selection: OwoMarkSelection | null, fallbackText?: string | null): CoreApplyResult;
-    updateSelection(selection: OwoMarkSelection): void;
-    /** Get the block context at the current cursor position. */
-    getBlockContext(): BlockContext;
-    /**
-     * Insert a block template at the current cursor position.
-     * Unified entry point for toolbar / command palette.
-     */
-    insertBlock(type: BlockInsertType, options?: {
-        language?: string;
-    }): void;
-    getCommandRegistry(): CommandRegistry;
-    getSlashState(): SlashState;
-    /** Register a custom command. Returns unregister function. */
-    registerCommand(def: CommandDefinition): () => void;
-    /** Execute a slash command by index in filtered list (for menu click/enter). */
-    executeSlashCommand(index: number): void;
-    /** Dismiss the slash menu without executing. */
-    dismissSlashMenu(): void;
-    onChange(callback: (markdown: string) => void): () => void;
-    onSelectionChange(callback: (selection: OwoMarkSelection) => void): () => void;
-    onCompositionStateChange(callback: (active: boolean) => void): () => void;
-    onStateChange(callback: (snapshot: CoreStateSnapshot) => void): () => void;
-    onSlashStateChange(callback: SlashStateListener): () => void;
-    /** Subscribe to block context changes (fires on selection or document change). */
-    onBlockContextChange(callback: BlockContextListener): () => void;
-    /**
-     * Register a document change callback (sovereign mode).
-     * When registered, adapters should render declaratively from the document.
-     */
-    onDocumentChange(callback: DocumentChangeCallback): () => void;
-    /** Dispose timers and internal state. */
-    destroy(): void;
-};
-type CreateOwoMarkCoreOptions = {
-    initialMarkdown?: string;
-    indentMode?: IndentMode;
-    /** Enable side annotation Enter-continuation. Defaults to true. */
-    enableSideAnnotation?: boolean;
-    /** Enable math slash command visibility. Defaults to true. */
-    enableMath?: boolean;
-};
-declare function createOwoMarkCore(options?: CreateOwoMarkCoreOptions): OwoMarkCore;
-
-/**
- * Shared DOM adapter factory.
- *
- * Contains the full DOM event binding, imperative rendering, and
- * selection management logic. Consumed by `@owomark/view`.
- *
- * @internal Not part of the public API — consumed only by adapter wrappers.
- */
-
-type DomAdapterInstance = OwoMarkEditorInstance & {
-    /** Internal escape hatch for @owomark/view wrappers. */
-    getCore(): OwoMarkCore;
-};
-declare function createDomAdapter(): DomAdapterInstance;
-
-export { createOwoMarkCore as $, type IndentMode as A, type BlockNode as B, type CoreStateSnapshot as C, type DirtyRange as D, type IndentResult as E, type JsonValue as F, type OwoMarkCommands as G, type HeadingLevel as H, type InlineToken as I, type JsonPrimitive as J, type KeyDownIntent as K, type Leaf as L, type OwoMarkCore as M, type OwoMarkEditorInstance as N, type OwoMarkSelection as O, type PreviewBlockKind as P, type OwoMarkEditorLike as Q, type OwoMarkSharedState as R, type SlashState as S, type OwoMarkSharedStateStore as T, type PasteIntent as U, type PreviewDirtyReason as V, type SlashStateListener as W, type SlashTriggerInfo as X, type VirtualPosition as Y, type VirtualSelection as Z, applyMarkdownIndent as _, type BlockContextType as a, getBlockIndexForPosition as a0, isVirtualSelectionCollapsed as a1, linearToVirtual as a2, linearToVirtualPosition as a3, resolveIndentSize as a4, virtualPositionToLinear as a5, virtualPositionsEqual as a6, virtualToLinear as a7, createDomAdapter as a8, type CommandRegistry as b, type OwoMarkDocument as c, type PreviewBlock as d, type BlockTransform as e, type OwoMarkSharedStateController as f, type InlineTokenType as g, type BeforeInputIntent as h, type BlockContext as i, type BlockContextListener as j, type BlockInsertType as k, type BlockType as l, CLASSLESS_INLINE_TOKEN_TYPES as m, type CommandContext as n, type CommandDefinition as o, type CompositionState as p, type CoreApplyAction as q, type CoreApplyResult as r, type CoreSelectionSnapshot as s, type CreateOwoMarkCoreOptions as t, type Decorator as u, type DecoratorType as v, type DocumentChangeCallback as w, type DomAdapterInstance as x, type HistoryEntry as y, INLINE_TOKEN_TYPES as z };