chaeditor 0.1.0

package/dist/markdown-editor-B1qvE40Z.d.mts

@@ -0,0 +1,460 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { ReactNode } from 'react';
+import { E as EditorAttachment, a as EditorContentType } from './image-upload-kind-BJqItE_C.mjs';
+import { U as UploadEditorFile, j as UploadEditorImage, a as HostImageRenderer, k as UploadEditorVideo, M as MarkdownEditorHostAdapters, e as MarkdownToolbarPresetItemKey, h as MarkdownToolbarSectionKey, d as MarkdownSegment, c as MarkdownRendererHostAdapters, i as RichMarkdownRenderArgs } from './toolbar-preset-DIsQN390.mjs';
+import { C as ClosePopover, M as MarkdownPrimitiveRegistry } from './markdown-primitive-contract-BXsqbKwY.mjs';
+
+/**
+ * Represents the uploaded attachment payload inserted by the file embed helper.
+ */
+type FileEmbedApplyPayload = EditorAttachment;
+
+type FileEmbedPopoverProps = {
+    contentType: EditorContentType;
+    onApply: (attachment: FileEmbedApplyPayload, closePopover?: ClosePopover) => void;
+    onUploadFile?: UploadEditorFile;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Popover for uploading an attachment and inserting the custom Attachment tag.
+ */
+declare const FileEmbedPopover: ({ contentType, onApply, onUploadFile, onTriggerMouseDown, triggerClassName, }: FileEmbedPopoverProps) => react_jsx_runtime.JSX.Element;
+
+type ColorStylePopoverLabels = {
+    getOptionAriaLabel?: (label: string) => string;
+    panelLabel: string;
+    triggerAriaLabel: string;
+    triggerTooltip: string;
+};
+
+type TextBackgroundColorPopoverProps = {
+    labels?: Partial<ColorStylePopoverLabels>;
+    onApply: (colorHex: string, closePopover?: () => void) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Renders the toolbar popover for background highlight syntax.
+ */
+declare const TextBackgroundColorPopover: ({ labels, onApply, onTriggerMouseDown, triggerClassName, }: TextBackgroundColorPopoverProps) => react_jsx_runtime.JSX.Element;
+
+type TextColorPopoverProps = {
+    labels?: Partial<ColorStylePopoverLabels>;
+    onApply: (colorHex: string, closePopover?: () => void) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Renders the toolbar popover for text color syntax.
+ */
+declare const TextColorPopover: ({ labels, onApply, onTriggerMouseDown, triggerClassName, }: TextColorPopoverProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Represents a single image item selected for markdown insertion.
+ */
+type ImageEmbedItem = {
+    altText: string;
+    url: string;
+};
+/**
+ * Describes the image insertion payload produced by the image embed modal.
+ */
+type ImageEmbedApplyPayload = {
+    items: ImageEmbedItem[];
+    mode: 'gallery' | 'individual';
+};
+
+type ImageEmbedModalProps = {
+    contentType: EditorContentType;
+    onApply: (payload: {
+        items: Array<{
+            altText: string;
+            url: string;
+        }>;
+        mode: 'gallery' | 'individual';
+    }, closePopover?: ClosePopover) => void;
+    onUploadImage?: UploadEditorImage;
+    renderImage?: HostImageRenderer;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Modal for building individual image or gallery insertion payloads from image rows.
+ *
+ * @param props Image modal props.
+ * @returns The trigger button and modal UI.
+ */
+declare const ImageEmbedModal: ({ contentType, onApply, onUploadImage, renderImage, onTriggerMouseDown, triggerClassName, }: ImageEmbedModalProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Supported insertion modes for link helpers.
+ */
+type LinkEmbedMode = 'card' | 'link' | 'preview';
+/**
+ * Label overrides for the built-in link embed popover.
+ */
+type LinkEmbedPopoverLabels = {
+    cardButtonLabel: string;
+    panelLabel: string;
+    previewButtonLabel: string;
+    triggerAriaLabel: string;
+    triggerTooltip: string;
+    urlInputAriaLabel: string;
+    urlPlaceholder: string;
+    hyperlinkButtonLabel: string;
+};
+
+type LinkEmbedPopoverProps = {
+    labels?: Partial<LinkEmbedPopoverLabels>;
+    onApply: (url: string, mode: LinkEmbedMode, closePopover?: ClosePopover) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Popover for inserting links in plain, preview, or card mode.
+ */
+declare const LinkEmbedPopover: ({ labels, onApply, onTriggerMouseDown, triggerClassName, }: LinkEmbedPopoverProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Describes the math insertion payload produced by the math embed popover.
+ */
+type MathEmbedApplyPayload = {
+    formula: string;
+    isBlock: boolean;
+};
+
+type ToolbarTokenPopoverLabels = {
+    panelLabel: string;
+    triggerAriaLabel: string;
+    triggerTooltip: string;
+};
+type ToolbarTokenPopoverProps = {
+    labels: ToolbarTokenPopoverLabels;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    options: ToolbarTokenOption[];
+    triggerClassName?: string;
+    triggerToken: string;
+};
+/**
+ * Groups step-based toolbar commands behind a compact token trigger.
+ */
+declare const ToolbarTokenPopover: ({ labels, onTriggerMouseDown, options, triggerClassName, triggerToken, }: ToolbarTokenPopoverProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Re-exports the video embed helpers from editor-core for backward-compatible imports.
+ */
+
+type VideoEmbedApplyPayload = {
+    provider: 'upload';
+    src?: string;
+} | {
+    provider: 'youtube';
+    videoId?: string;
+};
+
+type VideoEmbedModalProps = {
+    contentType: EditorContentType;
+    onApply: (payload: VideoEmbedApplyPayload, closePopover?: ClosePopover) => void;
+    onUploadVideo?: UploadEditorVideo;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Renders the video embed modal used from the markdown toolbar.
+ *
+ * @param props Trigger, upload, and apply handlers for video insertion.
+ * @returns The video insert trigger and modal UI.
+ */
+declare const VideoEmbedModal: ({ contentType, onApply, onUploadVideo, onTriggerMouseDown, triggerClassName, }: VideoEmbedModalProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Minimal contract required by the markdown toolbar.
+ *
+ * @property contentType Current editor content type.
+ * @property onChange Callback that applies the next textarea value.
+ * @property primitiveRegistry Optional host primitive overrides applied to the toolbar subtree.
+ * @property textareaRef Ref for the active textarea element.
+ * @property uiRegistry Optional UI registry for labels and primitive overrides.
+ */
+type MarkdownToolbarProps = {
+    contentType: EditorContentType;
+    /**
+     * Optional host adapters for uploads and renderer overrides.
+     *
+     * When omitted, upload-oriented helpers should disable the related action instead of
+     * assuming a built-in backend exists.
+     */
+    adapters?: MarkdownEditorHostAdapters;
+    /** Applies the next editor value after a toolbar action finishes. */
+    onChange: (value: string) => void;
+    /** Optional primitive registry applied to the toolbar subtree. */
+    primitiveRegistry?: MarkdownPrimitiveRegistry;
+    /** Active textarea ref used by selection-based toolbar commands. */
+    textareaRef: React.RefObject<HTMLTextAreaElement | null>;
+    /** Optional UI registry for labels and built-in popover replacements. */
+    uiRegistry?: MarkdownToolbarUiRegistry;
+};
+/**
+ * Label overrides for built-in toolbar popovers.
+ */
+type MarkdownToolbarUiLabels = {
+    /** Label overrides for the text background color popover. */
+    backgroundColorPopover?: Partial<ColorStylePopoverLabels>;
+    /** Label overrides for the grouped heading token popover. */
+    headingPopover?: Partial<ToolbarTokenPopoverLabels>;
+    /** Label overrides for the link embed popover. */
+    linkEmbedPopover?: Partial<LinkEmbedPopoverLabels>;
+    /** Label overrides for the text color popover. */
+    textColorPopover?: Partial<ColorStylePopoverLabels>;
+    /** Label overrides for the grouped toggle token popover. */
+    togglePopover?: Partial<ToolbarTokenPopoverLabels>;
+};
+/**
+ * Render registry for replacing built-in toolbar popovers.
+ *
+ * Each renderer receives the same contract as the built-in helper so host applications
+ * can replace only the UI shell while keeping the existing toolbar behavior.
+ */
+type MarkdownToolbarPopoverRegistry = {
+    alignPopover?: (props: AlignPopoverRenderProps) => React.ReactNode;
+    backgroundColorPopover?: (props: TextColorPopoverRenderProps) => React.ReactNode;
+    fileEmbedPopover?: (props: FileEmbedPopoverRenderProps) => React.ReactNode;
+    headingPopover?: (props: ToolbarTokenPopoverProps) => React.ReactNode;
+    imageEmbedModal?: (props: ImageEmbedModalRenderProps) => React.ReactNode;
+    linkEmbedPopover?: (props: LinkEmbedPopoverRenderProps) => React.ReactNode;
+    mathEmbedPopover?: (props: MathEmbedPopoverRenderProps) => React.ReactNode;
+    textColorPopover?: (props: TextColorPopoverRenderProps) => React.ReactNode;
+    togglePopover?: (props: ToolbarTokenPopoverProps) => React.ReactNode;
+    videoEmbedModal?: (props: VideoEmbedModalRenderProps) => React.ReactNode;
+};
+/**
+ * Toolbar UI customization entry point.
+ *
+ * Use this registry to override labels only, replace selected popovers, or do both.
+ */
+type MarkdownToolbarUiRegistry = {
+    labels?: MarkdownToolbarUiLabels;
+    popovers?: MarkdownToolbarPopoverRegistry;
+};
+/**
+ * Props passed to a custom link embed popover renderer.
+ */
+type LinkEmbedPopoverRenderProps = {
+    /** Optional label overrides merged into the built-in defaults. */
+    labels?: Partial<LinkEmbedPopoverLabels>;
+    /** Applies the selected link mode and URL to the active editor selection. */
+    onApply: (url: string, mode: LinkEmbedMode, closePopover?: ClosePopover) => void;
+    /** Mouse-down hook used to preserve textarea focus before opening the helper. */
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    /** Optional class name for the trigger button wrapper. */
+    triggerClassName?: string;
+};
+/**
+ * Props passed to a custom align popover renderer.
+ */
+type AlignPopoverRenderProps = {
+    /** Applies the selected block alignment. */
+    onApply: (align: 'center' | 'left' | 'right', closePopover?: ClosePopover) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Props passed to a custom math embed popover renderer.
+ */
+type MathEmbedPopoverRenderProps = {
+    /** Inserts the provided math formula into the editor. */
+    onApply: (payload: MathEmbedApplyPayload, closePopover?: ClosePopover) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Props passed to a custom color popover renderer.
+ */
+type TextColorPopoverRenderProps = {
+    labels?: Partial<ColorStylePopoverLabels>;
+    /** Applies the selected color token or hex value. */
+    onApply: (colorHex: string, closePopover?: ClosePopover) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    triggerClassName?: string;
+};
+/**
+ * Props passed to a custom file embed popover renderer.
+ */
+type FileEmbedPopoverRenderProps = {
+    /** Current editor content type forwarded to the upload adapter. */
+    contentType: EditorContentType;
+    /** Inserts the uploaded attachment into the editor. */
+    onApply: (attachment: FileEmbedApplyPayload, closePopover?: ClosePopover) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    /** Optional upload adapter. When omitted, upload-specific actions should be disabled. */
+    onUploadFile?: MarkdownEditorHostAdapters['uploadFile'];
+    triggerClassName?: string;
+};
+/**
+ * Props passed to a custom image embed modal renderer.
+ */
+type ImageEmbedModalRenderProps = {
+    /** Current editor content type forwarded to the upload adapter. */
+    contentType: EditorContentType;
+    /** Inserts one or more image references into the editor. */
+    onApply: (payload: ImageEmbedApplyPayload, closePopover?: ClosePopover) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    /** Optional framework-specific image renderer override for previews. */
+    renderImage?: MarkdownEditorHostAdapters['renderImage'];
+    /** Optional upload adapter. When omitted, upload-specific actions should be disabled. */
+    onUploadImage?: MarkdownEditorHostAdapters['uploadImage'];
+    triggerClassName?: string;
+};
+/**
+ * Props passed to a custom video embed modal renderer.
+ */
+type VideoEmbedModalRenderProps = {
+    /** Current editor content type forwarded to the upload adapter. */
+    contentType: EditorContentType;
+    /** Inserts either an uploaded video or a YouTube reference into the editor. */
+    onApply: (payload: VideoEmbedApplyPayload, closePopover?: ClosePopover) => void;
+    onTriggerMouseDown?: React.MouseEventHandler<HTMLButtonElement>;
+    /** Optional upload adapter. When omitted, upload-specific actions should be disabled. */
+    onUploadVideo?: MarkdownEditorHostAdapters['uploadVideo'];
+    triggerClassName?: string;
+};
+
+type ToolbarActionItem = {
+    icon?: React.ReactNode;
+    key: string;
+    label: string;
+    onClick: () => void;
+    token?: string;
+};
+type ToolbarTokenOption = {
+    key: string;
+    label: string;
+    onClick: () => void;
+    token: string;
+};
+type ToolbarCustomItem = {
+    key: MarkdownToolbarPresetItemKey;
+    node: React.ReactNode;
+    type: 'custom';
+};
+type ToolbarSectionItem = {
+    action: ToolbarActionItem;
+    key: string;
+    type: 'action';
+} | ToolbarCustomItem;
+type ToolbarSection = {
+    items: ToolbarSectionItem[];
+    key: MarkdownToolbarSectionKey;
+};
+
+type ResolvedMarkdownToolbarUiRegistry = {
+    renderAlignPopover: (props: AlignPopoverRenderProps) => React.ReactNode;
+    renderBackgroundColorPopover: (props: TextColorPopoverRenderProps) => React.ReactNode;
+    renderFileEmbedPopover: (props: FileEmbedPopoverRenderProps) => React.ReactNode;
+    renderHeadingPopover: (props: React.ComponentProps<typeof ToolbarTokenPopover>) => React.ReactNode;
+    renderImageEmbedModal: (props: ImageEmbedModalRenderProps) => React.ReactNode;
+    renderLinkEmbedPopover: (props: LinkEmbedPopoverRenderProps) => React.ReactNode;
+    renderMathEmbedPopover: (props: MathEmbedPopoverRenderProps) => React.ReactNode;
+    renderTextColorPopover: (props: TextColorPopoverRenderProps) => React.ReactNode;
+    renderTogglePopover: (props: React.ComponentProps<typeof ToolbarTokenPopover>) => React.ReactNode;
+    renderVideoEmbedModal: (props: VideoEmbedModalRenderProps) => React.ReactNode;
+};
+/**
+ * Creates the built-in toolbar UI registry used by the editor package.
+ */
+declare const createDefaultMarkdownToolbarUiRegistry: () => MarkdownToolbarPopoverRegistry;
+/**
+ * Resolves the toolbar UI registry by merging host overrides with built-in implementations.
+ */
+declare const resolveMarkdownToolbarUiRegistry: (uiRegistry?: MarkdownToolbarUiRegistry) => ResolvedMarkdownToolbarUiRegistry;
+
+/**
+ * Renders the markdown formatting toolbar for a textarea editor.
+ */
+declare const MarkdownToolbar: ({ adapters, contentType, onChange, primitiveRegistry, textareaRef, uiRegistry, }: MarkdownToolbarProps) => react_jsx_runtime.JSX.Element;
+
+type RichMarkdownCustomSegment = Extract<MarkdownSegment, {
+    type: 'attachment' | 'gallery' | 'math' | 'video';
+}>;
+type RichMarkdownSegmentRendererArgs<TSegment extends RichMarkdownCustomSegment> = {
+    key: string;
+    segment: TSegment;
+};
+type RichMarkdownRendererRegistry = {
+    attachment: (args: RichMarkdownSegmentRendererArgs<Extract<MarkdownSegment, {
+        type: 'attachment';
+    }>>) => React.ReactNode;
+    gallery: (args: RichMarkdownSegmentRendererArgs<Extract<MarkdownSegment, {
+        type: 'gallery';
+    }>>) => React.ReactNode;
+    math: (args: RichMarkdownSegmentRendererArgs<Extract<MarkdownSegment, {
+        type: 'math';
+    }>>) => React.ReactNode;
+    video: (args: RichMarkdownSegmentRendererArgs<Extract<MarkdownSegment, {
+        type: 'video';
+    }>>) => React.ReactNode;
+};
+type PartialRichMarkdownRendererRegistry = Partial<RichMarkdownRendererRegistry>;
+/**
+ * Returns the default custom segment renderers for rich markdown content.
+ *
+ * @returns The default renderer registry.
+ */
+declare const createDefaultRichMarkdownRendererRegistry: (adapters?: MarkdownRendererHostAdapters) => RichMarkdownRendererRegistry;
+/**
+ * Merges the default rich-markdown renderers with host overrides.
+ *
+ * @param overrides Partial renderer overrides from the host app.
+ * @returns The merged renderer registry.
+ */
+declare const createRichMarkdownRendererRegistry: (overrides?: PartialRichMarkdownRendererRegistry, adapters?: MarkdownRendererHostAdapters) => RichMarkdownRendererRegistry;
+
+type MarkdownFragmentRenderer = (markdown: string, key: string) => ReactNode;
+type RenderRichMarkdownArgs = RichMarkdownRenderArgs & {
+    adapters?: MarkdownRendererHostAdapters;
+    renderMarkdownFragment: MarkdownFragmentRenderer;
+    renderers?: PartialRichMarkdownRendererRegistry;
+};
+/**
+ * Converts parsed markdown fragments and custom segments into React nodes.
+ *
+ * @param markdown Raw markdown string.
+ * @param renderMarkdownFragment Renderer for plain markdown fragments.
+ * @param adapters Optional host adapters used by segment renderers.
+ * @param renderers Optional custom renderer overrides.
+ * @returns A list of rendered React nodes.
+ */
+declare const renderRichMarkdown: ({ adapters, markdown, renderMarkdownFragment, renderers, }: RenderRichMarkdownArgs) => (string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined)[];
+
+type MarkdownRendererProps = {
+    adapters?: MarkdownRendererHostAdapters;
+    emptyText?: string;
+    locale?: string;
+    markdown: string | null;
+    renderers?: PartialRichMarkdownRendererRegistry;
+};
+/**
+ * Renders a markdown string into SSR-friendly React nodes.
+ */
+declare const MarkdownRenderer: ({ adapters, emptyText, locale, markdown, renderers, }: MarkdownRendererProps) => Promise<react_jsx_runtime.JSX.Element | null>;
+
+type MarkdownEditorProps = {
+    adapters?: MarkdownEditorHostAdapters;
+    className?: string;
+    contentType: EditorContentType;
+    locale?: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    previewEmptyText?: string;
+    primitiveRegistry?: MarkdownPrimitiveRegistry;
+    renderers?: PartialRichMarkdownRendererRegistry;
+    uiRegistry?: MarkdownToolbarUiRegistry;
+    value: string;
+};
+/**
+ * Renders a textarea-based markdown editor with a toolbar and live preview.
+ */
+declare const MarkdownEditor: ({ adapters, className, contentType, locale, onChange, placeholder, previewEmptyText, primitiveRegistry, renderers, uiRegistry, value, }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+
+export { type AlignPopoverRenderProps as A, FileEmbedPopover as F, ImageEmbedModal as I, LinkEmbedPopover as L, MarkdownEditor as M, type PartialRichMarkdownRendererRegistry as P, type RichMarkdownRendererRegistry as R, TextBackgroundColorPopover as T, VideoEmbedModal as V, type FileEmbedPopoverRenderProps as a, type ImageEmbedModalRenderProps as b, type LinkEmbedPopoverRenderProps as c, type MarkdownEditorProps as d, MarkdownRenderer as e, MarkdownToolbar as f, type MarkdownToolbarPopoverRegistry as g, type MarkdownToolbarProps as h, type MarkdownToolbarUiLabels as i, type MarkdownToolbarUiRegistry as j, type RichMarkdownSegmentRendererArgs as k, TextColorPopover as l, type TextColorPopoverRenderProps as m, type ToolbarActionItem as n, type ToolbarSection as o, type ToolbarSectionItem as p, type ToolbarTokenOption as q, type VideoEmbedModalRenderProps as r, createDefaultMarkdownToolbarUiRegistry as s, createDefaultRichMarkdownRendererRegistry as t, createRichMarkdownRendererRegistry as u, renderRichMarkdown as v, resolveMarkdownToolbarUiRegistry as w, type MathEmbedApplyPayload as x };