@djangocfg/ui-tools 2.1.291 → 2.1.293

package/dist/index.d.cts

@@ -374,11 +374,11 @@ interface PlaygroundConfig {
      *    rendered back-to-back in the docs column. Scrollspy picks the
      *    active schema based on what's visible. */
     schemaGrouping?: 'selector' | 'sections';
-    /** Optional URL-hash sync. When enabled, the viewer reads/writes
-     *  ``#<schemaId>/<anchor>`` on the browser location. Falsy value (the
-     *  default) keeps the viewer hash-free. Set to an object with
-     *  ``{ enabled: true }`` to opt in; future fields (e.g. a custom
-     *  adapter) stay backwards compatible. */
+    /** URL-hash sync. When enabled, the viewer reads/writes
+     *  ``#<schemaId>/<anchor>`` on the browser location so deep-links
+     *  to a specific endpoint work out of the box. Defaults to ``true`` —
+     *  pass ``false`` (or ``{ enabled: false }``) to opt out if the host
+     *  page already manages the hash itself. */
     urlSync?: boolean | {
         enabled: boolean;
     };
@@ -2455,6 +2455,25 @@ interface MentionItem {
     description?: string;
     thumbnail?: string;
 }
+/**
+ * Attributes available when rendering a mention to markdown.
+ *
+ * Same shape Tiptap stores on the `mention` node — `id` is the stable
+ * identifier the suggestion popover injected, `label` is the human text
+ * shown to the user. Either field may be empty if the upstream config
+ * never populated it; renderers should fall back accordingly.
+ */
+interface MentionAttrs {
+    id: string;
+    label: string;
+}
+/**
+ * Function that converts a mention node into its markdown serialization.
+ *
+ * The returned string is what `@tiptap/markdown` writes into the markdown
+ * output of `MarkdownEditor.getMarkdown()`.
+ */
+type MentionMarkdownRenderer = (attrs: MentionAttrs) => string;
 /** Mention configuration */
 interface MentionConfig {
     /** Trigger character (default: '@') */
@@ -2463,6 +2482,18 @@ interface MentionConfig {
     items: MentionItem[];
     /** Max dropdown items (default: 5) */
     maxItems?: number;
+    /**
+     * Custom serializer for mentions when `MarkdownEditor.getMarkdown()` runs.
+     *
+     * Defaults to `mentionPresets.plainAt` which yields `@<label>` (or `@<id>`
+     * when `label` is missing). Use one of `mentionPresets`, or supply your
+     * own function for full control over how mentions appear in the output
+     * markdown string.
+     *
+     * Note: this only affects the *markdown* output. `editor.getText()` and
+     * the rendered DOM still go through `renderText` (`@<label>` by default).
+     */
+    renderMarkdown?: MentionMarkdownRenderer;
 }
 
 interface MarkdownEditorProps {
@@ -2496,6 +2527,35 @@ interface MarkdownEditorProps {
 }
 declare function MarkdownEditor({ value, onChange, placeholder, minHeight, className, disabled, showToolbar, mentions, onMentionIdsChange, }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Built-in serializers for the `MentionConfig.renderMarkdown` callback.
+ *
+ * Pick one based on what consumes the markdown:
+ *
+ * - LLM / chat composer    → `plainAt`     (the default)
+ * - Plain text export      → `plainLabel`
+ * - Web app with deep-link → `markdownLink(baseUrl)`
+ * - Notion / Linear-style  → `customUri(scheme, kind)`
+ * - Slack-style id refs    → `slackStyle`
+ * - HTML-allowing renderer → `htmlSpan(className?)`
+ *
+ * Or pass a custom function — the type is just `(attrs) => string`.
+ */
+declare const mentionPresets: {
+    /** "@Label" — default, ideal for chat where LLMs read the text. */
+    plainAt: MentionMarkdownRenderer;
+    /** "Label" — bare label, no @ prefix. */
+    plainLabel: MentionMarkdownRenderer;
+    /** "[@Label](baseUrl/id)" — clickable markdown link. */
+    markdownLink: (baseUrl: string) => MentionMarkdownRenderer;
+    /** "@[Label](scheme://kind/id)" — Notion / Linear-style custom URI. */
+    customUri: (scheme: string, kind: string) => MentionMarkdownRenderer;
+    /** "<@id>" — Slack-style id-only reference (label dropped — receivers resolve it). */
+    slackStyle: MentionMarkdownRenderer;
+    /** Inline HTML span — for products that consume markdown with raw HTML allowed. */
+    htmlSpan: (className?: string) => MentionMarkdownRenderer;
+};
+
 interface BlobUrlEntry {
     url: string;
     refCount: number;
@@ -2674,4 +2734,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, EFFECT_ANIMATIONS, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionConfig, type MentionItem, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioBusReturn, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioBus, useAudioBusStore, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };
+export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, EFFECT_ANIMATIONS, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioBusReturn, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioBus, useAudioBusStore, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };

package/dist/index.d.ts

@@ -374,11 +374,11 @@ interface PlaygroundConfig {
      *    rendered back-to-back in the docs column. Scrollspy picks the
      *    active schema based on what's visible. */
     schemaGrouping?: 'selector' | 'sections';
-    /** Optional URL-hash sync. When enabled, the viewer reads/writes
-     *  ``#<schemaId>/<anchor>`` on the browser location. Falsy value (the
-     *  default) keeps the viewer hash-free. Set to an object with
-     *  ``{ enabled: true }`` to opt in; future fields (e.g. a custom
-     *  adapter) stay backwards compatible. */
+    /** URL-hash sync. When enabled, the viewer reads/writes
+     *  ``#<schemaId>/<anchor>`` on the browser location so deep-links
+     *  to a specific endpoint work out of the box. Defaults to ``true`` —
+     *  pass ``false`` (or ``{ enabled: false }``) to opt out if the host
+     *  page already manages the hash itself. */
     urlSync?: boolean | {
         enabled: boolean;
     };
@@ -2455,6 +2455,25 @@ interface MentionItem {
     description?: string;
     thumbnail?: string;
 }
+/**
+ * Attributes available when rendering a mention to markdown.
+ *
+ * Same shape Tiptap stores on the `mention` node — `id` is the stable
+ * identifier the suggestion popover injected, `label` is the human text
+ * shown to the user. Either field may be empty if the upstream config
+ * never populated it; renderers should fall back accordingly.
+ */
+interface MentionAttrs {
+    id: string;
+    label: string;
+}
+/**
+ * Function that converts a mention node into its markdown serialization.
+ *
+ * The returned string is what `@tiptap/markdown` writes into the markdown
+ * output of `MarkdownEditor.getMarkdown()`.
+ */
+type MentionMarkdownRenderer = (attrs: MentionAttrs) => string;
 /** Mention configuration */
 interface MentionConfig {
     /** Trigger character (default: '@') */
@@ -2463,6 +2482,18 @@ interface MentionConfig {
     items: MentionItem[];
     /** Max dropdown items (default: 5) */
     maxItems?: number;
+    /**
+     * Custom serializer for mentions when `MarkdownEditor.getMarkdown()` runs.
+     *
+     * Defaults to `mentionPresets.plainAt` which yields `@<label>` (or `@<id>`
+     * when `label` is missing). Use one of `mentionPresets`, or supply your
+     * own function for full control over how mentions appear in the output
+     * markdown string.
+     *
+     * Note: this only affects the *markdown* output. `editor.getText()` and
+     * the rendered DOM still go through `renderText` (`@<label>` by default).
+     */
+    renderMarkdown?: MentionMarkdownRenderer;
 }
 
 interface MarkdownEditorProps {
@@ -2496,6 +2527,35 @@ interface MarkdownEditorProps {
 }
 declare function MarkdownEditor({ value, onChange, placeholder, minHeight, className, disabled, showToolbar, mentions, onMentionIdsChange, }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Built-in serializers for the `MentionConfig.renderMarkdown` callback.
+ *
+ * Pick one based on what consumes the markdown:
+ *
+ * - LLM / chat composer    → `plainAt`     (the default)
+ * - Plain text export      → `plainLabel`
+ * - Web app with deep-link → `markdownLink(baseUrl)`
+ * - Notion / Linear-style  → `customUri(scheme, kind)`
+ * - Slack-style id refs    → `slackStyle`
+ * - HTML-allowing renderer → `htmlSpan(className?)`
+ *
+ * Or pass a custom function — the type is just `(attrs) => string`.
+ */
+declare const mentionPresets: {
+    /** "@Label" — default, ideal for chat where LLMs read the text. */
+    plainAt: MentionMarkdownRenderer;
+    /** "Label" — bare label, no @ prefix. */
+    plainLabel: MentionMarkdownRenderer;
+    /** "[@Label](baseUrl/id)" — clickable markdown link. */
+    markdownLink: (baseUrl: string) => MentionMarkdownRenderer;
+    /** "@[Label](scheme://kind/id)" — Notion / Linear-style custom URI. */
+    customUri: (scheme: string, kind: string) => MentionMarkdownRenderer;
+    /** "<@id>" — Slack-style id-only reference (label dropped — receivers resolve it). */
+    slackStyle: MentionMarkdownRenderer;
+    /** Inline HTML span — for products that consume markdown with raw HTML allowed. */
+    htmlSpan: (className?: string) => MentionMarkdownRenderer;
+};
+
 interface BlobUrlEntry {
     url: string;
     refCount: number;
@@ -2674,4 +2734,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, EFFECT_ANIMATIONS, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionConfig, type MentionItem, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioBusReturn, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioBus, useAudioBusStore, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };
+export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, EFFECT_ANIMATIONS, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioBusReturn, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioBus, useAudioBusStore, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };

package/dist/index.mjs

@@ -23,6 +23,7 @@ import Placeholder from '@tiptap/extension-placeholder';
 import Mention from '@tiptap/extension-mention';
 import { Markdown } from '@tiptap/markdown';
 import { Bold, Italic, Strikethrough, Code, Heading1, Heading2, Heading3, List, ListOrdered, Quote, Minus } from 'lucide-react';
+import { autoUpdate, computePosition, offset, flip, shift } from '@floating-ui/dom';
 
 function Spinner({ className }) {
   const t = useAppT();
@@ -237,7 +238,7 @@ function OpenapiLoadingFallback() {
 }
 __name(OpenapiLoadingFallback, "OpenapiLoadingFallback");
 var LazyDocsLayout = createLazyComponent(
-  () => import('./DocsLayout-JPXFUKAR.mjs').then((mod) => ({ default: mod.DocsLayout })),
+  () => import('./DocsLayout-XB55R7YG.mjs').then((mod) => ({ default: mod.DocsLayout })),
   {
     displayName: "LazyDocsLayout",
     fallback: /* @__PURE__ */ jsx(OpenapiLoadingFallback, {})
@@ -392,7 +393,7 @@ function LottiePlayer(props) {
 }
 __name(LottiePlayer, "LottiePlayer");
 var DocsLayout = lazy(
-  () => import('./DocsLayout-JPXFUKAR.mjs').then((mod) => ({ default: mod.DocsLayout }))
+  () => import('./DocsLayout-XB55R7YG.mjs').then((mod) => ({ default: mod.DocsLayout }))
 );
 var LoadingFallback7 = /* @__PURE__ */ __name(() => /* @__PURE__ */ jsx("div", { className: "flex items-center justify-center min-h-[400px]", children: /* @__PURE__ */ jsx("div", { className: "text-muted-foreground", children: "Loading API Playground..." }) }), "LoadingFallback");
 var Playground = /* @__PURE__ */ __name(({ config }) => {
@@ -1195,6 +1196,38 @@ function createMentionSuggestion(config) {
     render: /* @__PURE__ */ __name(() => {
       let component = null;
       let popup = null;
+      let cleanupAutoUpdate = null;
+      let getReferenceRect = null;
+      const buildVirtualElement = /* @__PURE__ */ __name(() => ({
+        getBoundingClientRect: /* @__PURE__ */ __name(() => {
+          const rect = getReferenceRect?.();
+          return rect ?? new DOMRect(0, 0, 0, 0);
+        }, "getBoundingClientRect")
+      }), "buildVirtualElement");
+      const updatePosition = /* @__PURE__ */ __name(() => {
+        if (!popup) return;
+        const virtualEl = buildVirtualElement();
+        void computePosition(virtualEl, popup, {
+          placement: "bottom-start",
+          middleware: [
+            offset(4),
+            flip({ fallbackPlacements: ["top-start"] }),
+            shift({ padding: 8 })
+          ]
+        }).then(({ x, y }) => {
+          if (!popup) return;
+          popup.style.transform = `translate3d(${Math.round(x)}px, ${Math.round(y)}px, 0)`;
+        });
+      }, "updatePosition");
+      const teardown = /* @__PURE__ */ __name(() => {
+        cleanupAutoUpdate?.();
+        cleanupAutoUpdate = null;
+        popup?.remove();
+        popup = null;
+        component?.destroy();
+        component = null;
+        getReferenceRect = null;
+      }, "teardown");
       return {
         onStart: /* @__PURE__ */ __name((props) => {
           component = new ReactRenderer(MentionList, {
@@ -1207,14 +1240,12 @@ function createMentionSuggestion(config) {
             editor: props.editor
           });
           popup = document.createElement("div");
-          popup.style.cssText = "position: absolute; z-index: 99999;";
+          popup.style.cssText = "position: absolute; top: 0; left: 0; z-index: 99999;";
           popup.appendChild(component.element);
-          const rect = props.clientRect?.();
-          if (rect) {
-            popup.style.top = `${rect.bottom + window.scrollY + 4}px`;
-            popup.style.left = `${rect.left + window.scrollX}px`;
-          }
           document.body.appendChild(popup);
+          getReferenceRect = /* @__PURE__ */ __name(() => props.clientRect?.() ?? null, "getReferenceRect");
+          const virtualEl = buildVirtualElement();
+          cleanupAutoUpdate = autoUpdate(virtualEl, popup, updatePosition);
         }, "onStart"),
         onUpdate: /* @__PURE__ */ __name((props) => {
           component?.updateProps({
@@ -1223,29 +1254,41 @@ function createMentionSuggestion(config) {
               props.command({ id: item.id, label: item.label });
             }, "command")
           });
-          const rect = props.clientRect?.();
-          if (rect && popup) {
-            popup.style.top = `${rect.bottom + window.scrollY + 4}px`;
-            popup.style.left = `${rect.left + window.scrollX}px`;
-          }
+          getReferenceRect = /* @__PURE__ */ __name(() => props.clientRect?.() ?? null, "getReferenceRect");
+          updatePosition();
         }, "onUpdate"),
         onKeyDown: /* @__PURE__ */ __name((props) => {
           if (props.event.key === "Escape") {
-            popup?.remove();
-            component?.destroy();
+            teardown();
             return true;
           }
           return component?.ref?.onKeyDown(props.event) ?? false;
         }, "onKeyDown"),
         onExit: /* @__PURE__ */ __name(() => {
-          popup?.remove();
-          component?.destroy();
+          teardown();
         }, "onExit")
       };
     }, "render")
   };
 }
 __name(createMentionSuggestion, "createMentionSuggestion");
+
+// src/tools/MarkdownEditor/mentionPresets.ts
+var escapeMd = /* @__PURE__ */ __name((s) => s.replace(/([\\\[\]()_*~`])/g, "\\$1"), "escapeMd");
+var mentionPresets = {
+  /** "@Label" — default, ideal for chat where LLMs read the text. */
+  plainAt: /* @__PURE__ */ __name((({ label, id }) => `@${label || id}`), "plainAt"),
+  /** "Label" — bare label, no @ prefix. */
+  plainLabel: /* @__PURE__ */ __name((({ label, id }) => label || id), "plainLabel"),
+  /** "[@Label](baseUrl/id)" — clickable markdown link. */
+  markdownLink: /* @__PURE__ */ __name((baseUrl) => ({ label, id }) => `[@${escapeMd(label || id)}](${baseUrl}${encodeURIComponent(id)})`, "markdownLink"),
+  /** "@[Label](scheme://kind/id)" — Notion / Linear-style custom URI. */
+  customUri: /* @__PURE__ */ __name((scheme, kind) => ({ label, id }) => `@[${escapeMd(label || id)}](${scheme}://${kind}/${encodeURIComponent(id)})`, "customUri"),
+  /** "<@id>" — Slack-style id-only reference (label dropped — receivers resolve it). */
+  slackStyle: /* @__PURE__ */ __name((({ id }) => `<@${id}>`), "slackStyle"),
+  /** Inline HTML span — for products that consume markdown with raw HTML allowed. */
+  htmlSpan: /* @__PURE__ */ __name((className = "mention") => ({ label, id }) => `<span class="${className}" data-mention-id="${encodeURIComponent(id)}">@${escapeMd(label || id)}</span>`, "htmlSpan")
+};
 function getMarkdown(editor) {
   const storage = editor.storage.markdown;
   if (!storage?.manager) return editor.getText();
@@ -1289,8 +1332,19 @@ function MarkdownEditor({
       Markdown
     ];
     if (mentions) {
+      const renderMarkdown = mentions.renderMarkdown ?? mentionPresets.plainAt;
       exts.push(
-        Mention.configure({
+        Mention.extend({
+          renderMarkdown(node) {
+            const raw = node.attrs;
+            const attrs = {
+              id: raw?.id ?? "",
+              label: raw?.label ?? ""
+            };
+            if (!attrs.id && !attrs.label) return "";
+            return renderMarkdown(attrs);
+          }
+        }).configure({
           HTMLAttributes: { class: "markdown-mention" },
           suggestion: createMentionSuggestion(mentions),
           renderText: /* @__PURE__ */ __name(({ node }) => `@${node.attrs.label}`, "renderText")
@@ -1359,6 +1413,6 @@ function MarkdownToolbar({ editor }) {
 }
 __name(MarkdownToolbar, "MarkdownToolbar");
 
-export { CardLoadingFallback, CronScheduler, DiffEditor, Editor, EditorProvider, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, LoadingFallback, LottiePlayer, MapLoadingFallback, MarkdownEditor, OpenapiViewer_default as OpenapiViewer, Spinner, createLazyComponent, useEditor, useEditorContext, useLanguage, useMonaco };
+export { CardLoadingFallback, CronScheduler, DiffEditor, Editor, EditorProvider, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, LoadingFallback, LottiePlayer, MapLoadingFallback, MarkdownEditor, OpenapiViewer_default as OpenapiViewer, Spinner, createLazyComponent, mentionPresets, useEditor, useEditorContext, useLanguage, useMonaco };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map