@redocly/theme 0.69.0-next.9 → 0.70.0-next.0

package/lib/components/Catalog/variables.js

@@ -473,33 +473,31 @@ exports.catalog = (0, styled_components_1.css) `
     * @tokens Catalog history button
     */
   --catalog-history-button-width: 252px;
-  --catalog-history-button-item-width: 244px;
   --catalog-history-separator-border-color: var(--border-color-secondary);
-  --catalog-history-separator-margin-bottom: var(--spacing-sm);
+  --catalog-history-separator-margin: var(--spacing-sm) 0;
   --catalog-history-item-padding: var(--spacing-xxs);
-  --catalog-history-item-margin-bottom: calc(var(--spacing-xxs) * -1);
-  --catalog-history-item-gap: var(--spacing-xs);
-  --catalog-history-item-border-radius: var(--menu-item-label-border-radius);
+  --catalog-history-item-gap: var(--spacing-xxs);
+  --catalog-history-item-border-radius: var(--border-radius-lg);
   --catalog-history-item-bg-color-hover: var(--menu-item-bg-color-hover);
   --catalog-history-icon-size: 16px;
-  --catalog-history-content-max-width: 212px;
+  --catalog-history-icon-gap: 2px;
   --catalog-history-text-font-family: var(--font-family-base);
   --catalog-history-text-font-size: var(--font-size-base);
   --catalog-history-text-font-weight: var(--font-weight-regular);
   --catalog-history-text-line-height: var(--line-height-base);
-  --catalog-history-text-color: var(--text-color-primary);
+  --catalog-history-text-color: var(--menu-content-color);
   --catalog-history-pill-gap: var(--spacing-xxs);
+  --catalog-history-pill-height: 22px;
   --catalog-history-pill-padding-vertical: 1px;
   --catalog-history-pill-padding-horizontal: var(--spacing-xs);
   --catalog-history-pill-border-color: var(--border-color-primary);
-  --catalog-history-pill-border-radius: 12px;
-  --catalog-history-pill-icon-size: 16px;
+  --catalog-history-pill-border-radius: var(--border-radius-xl);
+  --catalog-history-pill-icon-size: 14px;
   --catalog-history-pill-icon-color: var(--color-green-8);
   --catalog-history-pill-font-family: var(--font-family-base);
   --catalog-history-pill-font-size: var(--font-size-base);
   --catalog-history-pill-line-height: var(--line-height-base);
   --catalog-history-pill-text-color: var(--text-color-primary);
-  --catalog-history-pill-min-width: calc(100% - 118px - var(--catalog-history-item-gap));
   // @tokens End
 
   /**
@@ -508,50 +506,44 @@ exports.catalog = (0, styled_components_1.css) `
   --catalog-history-sidebar-width: 320px;
   --catalog-history-sidebar-bg-color: var(--sidebar-bg-color);
   --catalog-history-sidebar-border-color: var(--border-color-secondary);
+  --catalog-history-sidebar-padding: var(--spacing-base) var(--spacing-base) 0;
+  --catalog-history-sidebar-divider-margin: var(--spacing-sm) 0 0;
 
-  --catalog-history-sidebar-header-padding: var(--spacing-base) var(--spacing-sm) var(--spacing-base);
+  --catalog-history-sidebar-header-padding: var(--spacing-xxs);
   --catalog-history-sidebar-header-font-family: var(--font-family-base);
   --catalog-history-sidebar-header-font-size: var(--font-size-base);
   --catalog-history-sidebar-header-font-weight: var(--font-weight-regular);
   --catalog-history-sidebar-header-line-height: var(--line-height-base);
   --catalog-history-sidebar-header-letter-spacing: 0;
-  --catalog-history-sidebar-header-color: var(--text-color-primary);
+  --catalog-history-sidebar-header-color: var(--menu-content-color);
 
-  --catalog-history-sidebar-close-button-size: 32px;
-  --catalog-history-sidebar-close-button-border-radius: var(--border-radius-md);
+  --catalog-history-sidebar-close-button-size: 22px;
+  --catalog-history-sidebar-close-button-border-radius: var(--border-radius-xl);
   --catalog-history-sidebar-close-button-bg-color-hover: var(--color-hover-base);
   --catalog-history-sidebar-close-icon-color: var(--text-color-primary);
 
-  --catalog-history-sidebar-content-padding: 0 var(--spacing-sm);
-  --catalog-history-sidebar-content-margin-top: calc(var(--spacing-xxs) * -1);
-
-  --catalog-history-sidebar-version-header-padding: var(--spacing-xs) var(--spacing-xxs);
+  --catalog-history-sidebar-version-header-padding: var(--spacing-xxs);
   --catalog-history-sidebar-version-header-border-radius: var(--border-radius-md);
   --catalog-history-sidebar-version-header-bg-color-hover: var(--color-hover-base);
