@djangocfg/ui-tools 2.1.289 → 2.1.291

package/dist/index.d.cts

@@ -318,6 +318,11 @@ interface PrettyCodeProps$1 {
     inline?: boolean;
     customBg?: string;
     isCompact?: boolean;
+    scrollIsolation?: boolean;
+    maxLines?: number;
+    /** ``'card'`` (default) ships the full chrome. ``'plain'`` is
+     *  chrome-less — for embedding inside another scroll container. */
+    variant?: 'card' | 'plain';
 }
 
 /**
@@ -1486,6 +1491,19 @@ interface PrettyCodeProps {
      * to inline short snippets and cap long ones.
      */
     maxLines?: number;
+    /**
+     * Visual variant:
+     *   - ``"card"`` (default) — full chrome: border, background, hover
+     *     toolbar (Copy + language tag), optional internal scroll. Suits
+     *     a standalone code block in documentation prose where the block
+     *     is its own surface.
+     *   - ``"plain"`` — chrome-less: no border, no background, no toolbar,
+     *     no internal scroll. Grows to fit its content. Use when
+     *     embedding inside another scroll container (e.g. the Response
+     *     panel) — avoids double-scroll surfaces and lets the parent
+     *     manage copy/language affordances.
+     */
+    variant?: 'card' | 'plain';
 }
 declare const PrettyCode: React__default.FC<PrettyCodeProps>;
 
@@ -2455,7 +2473,23 @@ interface MarkdownEditorProps {
     className?: string;
     disabled?: boolean;
     showToolbar?: boolean;
-    /** @mention autocomplete config */
+    /**
+     * `@`-mention autocomplete config.
+     *
+     * IMPORTANT: Tiptap's `useEditor` initialises the editor exactly once.
+     * The `Mention` extension is only registered when `mentions` is truthy
+     * on the FIRST render — handing in a real config later (e.g. after an
+     * async items fetch) silently does nothing, and typing `@` will not
+     * open the popover.
+     *
+     * If you want mentions even with async-loaded items, pass
+     * `{ items: [] }` from the very first render and update the array
+     * when data arrives. Either keep the `MentionConfig` object identity
+     * stable across renders and mutate `items` in place (the suggestion
+     * plugin captures the config by closure and reads `items` on each
+     * query), or accept that swapping the whole object reference is a
+     * no-op for the live editor.
+     */
     mentions?: MentionConfig;
     /** Called when mentioned IDs change */
     onMentionIdsChange?: (ids: string[]) => void;

package/dist/index.d.ts

@@ -318,6 +318,11 @@ interface PrettyCodeProps$1 {
     inline?: boolean;
     customBg?: string;
     isCompact?: boolean;
+    scrollIsolation?: boolean;
+    maxLines?: number;
+    /** ``'card'`` (default) ships the full chrome. ``'plain'`` is
+     *  chrome-less — for embedding inside another scroll container. */
+    variant?: 'card' | 'plain';
 }
 
 /**
@@ -1486,6 +1491,19 @@ interface PrettyCodeProps {
      * to inline short snippets and cap long ones.
      */
     maxLines?: number;
+    /**
+     * Visual variant:
+     *   - ``"card"`` (default) — full chrome: border, background, hover
+     *     toolbar (Copy + language tag), optional internal scroll. Suits
+     *     a standalone code block in documentation prose where the block
+     *     is its own surface.
+     *   - ``"plain"`` — chrome-less: no border, no background, no toolbar,
+     *     no internal scroll. Grows to fit its content. Use when
+     *     embedding inside another scroll container (e.g. the Response
+     *     panel) — avoids double-scroll surfaces and lets the parent
+     *     manage copy/language affordances.
+     */
+    variant?: 'card' | 'plain';
 }
 declare const PrettyCode: React__default.FC<PrettyCodeProps>;
 
