chaeditor 0.1.0

package/dist/core.d.mts

@@ -0,0 +1,347 @@
+export { E as EditorAttachment, a as EditorContentType } from './image-upload-kind-BJqItE_C.mjs';
+export { D as DEFAULT_MARKDOWN_TOOLBAR_PRESET, F as FetchLinkPreviewMeta, H as HostImageRenderProps, a as HostImageRenderer, M as MarkdownEditorHostAdapters, b as MarkdownImageViewerLabels, c as MarkdownRendererHostAdapters, d as MarkdownSegment, e as MarkdownToolbarPresetItemKey, f as MarkdownToolbarPresetSection, g as MarkdownToolbarResolvedSection, h as MarkdownToolbarSectionKey, P as PreviewImageSource, R as ResolveAttachmentHref, i as RichMarkdownRenderArgs, U as UploadEditorFile, j as UploadEditorImage, k as UploadEditorVideo, l as decodeHtmlAttributeEntities, p as parseRichMarkdownSegments, m as parseToggleTitle, r as resolveMarkdownToolbarPresetSections } from './toolbar-preset-DIsQN390.mjs';
+import 'react';
+
+declare const EDITOR_ATTACHMENT_MAX_FILE_SIZE: number;
+declare const EDITOR_ATTACHMENT_FILE_INPUT_ACCEPT: string;
+/**
+ * Checks whether the file name uses an allowed attachment extension.
+ */
+declare const isAllowedEditorAttachmentExtension: (fileName: string) => boolean;
+/**
+ * Checks whether the file matches the attachment upload policy.
+ */
+declare const isAllowedEditorAttachmentFile: (file: File) => boolean;
+
+declare const EDITOR_VIDEO_MAX_FILE_SIZE: number;
+declare const EDITOR_VIDEO_FILE_INPUT_ACCEPT: string;
+/**
+ * Checks whether the file name uses an allowed video extension.
+ */
+declare const isAllowedEditorVideoExtension: (fileName: string) => boolean;
+/**
+ * Checks whether the file matches the video upload policy.
+ */
+declare const isAllowedEditorVideoFile: (file: File) => boolean;
+
+/**
+ * Applies a transform only to prose outside fenced blocks and inline code.
+ *
+ * @param markdown Raw markdown string.
+ * @param transform Transform applied to prose segments.
+ * @returns Markdown with code segments preserved.
+ */
+declare const transformMarkdownOutsideCode: (markdown: string, transform: (value: string) => string) => string;
+/**
+ * Converts custom inline syntax into link-like tokens consumable by react-markdown.
+ *
+ * @param markdown Raw markdown string.
+ * @returns Markdown with normalized inline directives.
+ */
+declare const preprocessMarkdownInlineSyntax: (markdown: string) => string;
+/**
+ * Normalizes raw HTML aliases such as line breaks and horizontal rules into markdown equivalents.
+ *
+ * @param markdown Raw markdown string.
+ * @returns Markdown with HTML aliases normalized.
+ */
+declare const normalizeMarkdownHtmlAliases: (markdown: string) => string;
+
+type EditorLinkMode = 'card' | 'embed' | 'link' | 'preview';
+type BuildEditorLinkInsertionInput = {
+    clipboardText: string;
+    selectedText: string;
+};
+type EditorLinkInsertion = {
+    text: string;
+    type: 'link';
+};
+type CreateMarkdownLinkByModeInput = {
+    label: string;
+    mode: EditorLinkMode;
+    url: string;
+};
+/**
+ * Combines selected text and a URL into markdown link syntax.
+ */
+declare const createMarkdownLink: (label: string, url: string, title?: string) => string;
+/**
+ * Creates markdown link syntax for the selected editor link mode.
+ */
+declare const createMarkdownLinkByMode: ({ label, mode, url }: CreateMarkdownLinkByModeInput) => string;
+/**
+ * Resolves markdown insertion text from clipboard input and the current selection.
+ */
+declare const buildEditorLinkInsertion: ({ clipboardText, selectedText, }: BuildEditorLinkInsertionInput) => EditorLinkInsertion | null;
+
+type VideoProvider = 'upload' | 'youtube';
+type YoutubeVideoEmbedReference = {
+    provider: 'youtube';
+    videoId: string;
+};
+type UploadVideoEmbedReference = {
+    provider: 'upload';
+    src: string;
+};
+type VideoEmbedReference = UploadVideoEmbedReference | YoutubeVideoEmbedReference;
+/**
+ * Extracts a supported video reference from a user-provided URL.
+ *
+ * @param value Raw video URL string.
+ * @returns A normalized video reference or null.
+ */
+declare const extractVideoEmbedReference: (value: string) => VideoEmbedReference | null;
+/**
+ * Extracts only the YouTube video id from a supported URL.
+ *
+ * @param value Raw YouTube URL string.
+ * @returns A YouTube video id or null.
+ */
+declare const extractYoutubeId: (value: string) => string | null;
+/**
+ * Builds the custom Video markdown tag from a normalized reference.
+ *
+ * @param reference Video provider reference.
+ * @returns A custom Video markdown string.
+ */
+declare const createVideoEmbedMarkdown: (reference: VideoEmbedReference) => string;
+/**
+ * Builds a Video markdown tag for a YouTube video id.
+ *
+ * @param videoId YouTube video id.
+ * @returns A YouTube Video markdown string.
+ */
+declare const createYoutubeEmbedMarkdown: (videoId: string) => string;
+/**
+ * Builds a Video markdown tag for an uploaded video URL.
+ *
+ * @param src Public URL of the uploaded video.
+ * @returns An upload Video markdown string.
+ */
+declare const createUploadedVideoEmbedMarkdown: (src: string) => string;
+
+/**
+ * Builds markdown image syntax for a single image.
+ *
+ * @param altText Image alt text.
+ * @param url Image URL.
+ * @returns A markdown image string.
+ */
+declare const createImageEmbedMarkdown: (altText: string, url: string) => string;
+/**
+ * Builds multiple standalone markdown image blocks.
+ *
+ * @param items Image entries.
+ * @returns Markdown image blocks joined by blank lines.
+ */
+declare const createImageEmbedMarkdownGroup: (items: Array<{
+    altText: string;
+    url: string;
+}>) => string;
+/**
+ * Builds a gallery block from multiple image entries.
+ *
+ * @param items Image entries for the gallery.
+ * @returns A gallery block string.
+ */
+declare const createImageGalleryMarkdown: (items: Array<{
+    altText: string;
+    url: string;
+}>) => string;
+/**
+ * Builds the custom Attachment markdown tag.
+ *
+ * @param contentType Attachment MIME type.
+ * @param fileName Attachment file name.
+ * @param fileSize Attachment size in bytes.
+ * @param url Attachment URL.
+ * @returns A custom Attachment markdown string.
+ */
+declare const createAttachmentEmbedMarkdown: ({ contentType, fileName, fileSize, url, }: {
+    contentType: string;
+    fileName: string;
+    fileSize: number;
+    url: string;
+}) => string;
+/**
+ * Builds the custom Math markdown tag.
+ *
+ * @param formula LaTeX formula string.
+ * @param isBlock Whether the formula should be rendered as a block.
+ * @returns A custom Math markdown string.
+ */
+declare const createMathEmbedMarkdown: ({ formula, isBlock, }: {
+    formula: string;
+    isBlock: boolean;
+}) => string;
+/**
+ * Builds an align block template and its default cursor position.
+ *
+ * @param align Alignment direction.
+ * @returns The align block text and cursor offset.
+ */
+declare const createAlignBlockMarkdown: (align: "center" | "left" | "right") => {
+    cursorOffset: number;
+    text: string;
+};
+/**
+ * Builds a toggle block template and its default cursor position.
+ *
+ * @param level Heading level used in the toggle title.
+ * @param selectedText Selected title text.
+ * @returns The toggle block text and cursor offset.
+ */
+declare const createToggleBlockMarkdown: (level: 1 | 2 | 3 | 4, selectedText: string) => {
+    cursorOffset: number;
+    text: string;
+};
+
+type TextareaValueChangeHandler = (value: string) => void;
+type TextareaValueTransform = (textarea: HTMLTextAreaElement) => string;
+/**
+ * Wraps the current selection with prefix and suffix strings.
+ * Inserts the placeholder and selects it when there is no selection.
+ */
+declare const wrapSelection: (textarea: HTMLTextAreaElement, before: string, after: string, placeholder?: string) => string;
+/**
+ * Toggles a line prefix for each selected line.
+ * Empty lines are left unchanged.
+ */
+declare const prefixLine: (textarea: HTMLTextAreaElement, prefix: string) => string;
+/**
+ * Replaces the current selection with a template and restores the caret.
+ */
+declare const insertTemplate: (textarea: HTMLTextAreaElement, template: string, cursorOffset?: number) => string;
+/**
+ * Restores the selection range on the rendered textarea after state updates.
+ */
+declare const restoreCursor: (textarea: HTMLTextAreaElement, start: number, end: number) => void;
+/**
+ * Returns focus to the textarea after a toolbar interaction.
+ */
+declare const focusTextarea: (textarea: HTMLTextAreaElement) => void;
+/**
+ * Reads the pending selection range stored for the next render cycle.
+ */
+declare const getPendingSelection: (textarea: HTMLTextAreaElement) => {
+    end: number;
+    start: number;
+};
+/**
+ * Runs a textarea transform and restores focus and selection after `onChange`.
+ */
+declare const applyTextareaTransform: (textarea: HTMLTextAreaElement, onChange: TextareaValueChangeHandler, transform: TextareaValueTransform) => string;
+/**
+ * Toggles the selected lines to the requested heading level.
+ */
+declare const toggleHeadingLine: (textarea: HTMLTextAreaElement, level: 1 | 2 | 3 | 4) => string;
+/**
+ * Continues or exits the current markdown list item on Enter.
+ */
+declare const continueMarkdownList: (textarea: HTMLTextAreaElement) => string | null;
+/**
+ * Increases list indentation for the selected markdown list items.
+ */
+declare const indentMarkdownList: (textarea: HTMLTextAreaElement) => string | null;
+/**
+ * Decreases list indentation for the selected markdown list items.
+ */
+declare const outdentMarkdownList: (textarea: HTMLTextAreaElement) => string | null;
+
+declare const CHAEDITOR_THEME_VARIABLES: {
+    readonly border: "--chaeditor-color-border";
+    readonly borderStrong: "--chaeditor-color-border-strong";
+    readonly focusRing: "--chaeditor-color-focus-ring";
+    readonly monoFont: "--chaeditor-font-mono";
+    readonly muted: "--chaeditor-color-muted";
+    readonly overlayBackdrop: "--chaeditor-color-overlay-backdrop";
+    readonly primary: "--chaeditor-color-primary";
+    readonly primaryContrast: "--chaeditor-color-primary-contrast";
+    readonly primaryHover: "--chaeditor-color-primary-hover";
+    readonly primaryMuted: "--chaeditor-color-primary-muted";
+    readonly primarySubtle: "--chaeditor-color-primary-subtle";
+    readonly sansFont: "--chaeditor-font-sans";
+    readonly sansJaFont: "--chaeditor-font-sans-ja";
+    readonly success: "--chaeditor-color-success";
+    readonly surface: "--chaeditor-color-surface";
+    readonly surfaceMuted: "--chaeditor-color-surface-muted";
+    readonly surfaceStrong: "--chaeditor-color-surface-strong";
+    readonly text: "--chaeditor-color-text";
+    readonly textSubtle: "--chaeditor-color-text-subtle";
+    readonly error: "--chaeditor-color-error";
+};
+type ChaeditorThemeVariableName = (typeof CHAEDITOR_THEME_VARIABLES)[keyof typeof CHAEDITOR_THEME_VARIABLES];
+type ChaeditorThemeDefinition = Partial<{
+    border: string;
+    borderStrong: string;
+    error: string;
+    focusRing: string;
+    monoFont: string;
+    muted: string;
+    overlayBackdrop: string;
+    primary: string;
+    primaryContrast: string;
+    primaryHover: string;
+    primaryMuted: string;
+    primarySubtle: string;
+    sansFont: string;
+    sansJaFont: string;
+    success: string;
+    surface: string;
+    surfaceMuted: string;
+    surfaceStrong: string;
+    text: string;
+    textSubtle: string;
+}>;
+declare const CHAEDITOR_THEME_DEFAULTS: {
+    readonly dark: {
+        readonly border: "#52525b";
+        readonly borderStrong: "#71717a";
+        readonly error: "#f87171";
+        readonly focusRing: "#1e3a8a";
+        readonly muted: "#a1a1aa";
+        readonly overlayBackdrop: "rgb(9 9 11 / 0.82)";
+        readonly primary: "#93c5fd";
+        readonly primaryContrast: "#18181b";
+        readonly primaryHover: "#bfdbfe";
+        readonly primaryMuted: "#1e40af";
+        readonly primarySubtle: "#1e3a8a";
+        readonly success: "#4ade80";
+        readonly surface: "#18181b";
+        readonly surfaceMuted: "#27272a";
+        readonly surfaceStrong: "#3f3f46";
+        readonly text: "#fafafa";
+        readonly textSubtle: "#d4d4d8";
+    };
+    readonly fonts: {
+        readonly mono: "var(--font-d2coding), 'D2Coding', 'SFMono-Regular', 'JetBrains Mono', Consolas, 'Liberation Mono', monospace";
+        readonly sans: "system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif";
+        readonly sansJa: "system-ui, -apple-system, BlinkMacSystemFont, 'Hiragino Sans', 'Yu Gothic', 'Meiryo', sans-serif";
+    };
+    readonly light: {
+        readonly border: "#d4d4d8";
+        readonly borderStrong: "#a1a1aa";
+        readonly error: "#ef4444";
+        readonly focusRing: "#dbeafe";
+        readonly muted: "#71717a";
+        readonly overlayBackdrop: "rgb(15 23 42 / 0.86)";
+        readonly primary: "#3b82f6";
+        readonly primaryContrast: "#ffffff";
+        readonly primaryHover: "#2563eb";
+        readonly primaryMuted: "#dbeafe";
+        readonly primarySubtle: "#eff6ff";
+        readonly success: "#22c55e";
+        readonly surface: "#ffffff";
+        readonly surfaceMuted: "#f4f4f5";
+        readonly surfaceStrong: "#e4e4e7";
+        readonly text: "#18181b";
+        readonly textSubtle: "#52525b";
+    };
+};
+/**
+ * Converts semantic theme values into CSS custom properties that a host app can attach
+ * to any wrapper element, :root, or theme scope.
+ */
+declare const createChaeditorThemeVars: (theme: ChaeditorThemeDefinition) => Partial<Record<ChaeditorThemeVariableName, string>>;
+
+export { CHAEDITOR_THEME_DEFAULTS, CHAEDITOR_THEME_VARIABLES, type ChaeditorThemeDefinition, type ChaeditorThemeVariableName, EDITOR_ATTACHMENT_FILE_INPUT_ACCEPT, EDITOR_ATTACHMENT_MAX_FILE_SIZE, EDITOR_VIDEO_FILE_INPUT_ACCEPT, EDITOR_VIDEO_MAX_FILE_SIZE, type EditorLinkMode, type UploadVideoEmbedReference, type VideoEmbedReference, type VideoProvider, type YoutubeVideoEmbedReference, applyTextareaTransform, buildEditorLinkInsertion, continueMarkdownList, createAlignBlockMarkdown, createAttachmentEmbedMarkdown, createChaeditorThemeVars, createImageEmbedMarkdown, createImageEmbedMarkdownGroup, createImageGalleryMarkdown, createMarkdownLink, createMarkdownLinkByMode, createMathEmbedMarkdown, createToggleBlockMarkdown, createUploadedVideoEmbedMarkdown, createVideoEmbedMarkdown, createYoutubeEmbedMarkdown, extractVideoEmbedReference, extractYoutubeId, focusTextarea, getPendingSelection, indentMarkdownList, insertTemplate, isAllowedEditorAttachmentExtension, isAllowedEditorAttachmentFile, isAllowedEditorVideoExtension, isAllowedEditorVideoFile, normalizeMarkdownHtmlAliases, outdentMarkdownList, prefixLine, preprocessMarkdownInlineSyntax, restoreCursor, toggleHeadingLine, transformMarkdownOutsideCode, wrapSelection };

