@multiplatform.one/rich-text 6.1.0 → 6.4.0

package/types/RichTextEditor/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * RichTextEditor with form integration
+ *
+ * Three-branch architecture following field architecture standard:
+ * - Branch 1: Skeleton loading state
+ * - Branch 2: Standalone (no form context)
+ * - Branch 3: Form-integrated (with TanStack Form)
+ *
+ * Wraps RichEditor compound component with FieldLayout and validation.
+ * Uses custom empty check for '<p></p>' which is Tiptap's empty state.
+ */
+import type { DeepKeys, DeepValue } from "@tanstack/form-core";
+import type React from "react";
+import type { LabelProps, SizeTokens } from "tamagui";
+import { type FormFieldProps, type FieldComponentProps, type Validator } from "@multiplatform.one/forms";
+import type { EditorCapabilities, RichTextMentionOptions, ToolbarSection } from "../types";
+export type RichTextEditorProps<TParentData = any, TName extends DeepKeys<TParentData> = any, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = Omit<FormFieldProps<TParentData, TName, TFieldValidator, TFormValidator, TData>, "children" | "field"> & Partial<Omit<FieldComponentProps<TParentData, TName, TFieldValidator, TFormValidator, TData>, "children">> & {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    onBlur?: (...args: any[]) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    minHeight?: number;
+    maxHeight?: number;
+    label?: React.ReactNode;
+    labelProps?: Omit<LabelProps, "htmlFor" | "ref">;
+    helperText?: string;
+    error?: string | boolean;
+    required?: boolean;
+    size?: SizeTokens;
+    /** Show the formatting toolbar (default: true) */
+    showToolbar?: boolean;
+    /** Use compact sizing for toolbar (default: false) */
+    compact?: boolean;
+    /** Show the bubble toolbar on text selection (default: false, web only) */
+    showBubbleToolbar?: boolean;
+    /** Toolbar sections to display (shows all when omitted) */
+    sections?: ToolbarSection[];
+    /**
+     * Capability surface (default "full"). "markdown" constrains the editor
+     * to markdown-expressible features and makes value/onChange markdown
+     * strings instead of HTML.
+     */
+    capabilities?: EditorCapabilities;
+    /** When true, renders a skeleton placeholder instead of the editor */
+    skeleton?: boolean;
+    /** Controlled fullscreen state (web; uncontrolled when omitted) */
+    fullscreen?: boolean;
+    /** Initial fullscreen state when uncontrolled (default: false) */
+    defaultFullscreen?: boolean;
+    /** Called when the fullscreen state changes */
+    onFullscreenChange?: (fullscreen: boolean) => void;
+    /**
+     * Native only: render the embedded inline editor instead of the
+     * preview + fullscreen edit modal (ignored on web)
+     */
+    inlineEditing?: boolean;
+    /**
+     * Uploads a pasted/dropped image and resolves its URL (web). Without it,
+     * images are inlined as base64 data URIs.
+     */
+    onImageUpload?: (file: File) => Promise<string>;
+    /**
+     * Uploads a pasted/dropped non-image file and resolves its URL (web).
+     * Inserts an attachment chip link; without it, non-image files are ignored.
+     */
+    onFileUpload?: (file: File) => Promise<{
+        url: string;
+        name?: string;
+    }>;
+    /** Enables the @ mention suggestion popup (web) */
+    mentions?: RichTextMentionOptions;
+};
+export declare function RichTextEditor<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>>(props: RichTextEditorProps<TParentData, TName, TFieldValidator, TFormValidator, TData>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/types/RichTextEditor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/index.tsx"],"names":[],"mappings":"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"}

package/types/constants.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared constants for the rich text editor
+ */
+import type { NativeCapability } from "./types";
+export interface ColorEntry {
+    /** Display name for the color */
+    name: string;
+    /** CSS color value (theme custom property on web), or null for default/none */
+    value: string | null;
+}
+/** A palette entry backed by a theme token instead of a literal color */
+export interface ColorTokenEntry {
+    /** Display name for the color */
+    name: string;
+    /** Theme token key (e.g. "red11"), or null for default/none */
+    token: string | null;
+}
+export declare const TEXT_COLOR_TOKENS: ColorTokenEntry[];
+/**
+ * Dark-scheme display names for the same tokens: the values are identical
+ * (theme vars re-resolve per scheme) — only the neutral ink's honest label
+ * flips (color12 renders near-white in dark).
+ */
+export declare const TEXT_COLOR_TOKENS_DARK: ColorTokenEntry[];
+/**
+ * Highlight washes ride the radix step-5 component backgrounds: pastel in
+ * light, deep-dim in dark — the scheme's own ink (color12, inherited by the
+ * mark) stays legible on them in both schemes.
+ */
+export declare const HIGHLIGHT_COLOR_TOKENS: ColorTokenEntry[];
+export declare const TEXT_COLORS: ColorEntry[];
+export declare const TEXT_COLORS_DARK: ColorEntry[];
+export declare const HIGHLIGHT_COLORS: ColorEntry[];
+/**
+ * Every theme token the palettes reference — the single list used to inject
+ * resolved CSS custom properties into the native 10Tap webview.
+ */
+export declare const PALETTE_THEME_TOKENS: string[];
+/**
+ * Maps each EditorCommand to whether 10Tap supports it via bridge extensions.
+ *
+ * Supported commands use actual bridge methods (ColorBridge, HighlightBridge,
+ * ImageBridge, TaskListBridge, etc.).
+ *
+ * Unsupported commands (subscript, superscript, textAlign, codeBlock,
+ * horizontalRule, clearFormatting) have no 10Tap bridge equivalent.
+ */
+export declare const NATIVE_SUPPORTED_COMMANDS: NativeCapability;
+//# sourceMappingURL=constants.d.ts.map

package/types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMhD,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAmBD,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAK9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAInD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAUnD,CAAC;AAcF,eAAO,MAAM,WAAW,EAAE,UAAU,EAAyC,CAAC;AAC9E,eAAO,MAAM,gBAAgB,EAAE,UAAU,EAA8C,CAAC;AACxF,eAAO,MAAM,gBAAgB,EAAE,UAAU,EAA8C,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAMxC,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBA2CvC,CAAC"}

package/types/context.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared context for the rich text editor compound component
+ */
+import type { FontSizeTokens } from "tamagui";
+export declare const RichEditorContext: import("@tamagui/web").StyledContext<{
+    size: FontSizeTokens;
+    compact: boolean;
+    disabled: boolean;
+}>;
+//# sourceMappingURL=context.d.ts.map

package/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,eAAO,MAAM,iBAAiB;UACtB,cAAc;aACX,OAAO;cACN,OAAO;EAKjB,CAAC"}

package/types/editor/BlockDragHandle.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Universal block drag handle extension.
+ * Shows a grip icon to the left of the hovered top-level block.
+ * Dragging from the handle moves the entire block.
+ */
+import { Extension } from "@tiptap/core";
+export declare const BlockDragHandle: Extension<any, any>;
+//# sourceMappingURL=BlockDragHandle.d.ts.map

package/types/editor/BlockDragHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockDragHandle.d.ts","sourceRoot":"","sources":["../../src/editor/BlockDragHandle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAsDzC,eAAO,MAAM,eAAe,qBAyG1B,CAAC"}

package/types/editor/MarkdownPaste.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extension that intercepts paste events containing markdown-formatted plain
+ * text and converts it to HTML before insertion. If the clipboard already
+ * contains HTML (e.g. from a web page), the default paste behavior is used.
+ */
+import { Extension } from "@tiptap/core";
+export declare const MarkdownPaste: Extension<any, any>;
+//# sourceMappingURL=MarkdownPaste.d.ts.map

package/types/editor/MarkdownPaste.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownPaste.d.ts","sourceRoot":"","sources":["../../src/editor/MarkdownPaste.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAUzC,eAAO,MAAM,aAAa,qBAiCxB,CAAC"}

package/types/editor/SlashCommands.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Slash commands extension -- type "/" to open a searchable menu of block
+ * types. Uses @tiptap/suggestion for trigger/matching and the shared
+ * suggestion popup (LC-16: same list, rows, chrome, and keyboard handling
+ * as the @ mention menu).
+ */
+import { Extension } from "@tiptap/core";
+import type { Editor, Range } from "@tiptap/core";
+import { type SuggestionRow } from "./suggestionPopup";
+export interface SlashCommandItem {
+    /** Stable identifier (also the row key) */
+    id: string;
+    /** Translated display title */
+    title: string;
+    /** Translated one-line description */
+    description: string;
+    icon: SuggestionRow["icon"];
+    command: (props: {
+        editor: Editor;
+        range: Range;
+    }) => void;
+}
+export declare const SlashCommands: Extension<any, any>;
+//# sourceMappingURL=SlashCommands.d.ts.map

package/types/editor/SlashCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommands.d.ts","sourceRoot":"","sources":["../../src/editor/SlashCommands.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAsBlD,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5D;AAiMD,eAAO,MAAM,aAAa,qBA0DxB,CAAC"}

package/types/editor/TentapEditor.native.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 10Tap-based rich text editor for React Native
+ *
+ * Rebuilt to properly use 10Tap bridge extensions:
+ * - ColorBridge for text color
+ * - HighlightBridge for highlight/background color
+ * - ImageBridge for image insertion
+ * - TaskListBridge for task lists
+ *
+ * Uses getEditorStateFromBridge() for state mapping and
+ * RichEditorContext for styling from the compound component.
+ *
+ * No BubbleToolbar (10Tap does not support floating menus).
+ */
+import type { RichEditorProps, RichEditorRef } from "../types";
+export interface TentapEditorProps extends RichEditorProps {
+    /** Fill the available space (fullscreen modal) instead of using minHeight */
+    fill?: boolean;
+}
+export declare const TentapEditor: import("react").ForwardRefExoticComponent<TentapEditorProps & import("react").RefAttributes<RichEditorRef>>;
+//# sourceMappingURL=TentapEditor.native.d.ts.map

package/types/editor/TentapEditor.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TentapEditor.native.d.ts","sourceRoot":"","sources":["../../src/editor/TentapEditor.native.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA0BH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AAoB9E,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,6EAA6E;IAC7E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,eAAO,MAAM,YAAY,6GA8PxB,CAAC"}

package/types/editor/TiptapEditor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tiptap-based rich text editor for web
+ *
+ * Uses extracted utilities:
+ * - getEditorCSS() for ProseMirror styles (theme-aware CSS custom properties)
+ * - getEditorStateFromTiptap() for state mapping
+ * - RichEditorContext for styling context
+ * - BubbleToolbar for inline formatting on text selection
+ */
+import type { RichEditorProps, RichEditorRef } from "../types";
+export interface TiptapEditorProps extends RichEditorProps {
+    /** Show the bubble toolbar on text selection (web only) */
+    showBubbleToolbar?: boolean;
+    /** CSS font-family string for body text (resolved from knobs) */
+    bodyFontFamily?: string;
+    /** CSS font-family string for headings (resolved from knobs) */
+    headingFontFamily?: string;
+    /** Current editing mode: richtext (WYSIWYG) or markdown (raw source) */
+    editorMode?: "richtext" | "markdown";
+    /** Fullscreen mode: content fills the flex parent and scrolls internally */
+    fullscreen?: boolean;
+}
+export declare const TiptapEditor: import("react").NamedExoticComponent<TiptapEditorProps & import("react").RefAttributes<RichEditorRef>>;
+//# sourceMappingURL=TiptapEditor.d.ts.map

package/types/editor/TiptapEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapEditor.d.ts","sourceRoot":"","sources":["../../src/editor/TiptapEditor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AA2B9E,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACrC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiBD,eAAO,MAAM,YAAY,wGAqdxB,CAAC"}

package/types/editor/blockAnchor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Block-rect anchoring for bubble menus (web).
+ *
+ * Tiptap's BubbleMenu anchors to the text caret by default. For tall blocks
+ * (tables, code blocks) that puts the bubble INSIDE the block box — hovering
+ * over the first table row / first code line, where it traps pointer events
+ * and chases the caret on every keystroke. Anchoring to the block's own DOM
+ * rect keeps the bubble outside the block (above it, or flipped below by
+ * floating-ui), so block content stays clickable and the bubble holds still
+ * while typing. GitLab's content editor anchors its table/code chrome the
+ * same way.
+ */
+import type { Editor } from "@tiptap/core";
+interface BlockVirtualElement {
+    getBoundingClientRect: () => DOMRect;
+    contextElement: Element;
+}
+/**
+ * Returns a floating-ui VirtualElement for the nearest ancestor node of
+ * `nodeTypeName` containing the selection, or null when the selection is
+ * not inside one (the bubble is hidden by `shouldShow` in that case).
+ */
+export declare function getBlockVirtualElement(editor: Editor, nodeTypeName: string): BlockVirtualElement | null;
+export {};
+//# sourceMappingURL=blockAnchor.d.ts.map

package/types/editor/blockAnchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockAnchor.d.ts","sourceRoot":"","sources":["../../src/editor/blockAnchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,UAAU,mBAAmB;IAC3B,qBAAqB,EAAE,MAAM,OAAO,CAAC;IACrC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,mBAAmB,GAAG,IAAI,CAa5B"}

package/types/editor/capabilities.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Editor capability presets.
+ *
+ * "markdown" constrains the WYSIWYG editor to exactly what GFM markdown can
+ * express (owner ruling, LC-52 MARKDOWN-EXPRESSIBLE-EDITING): bold, italic,
+ * strikethrough, inline code, links, headings, bullet/ordered/task lists,
+ * blockquote, fenced code blocks, images, horizontal rule, and simple pipe
+ * tables. Everything markdown cannot express — underline, highlight, text
+ * color, alignment, sub/superscript, collapsible details, inline math,
+ * mention chips, table cell merge/split — is ABSENT in this mode: the
+ * extensions are not registered (commands do not exist) and the toolbar
+ * controls do not render.
+ *
+ * This module is the single source of truth both the runtime (extension
+ * factory, toolbars, executeCommand guard) and the VERIFY specs consume.
+ */
+import type { EditorCapabilities, EditorCommand } from "../types";
+/** Commands expressible in GFM markdown (the "markdown" capability surface) */
+export declare const MARKDOWN_COMMANDS: ReadonlySet<EditorCommand>;
+/** True when the command exists in the given capability surface */
+export declare function isCommandInCapabilities(command: EditorCommand, capabilities?: EditorCapabilities): boolean;
+/**
+ * Slash-menu items excluded in markdown capabilities. Mermaid stays out of
+ * the INSERT surface to keep it strictly GFM (a hand-typed ``` fence still
+ * produces a plain code block); math and details have no markdown syntax.
+ * Emoji stays — it inserts a plain unicode character (just text).
+ */
+export declare const MARKDOWN_EXCLUDED_SLASH_IDS: readonly string[];
+//# sourceMappingURL=capabilities.d.ts.map

package/types/editor/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/editor/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,aAAa,CAiCvD,CAAC;AAEH,mEAAmE;AACnE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EACtB,YAAY,GAAE,kBAA2B,GACxC,OAAO,CAGT;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAKxD,CAAC"}

package/types/editor/codeBlockPreview.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Code block with live below-block preview for `mermaid` and `math`
+ * languages — GitLab content-editor parity.
+ *
+ * The code stays a normal editable code block (language picker, copy,
+ * tab-indent, lowlight all keep working through contentDOM); when the
+ * language is `mermaid` or `math` a preview pane renders below the source:
+ *
+ * - mermaid: SVG via the canonical `@multiplatform.one/markdown` renderer
+ *   (LC-16 — one implementation; the engine is dynamically imported on the
+ *   first diagram, zero eager bytes).
+ * - math: display-mode KaTeX via lazyKatex (same discipline).
+ *
+ * Re-renders are debounced while typing; the previous preview stays
+ * visible until the new one lands (no flicker). Invalid source shows the
+ * parse error in the pane (Axiom 6: show the error, never blank).
+ *
+ * `$$ ` at the start of a line opens a math block (GitLab-style display
+ * math input); ```mermaid and ```math fences already work through the
+ * inherited code block input rule.
+ */
+import { Extension } from "@tiptap/core";
+import type { Editor } from "@tiptap/core";
+export interface PreviewChrome {
+    /** Color scheme forwarded to the diagram/math renderers */
+    scheme: "light" | "dark";
+    /** CSS font family forwarded to mermaid's theme config */
+    fontFamily?: string;
+}
+interface PreviewChromeStorage {
+    value: PreviewChrome;
+    listeners: Set<() => void>;
+}
+declare module "@tiptap/core" {
+    interface Storage {
+        previewChrome: PreviewChromeStorage;
+    }
+}
+/**
+ * Storage-only extension carrying the resolved scheme for block previews.
+ * The editor host pushes values (setPreviewChrome) from React land; node
+ * views subscribe so a theme flip re-renders live diagrams.
+ */
+export declare const PreviewChromeStore: Extension<any, PreviewChromeStorage>;
+export declare function setPreviewChrome(editor: Editor, chrome: PreviewChrome): void;
+export declare const PREVIEW_LANGUAGES: readonly ["mermaid", "math"];
+export type PreviewLanguage = (typeof PREVIEW_LANGUAGES)[number];
+export declare function getPreviewKind(language: string | null | undefined): PreviewLanguage | null;
+export declare const CodeBlockWithPreview: import("@tiptap/core").Node<import("@tiptap/extension-code-block-lowlight").CodeBlockLowlightOptions, any>;
+export {};
+//# sourceMappingURL=codeBlockPreview.d.ts.map

package/types/editor/codeBlockPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeBlockPreview.d.ts","sourceRoot":"","sources":["../../src/editor/codeBlockPreview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,SAAS,EAA0B,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQ3C,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;CAC5B;AAED,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,OAAO;QACf,aAAa,EAAE,oBAAoB,CAAC;KACrC;CACF;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,sCAK7B,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAQ5E;AAUD,eAAO,MAAM,iBAAiB,8BAA+B,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,GAAG,IAAI,CAI1F;AAQD,eAAO,MAAM,oBAAoB,4GA0K/B,CAAC"}

package/types/editor/editorStyles.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CSS styles for the ProseMirror editor content area.
+ *
+ * ProseMirror renders its own DOM outside Tamagui, so CSS injection via
+ * a <style> tag is necessary. Colors use Tamagui CSS custom properties
+ * for theme awareness.
+ */
+export interface EditorCSSOptions {
+    /** Minimum height of the editor in pixels */
+    minHeight?: number;
+    /** Maximum height of the editor in pixels (enables scroll) */
+    maxHeight?: number;
+    /** CSS font-family string for body text */
+    bodyFontFamily?: string;
+    /** CSS font-family string for headings */
+    headingFontFamily?: string;
+    /** Fullscreen mode: fill the container instead of min/max pixel heights */
+    fullscreen?: boolean;
+    /** Bubble/popup fade duration in ms; 0 = animation none (motion silenced) */
+    motionMs?: number;
+    /** Per-instance scope class so bubble motion rules do not cross editors */
+    scopeClass?: string;
+}
+export declare function getEditorCSS(options?: EditorCSSOptions): string;
+//# sourceMappingURL=editorStyles.d.ts.map

package/types/editor/editorStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorStyles.d.ts","sourceRoot":"","sources":["../../src/editor/editorStyles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAkanE"}

package/types/editor/emoji.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `:emoji:` autocomplete for the rich text editor (web) — GitLab parity.
+ *
+ * Third suggestion source on the shared LC-16 popup (same rows, chrome,
+ * keyboard handling, and ARIA roles as slash commands and @ mentions).
+ * Typing `:` opens a searchable shortname list; selecting inserts the plain
+ * unicode character (like GitLab's editor), so the markdown round-trip is
+ * lossless by construction — an emoji is just text.
+ *
+ * Bundle discipline: the emoji dataset (emojilib, ~32 KB gz) is NOT in the
+ * editor chunk. It is dynamically imported on the first `:` trigger and
+ * cached for the session.
+ */
+import { Extension } from "@tiptap/core";
+import type { Editor, Range } from "@tiptap/core";
+export interface EmojiEntry {
+    /** Shortname, e.g. "thumbsup" (typed between colons) */
+    name: string;
+    /** The unicode character inserted into the document */
+    char: string;
+    /** Search keywords from the dataset */
+    keywords: string[];
+}
+/**
+ * Loads and flattens the emojilib dataset on first use. The dynamic import
+ * keeps the JSON out of the editor chunk (zero eager bytes); the promise is
+ * cached so the fetch happens at most once per session.
+ */
+export declare function loadEmojiIndex(): Promise<EmojiEntry[]>;
+/** Test seam: reset the cached dataset promise */
+export declare function resetEmojiIndexForTesting(): void;
+/**
+ * Ranked shortname search: exact name, name prefix, name substring, then
+ * keyword prefix/substring. Ties keep dataset order (faces first), matching
+ * the GitLab popup's feel. An empty query lists the head of the dataset.
+ */
+export declare function searchEmoji(entries: EmojiEntry[], query: string, limit?: number): EmojiEntry[];
+/** Inserts the unicode character, replacing the `:query` trigger text */
+export declare function insertEmoji(editor: Editor, range: Range, char: string): void;
+/**
+ * `:` trigger suggestion menu. Own plugin key — the slash menu owns the
+ * default Suggestion key and the two must coexist.
+ */
+export declare const EmojiSuggestion: Extension<any, any>;
+//# sourceMappingURL=emoji.d.ts.map

package/types/editor/emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emoji.d.ts","sourceRoot":"","sources":["../../src/editor/emoji.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAUlD,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AASD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAatD;AAED,kDAAkD;AAClD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE,CAmB1F;AAMD,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5E;AAID;;;GAGG;AACH,eAAO,MAAM,eAAe,qBAmC1B,CAAC"}

package/types/editor/extensions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Extension factory for the web Tiptap editor.
+ *
+ * One canonical list (LC-16) consumed by TiptapEditor AND by the
+ * capability specs, so what ships is exactly what is verified. With
+ * `capabilities: "markdown"` the non-markdown extensions are NOT
+ * registered — their commands do not exist on the editor (LC-52
+ * MARKDOWN-EXPRESSIBLE-EDITING), and StarterKit's underline sub-extension
+ * is disabled.
+ */
+import { Extension, type Extensions } from "@tiptap/core";
+import type { EditorCapabilities } from "../types";
+/**
+ * Tab / Shift-Tab indentation inside code blocks.
+ * Inserts or removes 2 spaces at the cursor (or start of each selected line).
+ */
+export declare const CodeBlockTabIndent: Extension<any, any>;
+/**
+ * Override Shift-Enter and Mod-Enter to create new paragraphs instead of
+ * hard breaks (<br>). Mirrors GitLab's approach: HardBreak node stays
+ * registered (so <br> in pasted HTML is preserved) but its keyboard
+ * shortcuts are replaced with the default enter (split paragraph) behavior.
+ */
+export declare const ParagraphEnterKeys: Extension<any, any>;
+/**
+ * Tab/Shift-Tab indent/dedent and Alt+Arrow move for list items.
+ * Tab sinks (indents), Shift-Tab lifts (dedents).
+ * Alt+Up/Down moves the list item up or down among siblings.
+ */
+export declare const ListItemKeys: Extension<any, any>;
+export interface BuildEditorExtensionsOptions {
+    /** Capability preset (default "full") */
+    capabilities?: EditorCapabilities;
+    /** Placeholder text (defaults to the translated "Start writing...") */
+    placeholder?: string;
+    /** Pre-built mention extension (ignored in markdown capabilities) */
+    mentionExtension?: Extensions[number] | null;
+}
+/** Build the production extension list for the given capability surface */
+export declare function buildEditorExtensions({ capabilities, placeholder, mentionExtension, }?: BuildEditorExtensionsOptions): Extensions;
+//# sourceMappingURL=extensions.d.ts.map

package/types/editor/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/editor/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAoB1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAcnD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,qBAyE7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,qBAsB7B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,qBAgCvB,CAAC;AAMH,MAAM,WAAW,4BAA4B;IAC3C,yCAAyC;IACzC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,EACpC,YAAqB,EACrB,WAAW,EACX,gBAAuB,GACxB,GAAE,4BAAiC,GAAG,UAAU,CAuGhD"}

package/types/editor/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Editor internal exports
+ *
+ * These are implementation details used by the compound component.
+ * Public API is exported from src/index.ts.
+ */
+export { TiptapEditor } from "./TiptapEditor";
+export type { TiptapEditorProps } from "./TiptapEditor";
+export { getEditorCSS } from "./editorStyles";
+export { getEditorStateFromTiptap, getEditorStateFromBridge } from "./useEditorState";
+//# sourceMappingURL=index.d.ts.map

package/types/editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/editor/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/types/editor/lazyKatex.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Lazy KaTeX renderer for `$...$` inline and `$$...$$` block math.
+ *
+ * Bundle discipline: KaTeX (~70 KB gz JS + CSS + fonts) never rides the
+ * editor chunk. Both the library and its stylesheet load through dynamic
+ * import on the first math render and are cached for the session. The
+ * stylesheet colors inherit `currentColor`, so dark schemes work without
+ * a separate dark CSS pass.
+ *
+ * The result contract is Axiom 6 friendly — invalid TeX returns
+ * `{ ok: false, error }` with KaTeX's parse message so callers can show
+ * the error instead of a blank node.
+ */
+export type KatexRenderResult = {
+    ok: true;
+    html: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** Renders TeX to KaTeX HTML markup (display mode for `$$` blocks) */
+export declare function renderKatexHtml(latex: string, options?: {
+    displayMode?: boolean;
+}): Promise<KatexRenderResult>;
+/**
+ * Mounts KaTeX markup as real DOM nodes. KaTeX output is spans + MathML by
+ * construction; parsing inert and stripping executables is defense in
+ * depth, mirroring the mermaid mount helper.
+ */
+export declare function mountKatexHtml(container: HTMLElement, html: string): void;
+/** Test seam: reset the cached library promise */
+export declare function resetKatexForTesting(): void;
+//# sourceMappingURL=lazyKatex.d.ts.map

package/types/editor/lazyKatex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazyKatex.d.ts","sourceRoot":"","sources":["../../src/editor/lazyKatex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAiB1F,sEAAsE;AACtE,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAY5B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQzE;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/types/editor/markdown.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Canonical HTML <-> Markdown conversion for the rich text editor (web).
+ *
+ * One implementation (LC-16) shared by the markdown source mode toggle and
+ * the markdown paste handler. GFM coverage beyond turndown's defaults:
+ * strikethrough, task lists (Tiptap's label-nested checkbox markup), and
+ * pipe tables. Marks with no markdown syntax (underline, sub/superscript,
+ * highlight, text color spans) survive as inline HTML so the
+ * rich -> markdown -> rich round-trip is lossless for every toolbar feature.
+ *
+ * GitLab-flavored extras (round-trip lossless):
+ * - `$x$` inline math <-> `<span data-type="inline-math" data-latex>`
+ * - `$$ ... $$` block math <-> code block with language "math"
+ *   (``` math fences parse to the same node; `$$` is the canonical output)
+ * - ```mermaid fences <-> code block with language "mermaid" (turndown's
+ *   fenced rule + marked's language classes handle this natively)
+ * - `<details>` collapsible sections stay raw HTML in markdown, exactly
+ *   like GitLab renders them
+ */
+/** Convert editor HTML to GFM markdown */
+export declare function htmlToMarkdown(html: string): string;
+/** Convert GFM markdown to HTML the Tiptap schema can ingest */
+export declare function markdownToHtml(markdown: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/types/editor/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/editor/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkIH,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AA4FD,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD"}