@@ -2455,7 +2473,23 @@ interface MarkdownEditorProps {
     className?: string;
     disabled?: boolean;
     showToolbar?: boolean;
-    /** @mention autocomplete config */
+    /**
+     * `@`-mention autocomplete config.
+     *
+     * IMPORTANT: Tiptap's `useEditor` initialises the editor exactly once.
+     * The `Mention` extension is only registered when `mentions` is truthy
+     * on the FIRST render — handing in a real config later (e.g. after an
+     * async items fetch) silently does nothing, and typing `@` will not
+     * open the popover.
+     *
+     * If you want mentions even with async-loaded items, pass
+     * `{ items: [] }` from the very first render and update the array
+     * when data arrives. Either keep the `MentionConfig` object identity
+     * stable across renders and mutate `items` in place (the suggestion
+     * plugin captures the config by closure and reads `items` on each
+     * query), or accept that swapping the whole object reference is a
+     * no-op for the live editor.
+     */
     mentions?: MentionConfig;
     /** Called when mentioned IDs change */
     onMentionIdsChange?: (ids: string[]) => void;

package/dist/index.mjs

@@ -4,8 +4,8 @@ import './chunk-JWB2EWQO.mjs';
 export { ImageViewer } from './chunk-GGKGH5PM.mjs';
 export { generateContentKey, useAudioCache, useBlobUrlCleanup, useImageCache, useMediaCacheStore, useVideoCache, useVideoPlayerSettings } from './chunk-5LBDYFWH.mjs';
 export { CronSchedulerProvider, CustomInput, DayChips, MonthDayGrid, SchedulePreview, ScheduleTypeSelector, TimeSelector, buildCron, humanizeCron, isValidCron, parseCron, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays } from './chunk-PZKAH7WQ.mjs';
-import { PlaygroundProvider } from './chunk-VZGQC3NG.mjs';
-export { MarkdownMessage, Mermaid_default as Mermaid, PrettyCode_default as PrettyCode, useCollapsibleContent } from './chunk-VZGQC3NG.mjs';
+import { PlaygroundProvider } from './chunk-EFWOJPA6.mjs';
+export { MarkdownMessage, Mermaid_default as Mermaid, PrettyCode_default as PrettyCode, useCollapsibleContent } from './chunk-EFWOJPA6.mjs';
 export { JsonTree_default as JsonTree } from './chunk-LFWQ36LJ.mjs';
 import './chunk-SSUOENAZ.mjs';
 export { ArrayFieldItemTemplate, ArrayFieldTemplate, BaseInputTemplate, CheckboxWidget, ColorWidget, ErrorListTemplate, FieldTemplate, JsonSchemaForm, NumberWidget, ObjectFieldTemplate, SelectWidget, SliderWidget, SwitchWidget, TextWidget, getRequiredFields, hasRequiredFields, mergeDefaults, normalizeFormData, safeJsonParse, safeJsonStringify, validateRequiredFields, validateSchema } from './chunk-JUGQNNDC.mjs';
@@ -223,7 +223,7 @@ function CodeLoadingFallback() {
 }
 __name(CodeLoadingFallback, "CodeLoadingFallback");
 var LazyPrettyCode = createLazyComponent(
-  () => import('./PrettyCode.client-IZTXXYHG.mjs'),
+  () => import('./PrettyCode.client-SPMTQEG4.mjs'),
   {
     displayName: "LazyPrettyCode",
     fallback: /* @__PURE__ */ jsx(CodeLoadingFallback, {})
@@ -237,7 +237,7 @@ function OpenapiLoadingFallback() {
 }
 __name(OpenapiLoadingFallback, "OpenapiLoadingFallback");
 var LazyDocsLayout = createLazyComponent(
-  () => import('./DocsLayout-TKJQ5W5E.mjs').then((mod) => ({ default: mod.DocsLayout })),
+  () => import('./DocsLayout-JPXFUKAR.mjs').then((mod) => ({ default: mod.DocsLayout })),
   {
     displayName: "LazyDocsLayout",
     fallback: /* @__PURE__ */ jsx(OpenapiLoadingFallback, {})
@@ -392,7 +392,7 @@ function LottiePlayer(props) {
 }
 __name(LottiePlayer, "LottiePlayer");
 var DocsLayout = lazy(
-  () => import('./DocsLayout-TKJQ5W5E.mjs').then((mod) => ({ default: mod.DocsLayout }))
+  () => import('./DocsLayout-JPXFUKAR.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 }) => {
@@ -1274,6 +1274,14 @@ function MarkdownEditor({
   onMentionIdsChange
 }) {
   const isExternalUpdate = useRef(false);
+  const initialMentionsDefinedRef = useRef(mentions !== void 0);
+  const warnedRef = useRef(false);
+  if (process.env.NODE_ENV !== "production" && !initialMentionsDefinedRef.current && mentions !== void 0 && !warnedRef.current) {
+    warnedRef.current = true;
+    console.warn(
+      "[MarkdownEditor] `mentions` flipped from undefined to a config after mount. Tiptap only installs the Mention extension on first render \u2014 the @-popover will NOT work for this editor instance. Pass `{ items: [] }` from the very first render and mutate `.items` in place instead."
+    );
+  }
   const extensions = useMemo(() => {
     const exts = [
       StarterKit.configure({ heading: { levels: [1, 2, 3] } }),