package/dist/core.d.ts

@@ -0,0 +1,347 @@
+export { E as EditorAttachment, a as EditorContentType } from './image-upload-kind-BJqItE_C.js';
+export { D as DEFAULT_MARKDOWN_TOOLBAR_PRESET, F as FetchLinkPreviewMeta, H as HostImageRenderProps, a as HostImageRenderer, M as MarkdownEditorHostAdapters, b as MarkdownImageViewerLabels, c as MarkdownRendererHostAdapters, d as MarkdownSegment, e as MarkdownToolbarPresetItemKey, f as MarkdownToolbarPresetSection, g as MarkdownToolbarResolvedSection, h as MarkdownToolbarSectionKey, P as PreviewImageSource, R as ResolveAttachmentHref, i as RichMarkdownRenderArgs, U as UploadEditorFile, j as UploadEditorImage, k as UploadEditorVideo, l as decodeHtmlAttributeEntities, p as parseRichMarkdownSegments, m as parseToggleTitle, r as resolveMarkdownToolbarPresetSections } from './toolbar-preset-B9ttTEol.js';
+import 'react';
+
+declare const EDITOR_ATTACHMENT_MAX_FILE_SIZE: number;
+declare const EDITOR_ATTACHMENT_FILE_INPUT_ACCEPT: string;
+/**
+ * Checks whether the file name uses an allowed attachment extension.
+ */
+declare const isAllowedEditorAttachmentExtension: (fileName: string) => boolean;
+/**
+ * Checks whether the file matches the attachment upload policy.
+ */
+declare const isAllowedEditorAttachmentFile: (file: File) => boolean;
+
+declare const EDITOR_VIDEO_MAX_FILE_SIZE: number;
+declare const EDITOR_VIDEO_FILE_INPUT_ACCEPT: string;
+/**
+ * Checks whether the file name uses an allowed video extension.
+ */
+declare const isAllowedEditorVideoExtension: (fileName: string) => boolean;
+/**
+ * Checks whether the file matches the video upload policy.
+ */
+declare const isAllowedEditorVideoFile: (file: File) => boolean;
+
+/**
+ * Applies a transform only to prose outside fenced blocks and inline code.
+ *
+ * @param markdown Raw markdown string.
+ * @param transform Transform applied to prose segments.
+ * @returns Markdown with code segments preserved.
+ */
+declare const transformMarkdownOutsideCode: (markdown: string, transform: (value: string) => string) => string;
+/**
+ * Converts custom inline syntax into link-like tokens consumable by react-markdown.
+ *
+ * @param markdown Raw markdown string.
+ * @returns Markdown with normalized inline directives.
+ */
+declare const preprocessMarkdownInlineSyntax: (markdown: string) => string;
+/**
+ * Normalizes raw HTML aliases such as line breaks and horizontal rules into markdown equivalents.
+ *
+ * @param markdown Raw markdown string.
+ * @returns Markdown with HTML aliases normalized.
+ */
+declare const normalizeMarkdownHtmlAliases: (markdown: string) => string;
+
+type EditorLinkMode = 'card' | 'embed' | 'link' | 'preview';
+type BuildEditorLinkInsertionInput = {
+    clipboardText: string;
+    selectedText: string;
+};
+type EditorLinkInsertion = {
+    text: string;
+    type: 'link';
+};
+type CreateMarkdownLinkByModeInput = {
+    label: string;
+    mode: EditorLinkMode;
+    url: string;
+};
+/**
+ * Combines selected text and a URL into markdown link syntax.
+ */
+declare const createMarkdownLink: (label: string, url: string, title?: string) => string;
+/**
+ * Creates markdown link syntax for the selected editor link mode.
+ */
+declare const createMarkdownLinkByMode: ({ label, mode, url }: CreateMarkdownLinkByModeInput) => string;
+/**
+ * Resolves markdown insertion text from clipboard input and the current selection.
+ */
+declare const buildEditorLinkInsertion: ({ clipboardText, selectedText, }: BuildEditorLinkInsertionInput) => EditorLinkInsertion | null;
+
+type VideoProvider = 'upload' | 'youtube';
+type YoutubeVideoEmbedReference = {
+    provider: 'youtube';
+    videoId: string;
+};
+type UploadVideoEmbedReference = {
+    provider: 'upload';
+    src: string;
+};
+type VideoEmbedReference = UploadVideoEmbedReference | YoutubeVideoEmbedReference;
+/**
+ * Extracts a supported video reference from a user-provided URL.
+ *
+ * @param value Raw video URL string.
+ * @returns A normalized video reference or null.
+ */
+declare const extractVideoEmbedReference: (value: string) => VideoEmbedReference | null;
+/**
+ * Extracts only the YouTube video id from a supported URL.
+ *
+ * @param value Raw YouTube URL string.
+ * @returns A YouTube video id or null.
+ */
+declare const extractYoutubeId: (value: string) => string | null;
+/**
+ * Builds the custom Video markdown tag from a normalized reference.
+ *
+ * @param reference Video provider reference.
+ * @returns A custom Video markdown string.
+ */
+declare const createVideoEmbedMarkdown: (reference: VideoEmbedReference) => string;
+/**
+ * Builds a Video markdown tag for a YouTube video id.
+ *
+ * @param videoId YouTube video id.
+ * @returns A YouTube Video markdown string.
+ */
+declare const createYoutubeEmbedMarkdown: (videoId: string) => string;
+/**
+ * Builds a Video markdown tag for an uploaded video URL.
+ *
+ * @param src Public URL of the uploaded video.
+ * @returns An upload Video markdown string.
+ */
+declare const createUploadedVideoEmbedMarkdown: (src: string) => string;
+
+/**
+ * Builds markdown image syntax for a single image.
+ *
+ * @param altText Image alt text.
+ * @param url Image URL.
+ * @returns A markdown image string.
+ */
+declare const createImageEmbedMarkdown: (altText: string, url: string) => string;
+/**
+ * Builds multiple standalone markdown image blocks.
+ *
+ * @param items Image entries.
+ * @returns Markdown image blocks joined by blank lines.
+ */
+declare const createImageEmbedMarkdownGroup: (items: Array<{
+    altText: string;
+    url: string;
+}>) => string;
+/**
+ * Builds a gallery block from multiple image entries.
+ *
+ * @param items Image entries for the gallery.
+ * @returns A gallery block string.
+ */
+declare const createImageGalleryMarkdown: (items: Array<{
+    altText: string;
+    url: string;
+}>) => string;
+/**
+ * Builds the custom Attachment markdown tag.
+ *
+ * @param contentType Attachment MIME type.
+ * @param fileName Attachment file name.
+ * @param fileSize Attachment size in bytes.
+ * @param url Attachment URL.
+ * @returns A custom Attachment markdown string.
+ */
+declare const createAttachmentEmbedMarkdown: ({ contentType, fileName, fileSize, url, }: {
+    contentType: string;
+    fileName: string;
+    fileSize: number;
+    url: string;
+}) => string;
+/**
+ * Builds the custom Math markdown tag.
+ *
+ * @param formula LaTeX formula string.
+ * @param isBlock Whether the formula should be rendered as a block.
+ * @returns A custom Math markdown string.
+ */
+declare const createMathEmbedMarkdown: ({ formula, isBlock, }: {
+    formula: string;
+    isBlock: boolean;
+}) => string;
+/**
+ * Builds an align block template and its default cursor position.
+ *
+ * @param align Alignment direction.
+ * @returns The align block text and cursor offset.
+ */
+declare const createAlignBlockMarkdown: (align: "center" | "left" | "right") => {
+    cursorOffset: number;
+    text: string;
+};
+/**
+ * Builds a toggle block template and its default cursor position.
+ *
+ * @param level Heading level used in the toggle title.
+ * @param selectedText Selected title text.
+ * @returns The toggle block text and cursor offset.
+ */
+declare const createToggleBlockMarkdown: (level: 1 | 2 | 3 | 4, selectedText: string) => {
+    cursorOffset: number;
+    text: string;
+};
+
+type TextareaValueChangeHandler = (value: string) => void;
+type TextareaValueTransform = (textarea: HTMLTextAreaElement) => string;
+/**
+ * Wraps the current selection with prefix and suffix strings.
+ * Inserts the placeholder and selects it when there is no selection.
+ */
+declare const wrapSelection: (textarea: HTMLTextAreaElement, before: string, after: string, placeholder?: string) => string;
+/**
+ * Toggles a line prefix for each selected line.
+ * Empty lines are left unchanged.
+ */
+declare const prefixLine: (textarea: HTMLTextAreaElement, prefix: string) => string;
+/**
+ * Replaces the current selection with a template and restores the caret.
+ */
+declare const insertTemplate: (textarea: HTMLTextAreaElement, template: string, cursorOffset?: number) => string;
+/**
+ * Restores the selection range on the rendered textarea after state updates.
+ */
+declare const restoreCursor: (textarea: HTMLTextAreaElement, start: number, end: number) => void;
+/**
+ * Returns focus to the textarea after a toolbar interaction.
+ */
+declare const focusTextarea: (textarea: HTMLTextAreaElement) => void;
+/**
+ * Reads the pending selection range stored for the next render cycle.
+ */
+declare const getPendingSelection: (textarea: HTMLTextAreaElement) => {
+    end: number;
+    start: number;
+};
+/**
+ * Runs a textarea transform and restores focus and selection after `onChange`.
+ */
+declare const applyTextareaTransform: (textarea: HTMLTextAreaElement, onChange: TextareaValueChangeHandler, transform: TextareaValueTransform) => string;
+/**
+ * Toggles the selected lines to the requested heading level.
+ */
+declare const toggleHeadingLine: (textarea: HTMLTextAreaElement, level: 1 | 2 | 3 | 4) => string;
+/**
+ * Continues or exits the current markdown list item on Enter.
+ */
+declare const continueMarkdownList: (textarea: HTMLTextAreaElement) => string | null;
+/**
+ * Increases list indentation for the selected markdown list items.
+ */
+declare const indentMarkdownList: (textarea: HTMLTextAreaElement) => string | null;
+/**
+ * Decreases list indentation for the selected markdown list items.
+ */
+declare const outdentMarkdownList: (textarea: HTMLTextAreaElement) => string | null;
+
+declare const CHAEDITOR_THEME_VARIABLES: {
+    readonly border: "--chaeditor-color-border";
+    readonly borderStrong: "--chaeditor-color-border-strong";
+    readonly focusRing: "--chaeditor-color-focus-ring";
+    readonly monoFont: "--chaeditor-font-mono";
+    readonly muted: "--chaeditor-color-muted";
+    readonly overlayBackdrop: "--chaeditor-color-overlay-backdrop";
+    readonly primary: "--chaeditor-color-primary";
+    readonly primaryContrast: "--chaeditor-color-primary-contrast";
+    readonly primaryHover: "--chaeditor-color-primary-hover";
+    readonly primaryMuted: "--chaeditor-color-primary-muted";
+    readonly primarySubtle: "--chaeditor-color-primary-subtle";
+    readonly sansFont: "--chaeditor-font-sans";
+    readonly sansJaFont: "--chaeditor-font-sans-ja";
+    readonly success: "--chaeditor-color-success";
+    readonly surface: "--chaeditor-color-surface";
+    readonly surfaceMuted: "--chaeditor-color-surface-muted";
+    readonly surfaceStrong: "--chaeditor-color-surface-strong";
+    readonly text: "--chaeditor-color-text";
+    readonly textSubtle: "--chaeditor-color-text-subtle";
+    readonly error: "--chaeditor-color-error";
+};
+type ChaeditorThemeVariableName = (typeof CHAEDITOR_THEME_VARIABLES)[keyof typeof CHAEDITOR_THEME_VARIABLES];
+type ChaeditorThemeDefinition = Partial<{
+    border: string;
+    borderStrong: string;
+    error: string;
+    focusRing: string;
+    monoFont: string;
+    muted: string;
+    overlayBackdrop: string;
+    primary: string;
+    primaryContrast: string;
+    primaryHover: string;
+    primaryMuted: string;
+    primarySubtle: string;
+    sansFont: string;
+    sansJaFont: string;
+    success: string;
+    surface: string;
+    surfaceMuted: string;
+    surfaceStrong: string;
+    text: string;
+    textSubtle: string;
+}>;
+declare const CHAEDITOR_THEME_DEFAULTS: {
+    readonly dark: {
+        readonly border: "#52525b";
+        readonly borderStrong: "#71717a";
+        readonly error: "#f87171";
+        readonly focusRing: "#1e3a8a";
+        readonly muted: "#a1a1aa";
+        readonly overlayBackdrop: "rgb(9 9 11 / 0.82)";
+        readonly primary: "#93c5fd";
+        readonly primaryContrast: "#18181b";
+        readonly primaryHover: "#bfdbfe";
+        readonly primaryMuted: "#1e40af";
+        readonly primarySubtle: "#1e3a8a";
+        readonly success: "#4ade80";
+        readonly surface: "#18181b";
+        readonly surfaceMuted: "#27272a";
+        readonly surfaceStrong: "#3f3f46";
+        readonly text: "#fafafa";
+        readonly textSubtle: "#d4d4d8";
+    };
+    readonly fonts: {
+        readonly mono: "var(--font-d2coding), 'D2Coding', 'SFMono-Regular', 'JetBrains Mono', Consolas, 'Liberation Mono', monospace";
+        readonly sans: "system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif";
+        readonly sansJa: "system-ui, -apple-system, BlinkMacSystemFont, 'Hiragino Sans', 'Yu Gothic', 'Meiryo', sans-serif";
+    };
+    readonly light: {
+        readonly border: "#d4d4d8";
+        readonly borderStrong: "#a1a1aa";
+        readonly error: "#ef4444";
+        readonly focusRing: "#dbeafe";
+        readonly muted: "#71717a";
+        readonly overlayBackdrop: "rgb(15 23 42 / 0.86)";
+        readonly primary: "#3b82f6";
+        readonly primaryContrast: "#ffffff";
+        readonly primaryHover: "#2563eb";
+        readonly primaryMuted: "#dbeafe";
+        readonly primarySubtle: "#eff6ff";
+        readonly success: "#22c55e";
+        readonly surface: "#ffffff";
+        readonly surfaceMuted: "#f4f4f5";
+        readonly surfaceStrong: "#e4e4e7";
+        readonly text: "#18181b";
+        readonly textSubtle: "#52525b";
+    };
+};
+/**
+ * Converts semantic theme values into CSS custom properties that a host app can attach
+ * to any wrapper element, :root, or theme scope.
+ */
+declare const createChaeditorThemeVars: (theme: ChaeditorThemeDefinition) => Partial<Record<ChaeditorThemeVariableName, string>>;
+
+export { CHAEDITOR_THEME_DEFAULTS, CHAEDITOR_THEME_VARIABLES, type ChaeditorThemeDefinition, type ChaeditorThemeVariableName, EDITOR_ATTACHMENT_FILE_INPUT_ACCEPT, EDITOR_ATTACHMENT_MAX_FILE_SIZE, EDITOR_VIDEO_FILE_INPUT_ACCEPT, EDITOR_VIDEO_MAX_FILE_SIZE, type EditorLinkMode, type UploadVideoEmbedReference, type VideoEmbedReference, type VideoProvider, type YoutubeVideoEmbedReference, applyTextareaTransform, buildEditorLinkInsertion, continueMarkdownList, createAlignBlockMarkdown, createAttachmentEmbedMarkdown, createChaeditorThemeVars, createImageEmbedMarkdown, createImageEmbedMarkdownGroup, createImageGalleryMarkdown, createMarkdownLink, createMarkdownLinkByMode, createMathEmbedMarkdown, createToggleBlockMarkdown, createUploadedVideoEmbedMarkdown, createVideoEmbedMarkdown, createYoutubeEmbedMarkdown, extractVideoEmbedReference, extractYoutubeId, focusTextarea, getPendingSelection, indentMarkdownList, insertTemplate, isAllowedEditorAttachmentExtension, isAllowedEditorAttachmentFile, isAllowedEditorVideoExtension, isAllowedEditorVideoFile, normalizeMarkdownHtmlAliases, outdentMarkdownList, prefixLine, preprocessMarkdownInlineSyntax, restoreCursor, toggleHeadingLine, transformMarkdownOutsideCode, wrapSelection };