+  --catalog-history-sidebar-version-header-bg-color-current: var(--menu-item-bg-color-active);
 
-  --catalog-history-sidebar-version-icon-size: 32px;
-  --catalog-history-sidebar-version-icon-color: var(--text-color-secondary);
+  --catalog-history-sidebar-version-icon-size: 20px;
+  --catalog-history-sidebar-version-icon-color: var(--text-color-primary);
   --catalog-history-sidebar-version-icon-color-current: var(--color-static-white);
-  --catalog-history-sidebar-version-icon-margin-right: var(--spacing-xs);
+  --catalog-history-sidebar-version-icon-margin-right: var(--spacing-xxs);
   --catalog-history-sidebar-chevron-icon-color: var(--text-color-secondary);
-  --catalog-history-sidebar-version-info-gap: 2px;
 
   --catalog-history-sidebar-version-title-font-family: var(--font-family-base);
   --catalog-history-sidebar-version-title-font-size: var(--font-size-base);
-  --catalog-history-sidebar-version-title-font-weight: var(--font-weight-medium);
+  --catalog-history-sidebar-version-title-font-weight: var(--font-weight-regular);
   --catalog-history-sidebar-version-title-line-height: var(--line-height-base);
-  --catalog-history-sidebar-version-title-color: var(--color-warm-grey-7);
-
-  --catalog-history-sidebar-version-date-font-family: var(--font-family-base);
-  --catalog-history-sidebar-version-date-font-size: var(--font-size-sm);
-  --catalog-history-sidebar-version-date-font-weight: var(--font-weight-regular);
-  --catalog-history-sidebar-version-date-line-height: var(--line-height-sm);
-  --catalog-history-sidebar-version-date-color: var(--color-warm-grey-7);
+  --catalog-history-sidebar-version-title-color: var(--menu-content-color);
 
-  --catalog-history-sidebar-revisions-padding-left: 40px;
+  --catalog-history-sidebar-revisions-padding-left: 28px;
   --catalog-history-sidebar-revisions-padding-bottom: var(--spacing-base);
+  --catalog-history-sidebar-revision-line-left: 14px;
 
-  --catalog-history-sidebar-revision-item-padding: var(--spacing-xs) var(--spacing-sm);
+  --catalog-history-sidebar-revision-item-padding: var(--spacing-xxs) var(--spacing-sm);
   --catalog-history-sidebar-revision-item-border-radius: var(--border-radius-md);
   --catalog-history-sidebar-revision-item-bg-color-hover: var(--bg-color-hover);
 
@@ -575,7 +567,6 @@ exports.catalog = (0, styled_components_1.css) `
   /**
    * @tokens Catalog history tag border radius
    */
-  --catalog-history-sidebar-version-tag-border-radius: var(--border-radius-xl);
   --catalog-history-sidebar-revision-tag-border-radius: var(--border-radius-xl);
   // @tokens End
 

package/lib/components/CatalogClassic/CatalogClassicInfoBlock.d.ts

@@ -1,4 +1,4 @@
-import type { JSX } from 'react';
+import { type JSX } from 'react';
 export type CatalogClassicInfoBlockProps = {
     metadata?: {
         scorecardLevel?: string;

package/lib/components/CatalogClassic/CatalogClassicInfoBlock.js

@@ -10,7 +10,6 @@ const hooks_1 = require("../../core/hooks");
 const utils_1 = require("../../core/utils");
 const Tag_1 = require("../../components/Tag/Tag");
 const Link_1 = require("../../components/Link/Link");
-const utils_2 = require("../../core/utils");
 function CatalogClassicInfoBlock(props) {
     var _a, _b, _c, _d;
     const scorecardBadge = ((_a = props.metadata) === null || _a === void 0 ? void 0 : _a.scorecardLevel) ? (react_1.default.createElement(ScorecardBadge, { level: props.metadata.scorecardLevel, slug: (_b = props.metadata) === null || _b === void 0 ? void 0 : _b.scoreCardSlug, colorVariable: (0, utils_1.getScorecardColorVariable)(((_c = props.metadata) === null || _c === void 0 ? void 0 : _c.scorecardLevelIdx) || 0, Object.keys(((_d = props.metadata) === null || _d === void 0 ? void 0 : _d.scorecardLevels) || {}).length) })) : null;
@@ -22,7 +21,7 @@ function ScorecardBadge(props) {
     const { useTelemetry } = (0, hooks_1.useThemeHooks)();
     const telemetry = useTelemetry();
     return (react_1.default.createElement(Link_1.Link, { to: slug },
-        react_1.default.createElement(Tag_1.Tag, { onClick: () => telemetry.sendScorecardLinkClickedMessage([(0, utils_2.getBaseDataAttributes)('scorecardLink', 'tag')]), withStatusDot: true, statusDotColor: `var(${colorVariable})` }, level)));
+        react_1.default.createElement(Tag_1.Tag, { onClick: () => telemetry.sendScorecardLinkClickedMessage([(0, utils_1.getBaseDataAttributes)('scorecardLink', 'tag')]), withStatusDot: true, statusDotColor: `var(${colorVariable})` }, level)));
 }
 const CatalogInfoBlockWrapper = styled_components_1.default.div `
   position: relative;

