@djangocfg/ui-tools 2.1.291 → 2.1.293

package/src/tools/OpenapiViewer/components/DocsLayout/Sidebar/EndpointRow.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import React from 'react';
+import React, { useEffect, useRef } from 'react';
 
 import { Tooltip, TooltipContent, TooltipTrigger } from '@djangocfg/ui-core/components';
 import { cn } from '@djangocfg/ui-core/lib';
@@ -35,10 +35,21 @@ export const EndpointRow = React.memo(function EndpointRow({
     // in ``.`` which looks like punctuation noise when stacked in a list.
     const displayLabel = row.label.replace(/\.$/, '');
 
+    // Keep the active row visible inside the sidebar's scroll container.
+    // ``block: 'nearest'`` is a no-op when the row is already in view,
+    // so this only fires when the user scrolled the docs far enough to
+    // push the highlighted endpoint above/below the sidebar viewport.
+    const buttonRef = useRef<HTMLButtonElement | null>(null);
+    useEffect(() => {
+        if (!row.isActive || !buttonRef.current) return;
+        buttonRef.current.scrollIntoView({ block: 'nearest', inline: 'nearest' });
+    }, [row.isActive]);
+
     return (
         <Tooltip delayDuration={350}>
             <TooltipTrigger asChild>
                 <button
+                    ref={buttonRef}
                     onClick={() => onNavigate(row.anchor, row.schemaId)}
                     aria-current={row.isActive ? 'location' : undefined}
                     className={cn(

package/src/tools/OpenapiViewer/components/DocsLayout/Sidebar/SidebarBody.tsx

@@ -24,7 +24,7 @@ export function SidebarBody({ body, onNavigate }: SidebarBodyProps) {
             );
         }
         return (
-            <nav className="py-1.5">
+            <nav className="pt-1.5 pb-[10vh]">
                 {body.categories.map((cat) => (
                     <CategoryBlock key={cat.key} category={cat} onNavigate={onNavigate} />
                 ))}

package/src/tools/OpenapiViewer/components/DocsLayout/index.tsx

@@ -31,7 +31,11 @@ export const DocsLayout: React.FC = () => {
     const grouping = config.schemaGrouping ?? 'selector';
     const preloadAll = grouping === 'sections';
     const urlSyncEnabled =
-        typeof config.urlSync === 'boolean' ? config.urlSync : Boolean(config.urlSync?.enabled);
+        config.urlSync === undefined
+            ? true
+            : typeof config.urlSync === 'boolean'
+                ? config.urlSync
+                : Boolean(config.urlSync.enabled);
 
     const {
         endpoints,

package/src/tools/OpenapiViewer/types.ts

@@ -114,11 +114,11 @@ export 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 };
 }
 

package/src/tools/index.ts

@@ -223,8 +223,14 @@ export type {
 } from './CodeEditor/types';
 
 // Export MarkdownEditor (Tiptap ~200KB)
-export { MarkdownEditor } from './MarkdownEditor';
-export type { MarkdownEditorProps, MentionItem, MentionConfig } from './MarkdownEditor';
+export { MarkdownEditor, mentionPresets } from './MarkdownEditor';
+export type {
+  MarkdownEditorProps,
+  MentionItem,
+  MentionConfig,
+  MentionAttrs,
+  MentionMarkdownRenderer,
+} from './MarkdownEditor';
 
 // Export Media Cache Store
 export {