package/lib/components/CatalogClassic/CatalogClassicVirtualizedGroups.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { CatalogItem, ResolvedFilter } from '../../core/types';
+import type { CatalogItem, ResolvedFilter } from '../../core/types';
 export type Group = {
     title: string;
     items: CatalogItem[];

package/lib/components/CodeBlock/CodeBlockControls.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { JSX } from 'react';
 import type { CodeBlockItems } from '../../components/CodeBlock/CodeBlock';
-import { ReportButtonProps } from '../../core/hooks';
+import type { ReportButtonProps } from '../../core/hooks';
 export type CodeBlockControlsProps = {
     children?: React.ReactNode;
     className?: string;

package/lib/components/Dropdown/Dropdown.js

@@ -77,12 +77,18 @@ exports.Dropdown = (0, react_1.forwardRef)(({ children, className, active, trigg
         }
     };
     const updateMenuPosition = (0, react_1.useCallback)(() => {
+        var _a;
+        var _b;
         const wrapper = wrapperRef.current;
         if (!wrapper)
             return;
         const rect = wrapper.getBoundingClientRect();
+        const menuHeight = (_b = (_a = menuRef.current) === null || _a === void 0 ? void 0 : _a.offsetHeight) !== null && _b !== void 0 ? _b : 0;
+        const fitsBelow = rect.bottom + menuHeight <= window.innerHeight;
+        const fitsAbove = rect.top - menuHeight >= 0;
+        const openUpward = placement === 'top' ? fitsAbove || !fitsBelow : !fitsBelow && fitsAbove;
         const style = { minWidth: rect.width };
-        if (placement === 'top') {
+        if (openUpward) {
             style.bottom = window.innerHeight - rect.top;
         }
         else {

package/lib/components/Filter/FilterOptionLabel.d.ts

@@ -1,4 +1,4 @@
-import { type PropsWithChildren, JSX } from 'react';
+import { type JSX, type PropsWithChildren } from 'react';
 export type FilterOptionLabelProps = PropsWithChildren<{
     className?: string;
 }>;

package/lib/components/LoadMore/LoadMore.d.ts

@@ -1,4 +1,4 @@
-import { JSX } from 'react';
+import type { JSX } from 'react';
 export declare function LoadMore({ icon, onClick, disabled, blinking, label, }: {
     icon: JSX.Element;
     onClick: () => void;

package/lib/components/MCP/McpConnectionTabs.js

@@ -62,11 +62,10 @@ const TAB_LABELS = {
     },
     json: { translationKey: 'page.mcpNotAllowed.tabs.json', defaultLabel: 'JSON' },
 };
-// The report control is docs feedback, not useful on the connection page.
-const CODE_BLOCK_HEADER = { controls: { copy: {}, report: { hidden: true } } };
 function McpConnectionTabs({ options = DEFAULT_TAB_OPTIONS, className, }) {
-    const { useTranslate } = (0, hooks_1.useThemeHooks)();
+    const { useTranslate, useTelemetry } = (0, hooks_1.useThemeHooks)();
     const { translate } = useTranslate();
+    const telemetry = useTelemetry();
     const { serverName, serverUrl, isMcpDisabled } = (0, hooks_1.useMCPConfig)();
     // The SSR markup of error pages is cached with the build-time origin, so the
     // tabs remount after hydration to pick up the real browser origin.
@@ -76,20 +75,31 @@ function McpConnectionTabs({ options = DEFAULT_TAB_OPTIONS, className, }) {
         return null;
     }
     const connection = { serverName, url: serverUrl };
+    const snippetHeader = (client, snippet) => ({
+        controls: {
+            copy: {
+                onClick: () => telemetry.sendMcpConnectionSnippetCopiedMessage([
+                    Object.assign(Object.assign({}, (0, utils_1.getBaseDataAttributes)('mcpConnectionSnippet', 'button')), { client, snippet }),
+                ]),
+            },
+            // The report control is docs feedback, not useful on the connection page.
+            report: { hidden: true },
+        },
+    });
     return (react_1.default.createElement(McpConnectionTabsWrapper, { key: hydrated ? 'client' : 'ssr', "data-component-name": "MCP/McpConnectionTabs", "data-testid": "mcp-connection-tabs", className: className },
         react_1.default.createElement(Tabs_1.Tabs, { size: Tabs_1.TabsSize.SMALL }, options.map((option) => {
             const { translationKey, defaultLabel, icon: TabIcon } = TAB_LABELS[option];
-            return (react_1.default.createElement(TabItemFragment_1.TabItemFragment, { key: option, label: translate(translationKey, defaultLabel), icon: TabIcon ? react_1.default.createElement(TabIcon, null) : undefined }, renderTabContent(option, connection, translate)));
+            return (react_1.default.createElement(TabItemFragment_1.TabItemFragment, { key: option, label: translate(translationKey, defaultLabel), icon: TabIcon ? react_1.default.createElement(TabIcon, null) : undefined }, renderTabContent(option, connection, translate, snippetHeader)));
         }))));
 }
-function renderTabContent(option, connection, translate) {
+function renderTabContent(option, connection, translate, snippetHeader) {
     const terminalHint = (react_1.default.createElement(TabHint, null, translate('page.mcpNotAllowed.snippets.terminal.hint', 'Run this command in your terminal:')));
-    const urlBlock = react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "text", source: connection.url, header: CODE_BLOCK_HEADER });
+    const urlBlock = (react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "text", source: connection.url, header: snippetHeader(option, 'chatgpt-app') }));
     const assistantPromptClient = {
         headline: translate('page.mcpNotAllowed.snippets.prompt.headline', 'Prompt'),
         content: (react_1.default.createElement(react_1.default.Fragment, null,
             react_1.default.createElement(TabHint, null, translate('page.mcpNotAllowed.snippets.prompt.hint', 'Or paste this prompt into the chat to have it add the server for you:')),
-            react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "text", source: (0, utils_1.generateMcpInstallPrompt)(connection), header: CODE_BLOCK_HEADER, wrapContents: true }))),
+            react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "text", source: (0, utils_1.generateMcpInstallPrompt)(connection), header: snippetHeader(option, 'prompt'), wrapContents: true }))),
     };
     switch (option) {
         case 'claude':
@@ -98,13 +108,13 @@ function renderTabContent(option, connection, translate) {
                     headline: translate('page.mcpNotAllowed.snippets.claudeCode.headline', 'Claude Code'),
                     content: (react_1.default.createElement(react_1.default.Fragment, null,
                         terminalHint,
-                        react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "shell", source: (0, utils_1.generateClaudeCodeCommand)(connection), header: CODE_BLOCK_HEADER, wrapContents: true }))),
+                        react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "shell", source: (0, utils_1.generateClaudeCodeCommand)(connection), header: snippetHeader(option, 'claude-code'), wrapContents: true }))),
                 },
                 {
                     headline: translate('page.mcpNotAllowed.snippets.claudeDesktop.headline', 'Claude Desktop'),
                     content: (react_1.default.createElement(react_1.default.Fragment, null,
-                        react_1.default.createElement(TabHint, null, translate('page.mcpNotAllowed.snippets.claudeDesktop.instruction', 'In Claude Desktop, open Settings → Developer → Edit Config, add this to the configuration file, and restart Claude Desktop:')),
-                        react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "json", source: (0, utils_1.generateClaudeDesktopConfig)(connection), header: CODE_BLOCK_HEADER }))),
+                        react_1.default.createElement(TabHint, null, translate('page.mcpNotAllowed.snippets.claudeDesktop.instruction', 'Open Customize → Connectors → Add custom connector and paste this server URL:')),
+                        react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "text", source: connection.url, header: snippetHeader(option, 'claude-desktop') }))),
                 },
             ]);
         case 'chatgpt':
@@ -113,7 +123,7 @@ function renderTabContent(option, connection, translate) {
                     headline: translate('page.mcpNotAllowed.snippets.codexCli.headline', 'Codex CLI'),
                     content: (react_1.default.createElement(react_1.default.Fragment, null,
                         terminalHint,
-                        react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "shell", source: (0, utils_1.generateCodexCommand)(connection), header: CODE_BLOCK_HEADER, wrapContents: true }))),
+                        react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "shell", source: (0, utils_1.generateCodexCommand)(connection), header: snippetHeader(option, 'codex'), wrapContents: true }))),
                 },
                 {
                     headline: translate('page.mcpNotAllowed.snippets.chatgptApp.headline', 'ChatGPT desktop app'),
@@ -126,7 +136,7 @@ function renderTabContent(option, connection, translate) {
         case 'json':
             return (react_1.default.createElement(react_1.default.Fragment, null,
                 react_1.default.createElement(TabHint, null, translate('page.mcpNotAllowed.snippets.json.hint', 'Add this server entry to your MCP client configuration file:')),
-                react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "json", source: JSON.stringify({ [connection.serverName]: { url: connection.url, description: 'MCP Server' } }, null, 2), header: CODE_BLOCK_HEADER })));
+                react_1.default.createElement(CodeBlock_1.CodeBlock, { lang: "json", source: JSON.stringify({ [connection.serverName]: { url: connection.url, description: 'MCP Server' } }, null, 2), header: snippetHeader(option, 'json') })));
     }
 }
 function renderClientList(clients) {

package/lib/components/Markdown/Markdown.js

@@ -178,10 +178,8 @@ exports.Markdown = styled_components_1.default.main
   }
 
   hr {
-    border-top: 1px solid var(--md-hr-border-color);
-    background-color: var(--md-hr-bg-color);
-    height: var(--md-hr-height);
     margin: var(--md-hr-margin-vertical) 0;
+    border: var(--md-hr-border);
   }
 
   details:not(${constants_1.ACCORDION_SELECTOR}) {

package/lib/components/Markdown/styles/base-table.js

@@ -46,6 +46,14 @@ exports.markdownBaseTableCss = (0, styled_components_1.css) `
       background-color: var(--md-table-header-bg-color);
     }
 
+    /* hide the header row when every cell is empty; one labelled cell keeps it visible */
+    thead:has(th:empty) {
+      display: none;
+    }
+    thead:has(th:not(:empty)) {
+      display: table-header-group;
+    }
+
     tr {
       background-color: var(--md-table-stripe-bg-color);
     }

package/lib/components/Markdown/variables.js

@@ -62,9 +62,8 @@ exports.markdown = (0, styled_components_1.css) `
   * @tokens Markdown Horizontal Rule
   */
 
-  --md-hr-bg-color: transparent; // @presenter Color
   --md-hr-border-color: var(--border-color-secondary); // @presenter Color
-  --md-hr-height: unset;
+  --md-hr-border: 0.5px solid var(--md-hr-border-color); // @presenter Border
   --md-hr-margin-vertical: 20px; // @presenter Spacing
 
   /**

package/lib/components/PageActions/PageActions.d.ts

@@ -1,5 +1,5 @@
 import type { JSX } from 'react';
-import { PageActionType } from '../../core/hooks';
+import type { PageActionType } from '../../core/hooks';
 type PageActionProps = {
     pageSlug?: string;
     mcpUrl?: string;

package/lib/components/Search/SearchAiDialog.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { JSX } from 'react';
 import type { AiSearchConversationItem, SearchAiMessageResource, ToolCall, ContentSegment } from '../../core/types';
-import { AiSearchError } from '../../core/constants';
+import type { AiSearchError } from '../../core/constants';
 export type SearchAiDialogProps = {
     response: string | undefined;
     isGeneratingResponse: boolean;

package/lib/components/Search/SearchAiDialog.js

@@ -80,6 +80,7 @@ function SearchAiDialog({ isGeneratingResponse, response, initialMessage, error,
         if (!(initialMessage === null || initialMessage === void 0 ? void 0 : initialMessage.trim().length)) {
             return;
         }
+        // oxlint-disable-next-line react-you-might-not-need-an-effect/no-pass-data-to-parent -- appends the initial message into the conversation state lifted to the search root once the dialog mounts
         setConversation((prev) => [
             ...prev,
             { role: constants_1.AiSearchConversationRole.USER, content: initialMessage },
@@ -89,6 +90,7 @@ function SearchAiDialog({ isGeneratingResponse, response, initialMessage, error,
         if (response === undefined || conversation.length === 0 || error) {
             return;
         }
+        // oxlint-disable-next-line react-you-might-not-need-an-effect/no-pass-data-to-parent -- merges the streamed assistant response into the lifted conversation state as chunks arrive
         setConversation((prev) => {
             const lastMessage = prev[prev.length - 1];
             const content = response || '';
@@ -127,6 +129,7 @@ function SearchAiDialog({ isGeneratingResponse, response, initialMessage, error,
     ]);
     (0, react_1.useEffect)(() => {
         if (error) {
+            // oxlint-disable-next-line react-you-might-not-need-an-effect/no-pass-data-to-parent -- drops the pending message from the lifted conversation state once the request errors
             setConversation((prev) => prev.slice(0, -1));
         }
     }, [error, setConversation]);

package/lib/components/Search/SearchAiMessage.d.ts

@@ -1,5 +1,4 @@
-import React from 'react';
-import type { JSX } from 'react';
+import React, { type JSX } from 'react';
 import { FeedbackType, type SearchAiMessageResource, type ToolCall, type ContentSegment } from '../../core/types';
 import { AiSearchConversationRole } from '../../core/constants';
 export type SearchAiMessageProps = {

package/lib/components/Search/SearchAiMessage.js

@@ -41,10 +41,8 @@ const react_1 = __importStar(require("react"));
 const styled_components_1 = __importDefault(require("styled-components"));
 const types_1 = require("../../core/types");
 const constants_1 = require("../../core/constants");
-const types_2 = require("../../core/types");
 const Link_1 = require("../../components/Link/Link");
 const Tag_1 = require("../../components/Tag/Tag");
-const constants_2 = require("../../core/constants");
 const hooks_1 = require("../../core/hooks");
 const Markdown_1 = require("../../components/Markdown/Markdown");
 const DocumentIcon_1 = require("../../icons/DocumentIcon/DocumentIcon");
@@ -70,7 +68,7 @@ function getExecuteDescription(args) {
 }
 function getToolCallDisplayText(toolCall) {
     var _a;
-    if (toolCall.name === types_2.ToolCallName.Execute) {
+    if (toolCall.name === types_1.ToolCallName.Execute) {
         const description = getExecuteDescription(toolCall.args);
         if (description) {
             return { inProgressText: description, completedText: description };
@@ -123,8 +121,8 @@ function SearchAiMessageComponent({ role, content, isThinking, resources, classN
         }
     };
     return (react_1.default.createElement(SearchAiMessageWrapper, { "data-component-name": "Search/SearchAiMessage", $role: role, className: className, "data-testid": "search-ai-message" },
-        role === constants_2.AiSearchConversationRole.ASSISTANT && (react_1.default.createElement(AiStarsIcon_1.AiStarsIcon, { size: "32px", background: "var(--search-ai-icon-bg-color)", borderRadius: "var(--border-radius-lg)", color: "var(--search-ai-icon-color)", margin: "0 var(--spacing-xs) 0 0" })),
-        react_1.default.createElement(MessageContentWrapper, null, role === constants_2.AiSearchConversationRole.ASSISTANT ? (react_1.default.createElement(react_1.default.Fragment, null,
+        role === constants_1.AiSearchConversationRole.ASSISTANT && (react_1.default.createElement(AiStarsIcon_1.AiStarsIcon, { size: "32px", background: "var(--search-ai-icon-bg-color)", borderRadius: "var(--border-radius-lg)", color: "var(--search-ai-icon-color)", margin: "0 var(--spacing-xs) 0 0" })),
+        react_1.default.createElement(MessageContentWrapper, null, role === constants_1.AiSearchConversationRole.ASSISTANT ? (react_1.default.createElement(react_1.default.Fragment, null,
             react_1.default.createElement(MessageWrapper, { $role: role },
                 contentSegments.map((segment, index) => {
                     if (segment.type === 'tool') {
@@ -189,7 +187,7 @@ const SearchAiMessageWrapper = styled_components_1.default.div `
   flex-direction: row;
   align-items: flex-start;
   width: 100%;
-  justify-content: ${({ $role }) => $role === constants_2.AiSearchConversationRole.USER ? 'flex-end' : 'flex-start'};
+  justify-content: ${({ $role }) => $role === constants_1.AiSearchConversationRole.USER ? 'flex-end' : 'flex-start'};
 `;
 const MessageContentWrapper = styled_components_1.default.div `
   display: flex;
@@ -215,7 +213,7 @@ const ResponseText = (0, styled_components_1.default)(Markdown_1.Markdown) `
   }
 `;
 const MessageWrapper = styled_components_1.default.div `
-  padding: ${({ $role }) => $role === constants_2.AiSearchConversationRole.USER
+  padding: ${({ $role }) => $role === constants_1.AiSearchConversationRole.USER
     ? 'var(--spacing-sm)'
     : 'var(--spacing-sm) var(--spacing-sm) var(--spacing-xs) var(--spacing-sm)'};
   border-radius: var(--border-radius-xl);
@@ -223,11 +221,11 @@ const MessageWrapper = styled_components_1.default.div `
   max-width: 100%;
   word-wrap: break-word;
   white-space: pre-wrap;
-  background-color: ${({ $role }) => $role === constants_2.AiSearchConversationRole.USER
+  background-color: ${({ $role }) => $role === constants_1.AiSearchConversationRole.USER
     ? 'var(--search-ai-user-bg-color)'
     : 'var(--search-ai-assistant-bg-color)'};
-  border: ${({ $role }) => $role === constants_2.AiSearchConversationRole.USER ? 'none' : 'var(--search-ai-assistant-border)'};
-  color: ${({ $role }) => $role === constants_2.AiSearchConversationRole.USER
+  border: ${({ $role }) => $role === constants_1.AiSearchConversationRole.USER ? 'none' : 'var(--search-ai-assistant-border)'};
+  color: ${({ $role }) => $role === constants_1.AiSearchConversationRole.USER
     ? 'var(--search-ai-user-text-color)'
     : 'var(--search-ai-assistant-text-color)'};
 `;

package/lib/components/Search/SearchAiResponse.d.ts

@@ -1,5 +1,5 @@
 import type { JSX } from 'react';
-import { AiSearchError } from '../../core/constants';
+import type { AiSearchError } from '../../core/constants';
 export type SearchAiResponseProps = {
     question: string;
     isGeneratingResponse: boolean;

package/lib/components/Search/SearchGroups.d.ts

@@ -1,5 +1,5 @@
 import type { JSX } from 'react';
-import { type SearchFacet, type SearchFilterItem } from '../../core/types';
+import type { SearchFacet, SearchFilterItem } from '../../core/types';
 type SearchGroupsProps = {
     facets: SearchFacet[];
     searchFilter: SearchFilterItem[];

package/lib/core/constants/markdown.d.ts

@@ -1 +1,3 @@
 export declare const MARKDOWN_CLASS_NAME = "md";
+export declare const MARKDOC_EXAMPLE_TAG = "markdoc-example";
+export declare const EXAMPLE_CONTENT_ATTRIBUTE = "exampleContent";

package/lib/core/constants/markdown.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MARKDOWN_CLASS_NAME = void 0;
+exports.EXAMPLE_CONTENT_ATTRIBUTE = exports.MARKDOC_EXAMPLE_TAG = exports.MARKDOWN_CLASS_NAME = void 0;
 exports.MARKDOWN_CLASS_NAME = 'md';
+exports.MARKDOC_EXAMPLE_TAG = 'markdoc-example';
+exports.EXAMPLE_CONTENT_ATTRIBUTE = 'exampleContent';
 //# sourceMappingURL=markdown.js.map

package/lib/core/contexts/AccordionGroupContext.d.ts

@@ -0,0 +1 @@
+export declare const AccordionGroupContext: import("react").Context<string | null>;

package/lib/core/contexts/AccordionGroupContext.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccordionGroupContext = void 0;
+const react_1 = require("react");
+exports.AccordionGroupContext = (0, react_1.createContext)(null);
+//# sourceMappingURL=AccordionGroupContext.js.map

package/lib/core/contexts/PageActionsContext.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Whether the first heading inside the enclosing `Markdown` mounts the page actions.
+ * Without a provider `Heading` falls back to the page type in the page metadata.
+ */
+export declare const PageActionsContext: import("react").Context<boolean | null>;

package/lib/core/contexts/PageActionsContext.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageActionsContext = void 0;
+const react_1 = require("react");
+/**
+ * Whether the first heading inside the enclosing `Markdown` mounts the page actions.
+ * Without a provider `Heading` falls back to the page type in the page metadata.
+ */
+exports.PageActionsContext = (0, react_1.createContext)(null);
+//# sourceMappingURL=PageActionsContext.js.map

package/lib/core/contexts/index.d.ts

@@ -1,7 +1,9 @@
 export * from './ThemeDataContext';
 export * from './MarkdownLinkContext';
+export * from './PageActionsContext';
 export * from './CodeWalkthrough/CodeWalkthroughControlsContext';
 export * from './CodeWalkthrough/CodeWalkthroughStepsContext';
+export * from './AccordionGroupContext';
 export * from './CodeSnippetContext';
 export * from './SearchContext';
 export * from './Toast/ToastContext';

package/lib/core/contexts/index.js

@@ -16,8 +16,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ThemeDataContext"), exports);
 __exportStar(require("./MarkdownLinkContext"), exports);
+__exportStar(require("./PageActionsContext"), exports);
 __exportStar(require("./CodeWalkthrough/CodeWalkthroughControlsContext"), exports);
 __exportStar(require("./CodeWalkthrough/CodeWalkthroughStepsContext"), exports);
+__exportStar(require("./AccordionGroupContext"), exports);
 __exportStar(require("./CodeSnippetContext"), exports);
 __exportStar(require("./SearchContext"), exports);
 __exportStar(require("./Toast/ToastContext"), exports);

package/lib/core/hooks/catalog/use-catalog-entity-schema.d.ts

@@ -1,4 +1,4 @@
-import { BffCatalogEntity, BffCatalogRelatedEntity } from '../../types';
+import type { BffCatalogEntity, BffCatalogRelatedEntity } from '../../types';
 type CatalogEntitySchemaProps = {
     entity: BffCatalogEntity;
     relatedEntity: BffCatalogRelatedEntity | null;

package/lib/core/hooks/catalog/use-catalog-table-header-cell-actions.d.ts

@@ -1,4 +1,4 @@
-import { BaseEntity, CatalogColumn } from '../../../components/Catalog/CatalogTableView/CatalogTableView';
+import type { BaseEntity, CatalogColumn } from '../../../components/Catalog/CatalogTableView/CatalogTableView';
 type CatalogTableHeaderCellActionsProps<T extends BaseEntity> = {
     column: CatalogColumn<T>;
     currentSortOption?: string | null;

package/lib/core/hooks/catalog/use-graph.d.ts

@@ -1,6 +1,6 @@
-import { type Node, type Edge, type Connection, OnNodesChange, OnEdgesChange } from '@xyflow/react';
-import { type CatalogEntityNodeData } from '../../../components/Catalog/CatalogEntity/CatalogEntityGraph/CatalogEntityRelationsNode';
-import { BffCatalogEntity, BffCatalogRelatedEntity } from '../../types';
+import { type OnNodesChange, type OnEdgesChange, type Node, type Edge, type Connection } from '@xyflow/react';
+import type { CatalogEntityNodeData } from '../../../components/Catalog/CatalogEntity/CatalogEntityGraph/CatalogEntityRelationsNode';
+import type { BffCatalogEntity, BffCatalogRelatedEntity } from '../../types';
 export type UseGraphProps = {
     entity: BffCatalogEntity;
     relations: BffCatalogRelatedEntity[];

package/lib/core/hooks/code-walkthrough/use-code-walkthrough-steps.js

@@ -58,6 +58,7 @@ function useCodeWalkthroughSteps({ steps, enableDeepLink, root, }) {
                 startOffset: markersMinTopOffset < endOffset ? startOffset : 0,
             });
         }
+        // oxlint-disable-next-line react-you-might-not-need-an-effect/no-chain-state-updates -- marker geometry is derived from post-layout measurements (offsetTop, clientHeight, window.innerHeight)
         setMarkers(markers.reduce((acc, marker, index) => {
             var _a;
             const step = visibleSteps[index];

package/lib/core/hooks/use-active-heading.js

@@ -205,19 +205,23 @@ function useActiveHeading(contentElement, displayedHeadings) {
             return;
         }
         const headers = findHeaders(contentElement);
+        // oxlint-disable-next-line react-you-might-not-need-an-effect/no-chain-state-updates -- headings and the initial active heading come from DOM queries and scroll measurement, available only after layout
         setHeadingElements(headers);
         if (headers.length > 0 && !heading) {
             if (isTopOfPage()) {
+                // oxlint-disable-next-line react-you-might-not-need-an-effect/no-chain-state-updates -- see above
                 setHeading(headers[0].id);
             }
             else {
                 const totalHeight = scrollY + window.innerHeight;
                 if (totalHeight >= document.body.scrollHeight - 10) {
+                    // oxlint-disable-next-line react-you-might-not-need-an-effect/no-chain-state-updates -- see above
                     setHeading(((_a = headers[headers.length - 1]) === null || _a === void 0 ? void 0 : _a.id) || undefined);
                 }
                 else {
                     const triggerOffset = getTriggerOffset();
                     const activeHeader = findActiveHeaderByVirtualPosition(headers, scrollY, triggerOffset);
+                    // oxlint-disable-next-line react-you-might-not-need-an-effect/no-chain-state-updates -- see above
                     setHeading(activeHeader.id);
                 }
             }

package/lib/core/hooks/use-active-section-id.js

@@ -32,6 +32,8 @@ function useActiveSectionId(location, hasOverviewPage = false, withNavbar = true
             const section = sections[i];
             const rect = section.getBoundingClientRect();
             if (rect.y < heightOffset && rect.bottom > heightOffset) {
+                if (isSkippedContent(section))
+                    continue;
                 setItemId(section.getAttribute('data-section-id') || '');
                 return;
             }
@@ -56,4 +58,8 @@ function useActiveSectionId(location, hasOverviewPage = false, withNavbar = true
     }, [location, heightOffset, scrollListener]);
     return itemId;
 }
+function isSkippedContent(element) {
+    return (typeof element.checkVisibility === 'function' &&
+        !element.checkVisibility({ contentVisibilityAuto: true }));
+}
 //# sourceMappingURL=use-active-section-id.js.map