@redocly/openapi-docs 3.24.0-next.9 → 3.24.1

package/lib/components/Security/__tests__/SecurityModal.test.js

@@ -0,0 +1,172 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render, fireEvent, act } from '@testing-library/react';
+import { SecurityModal } from '../SecurityModal.js';
+describe('SecurityModal Component', () => {
+    const securities = [
+        {
+            schemes: [
+                {
+                    id: 'B',
+                    description: 'Test description scheme B',
+                    type: 'http',
+                    bearerFormat: 'password',
+                    scopes: [],
+                },
+                {
+                    id: 'C',
+                    description: 'Test description scheme C',
+                    type: 'http',
+                    bearerFormat: 'password',
+                    scopes: [],
+                },
+            ],
+        },
+        {
+            schemes: [
+                {
+                    id: 'A',
+                    description: 'Test description scheme A',
+                    type: 'apiKey',
+                    in: 'header',
+                    name: 'api_key',
+                    scopes: [],
+                },
+            ],
+        },
+        {
+            schemes: [
+                {
+                    id: 'D',
+                    description: 'Test description scheme D',
+                    type: 'oauth2',
+                    flows: {
+                        authorizationCode: {
+                            authorizationUrl: 'https://example.com/authorization',
+                            tokenUrl: 'https://example.com/token',
+                            scopes: {
+                                'read:pets': 'read your pets',
+                                'write:pets': 'modify pets in your account',
+                            },
+                        },
+                    },
+                    scopes: ['read:pets'],
+                },
+            ],
+        },
+    ];
+    it('renders the SecurityModal with the correct number of SegmentedItems', () => {
+        const { getByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        expect(getByText('A')).toBeInTheDocument();
+        expect(getByText('B and C')).toBeInTheDocument();
+    });
+    it('renders the SecurityModal with the correct number of SecurityFlows and Dividers', () => {
+        const { getByText, getAllByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        expect(getByText('Test description scheme B')).toBeInTheDocument();
+        expect(getByText('Test description scheme C')).toBeInTheDocument();
+        expect(getByText('and')).toBeInTheDocument();
+        expect(getAllByText('HTTP Authorization Scheme').length).toEqual(2);
+        expect(getAllByText('http').length).toEqual(2);
+    });
+    it('should update active security scheme on click and display relevant information', async () => {
+        const { getByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        fireEvent.click(getByText('A'));
+        await act(async () => { });
+        expect(getByText('Test description scheme A')).toBeInTheDocument();
+        expect(getByText('Header parameter name:')).toBeInTheDocument();
+        expect(getByText('api_key')).toBeInTheDocument();
+    });
+    it('should display details for OAuth2 scheme D including initial optional scopes toggle', async () => {
+        const { getByText, getAllByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        fireEvent.click(getByText('D'));
+        await act(async () => { });
+        expect(getByText('Test description scheme D')).toBeInTheDocument();
+        expect(getByText('Required scopes')).toBeInTheDocument();
+        expect(getByText('Show optional scopes')).toBeInTheDocument();
+        const readPetsScopes = getAllByText('read:pets');
+        expect(readPetsScopes.length).toBe(1);
+        const writePetsScopes = getAllByText('write:pets');
+        expect(writePetsScopes.length).toBe(1);
+    });
+    it('should toggle optional scopes visibility for OAuth2 scheme D', async () => {
+        const { getByText, queryByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        fireEvent.click(getByText('D'));
+        await act(async () => { });
+        fireEvent.click(getByText('Show optional scopes'));
+        await act(async () => { });
+        expect(getByText('Hide optional scopes')).toBeInTheDocument();
+        expect(queryByText('Show optional scopes')).toBeNull();
+    });
+    it('calls onClose callback when the Close button is clicked', () => {
+        const onCloseMock = vi.fn();
+        const { getByTestId } = render(_jsx(SecurityModal, { securities: securities, onClose: onCloseMock }));
+        fireEvent.click(getByTestId('close'));
+        expect(onCloseMock).toHaveBeenCalled();
+    });
+    it('should display required scopes from scopes array if there are no flows', () => {
+        const securities = [
+            {
+                schemes: [
+                    {
+                        id: 'D',
+                        description: 'Test description scheme D',
+                        type: 'oauth2',
+                        flows: {},
+                        scopes: ['read:pets'],
+                    },
+                ],
+            },
+        ];
+        const { getByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        expect(getByText('read:pets')).toBeInTheDocument();
+    });
+    it('should exlcude required scopes from optional scopes', async () => {
+        const { getByText, getAllByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        fireEvent.click(getByText('D'));
+        await act(async () => { });
+        fireEvent.click(getByText('Show optional scopes'));
+        await act(async () => { });
+        expect(getAllByText('read:pets').length).toBe(1);
+        expect(getAllByText('write:pets').length).toBe(1);
+    });
+    it('should render required scopes once per scheme and optional scopes per flow when there are multiple flows', async () => {
+        const securities = [
+            {
+                schemes: [
+                    {
+                        id: 'D',
+                        description: 'Test description scheme D',
+                        type: 'oauth2',
+                        flows: {
+                            authorizationCode: {
+                                authorizationUrl: 'https://example.com/authorization',
+                                tokenUrl: 'https://example.com/token',
+                                scopes: {
+                                    'read:pets': 'read your pets',
+                                    'write:pets': 'modify pets in your account',
+                                },
+                            },
+                            clientCredentials: {
+                                tokenUrl: 'https://example.com/token',
+                                scopes: {
+                                    'read:pets': 'read your pets',
+                                    'write:pets': 'modify pets in your account',
+                                },
+                            },
+                        },
+                        scopes: ['read:pets'],
+                    },
+                ],
+            },
+        ];
+        const { getByText, getAllByText } = render(_jsx(SecurityModal, { securities: securities, onClose: () => { } }));
+        // Required is per scheme
+        expect(getAllByText('Required scopes').length).toBe(1);
+        expect(getAllByText('read:pets').length).toBe(1);
+        // Each flow gets its own optional scopes block
+        expect(getByText('authorizationCode')).toBeInTheDocument();
+        expect(getByText('clientCredentials')).toBeInTheDocument();
+        expect(getAllByText('Show optional scopes').length).toBe(2);
+        expect(getAllByText('write:pets').length).toBe(2);
+    });
+});
+//# sourceMappingURL=SecurityModal.test.js.map

package/lib/components/ServerList/__tests__/ServerList.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/ServerList/__tests__/ServerList.test.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render, screen } from '@testing-library/react';
+import * as Jotai from 'jotai';
+import { vi } from 'vitest';
+import { ServerList } from '../ServerList.js';
+import { normalizeOptions } from '../../../services/index.js';
+vi.mock('jotai', async () => ({
+    ...(await vi.importActual('jotai')),
+    useAtomValue: vi.fn(),
+}));
+describe('ServerList component', () => {
+    vi.spyOn(Jotai, 'useAtomValue').mockReturnValue(normalizeOptions({}));
+    const servers = [
+        {
+            url: 'http://petstore.swagger.io/v2',
+            description: 'Default server',
+            name: 'Default',
+        },
+        {
+            url: 'http://petstore.swagger.io/sandbox',
+            description: 'Sandbox server',
+        },
+        {
+            url: 'http://petstore.swagger.io/stage',
+            name: 'Stage server',
+        },
+    ];
+    const translateMock = vi.fn().mockImplementation((_, defaultValue) => defaultValue);
+    it('should render copy button', () => {
+        render(_jsx(ServerList, { servers: servers, path: "/pet", translate: translateMock }));
+        expect(screen.getAllByTestId('copy-button').length).toBe(3);
+    });
+    it('should render server description tooltip', () => {
+        render(_jsx(ServerList, { servers: servers, path: "/pet", translate: translateMock }));
+        expect(screen.getAllByTestId('server-item-description-tooltip').length).toBe(1);
+    });
+    it('should render server name', () => {
+        render(_jsx(ServerList, { servers: servers, path: "/pet", translate: translateMock }));
+        expect(screen.getAllByTestId('server-panel-item-name')[0]).toHaveTextContent('Default');
+        expect(screen.getAllByTestId('server-panel-item-name')[1]).toHaveTextContent('Sandbox server');
+        expect(screen.getAllByTestId('server-panel-item-name')[2]).toHaveTextContent('Stage server');
+    });
+    describe('Server variables', () => {
+        const serversWithVariables = [
+            {
+                url: 'http://petstore.swagger.io/{version}',
+                description: 'Default server with variables',
+                name: 'Default',
+                variables: {
+                    version: {
+                        default: 'v2',
+                        description: 'API version',
+                        enum: ['v1', 'v2'],
+                    },
+                },
+            },
+            {
+                url: 'http://petstore.swagger.io/{sandbox}/{version}',
+                description: 'Sandbox server with variables',
+                variables: {
+                    sandbox: {
+                        default: 'dev',
+                        description: 'Sandbox name',
+                    },
+                    version: {
+                        default: 'v2',
+                        description: 'API version',
+                        enum: ['v1', 'v2'],
+                    },
+                },
+            },
+        ];
+        it('should render view nested with one variable', () => {
+            render(_jsx(ServerList, { servers: [serversWithVariables[0]], path: "/pet", translate: translateMock }));
+            expect(screen.getByText('Show 1 variable')).toBeInTheDocument();
+        });
+        it('should render view nested with multiple variables', () => {
+            render(_jsx(ServerList, { servers: [serversWithVariables[1]], path: "/pet", translate: translateMock }));
+            expect(screen.getByText('Show 2 variables')).toBeInTheDocument();
+        });
+    });
+});
+//# sourceMappingURL=ServerList.test.js.map

package/lib/components/SideMenu/hooks/useMenuItems.js

@@ -1 +1 @@
-import{useMemo as b}from"react";import{useLocation as h}from"react-router-dom";import{useActiveSectionId as I}from"@redocly/theme/core/openapi";import{pathMatchedLink as k}from"../../../utils/index.js";import{DEFAULT_WEBHOOKS_TAG_NAME as A}from"../../../constants.js";import{joinWithSeparator as y}from"../../../services/history/helpers.js";function L({items:s,routingBasePath:r}){const t=h(),o=I(t,!1,!1);return b(()=>S(s,o,t,r),[o,s,t,r])}function S(s,r="",t,o){const n=[];return c({contentItems:s,sidebarItems:n,activeItemId:r,location:t,routingBasePath:o}),n}function d(s,r="",t,o){return s.href?r&&o?y(o,s.id)===r:r&&!o?s.id===r:k(t,s.href):!1}function l(s,r="",t,o){return(s.items||[]).some(i=>d(i,r,t,o)||l(i,r,t,o))}function c(s){const{contentItems:r,sidebarItems:t,activeItemId:o,location:n,routingBasePath:i}=s;let p=!0;for(const e of r){const a=d(e,o,n,i),m=l(e,o,n,i);switch(e.type){case"group":t.push({type:"separator",label:e.name,active:a,hasActiveSubItem:m}),c({...s,contentItems:e.items,sidebarItems:t});break;case"tag":const f={type:"group",label:e.name,items:[],link:e.href,active:a,hasActiveSubItem:m,modified:!0};t.push(f),c({contentItems:e.items,sidebarItems:f.items||[],activeItemId:o,location:n,routingBasePath:i});break;case"operation":case"schema":case"tool":case"rsrc":case"prompt":e.isWebhook&&p&&e.parent.name!==A&&(t.push({type:"separator",label:"Webhooks",variant:"secondary"}),p=!1),t.push({type:"link",label:e.name,httpVerb:e.type=="operation"?e.httpVerb:e.type,link:e.href,badges:e.badges,active:a,hasActiveSubItem:m,modified:!0,deprecated:e.deprecated,isAdditionalOperation:e.isAdditionalOperation});break;case"section":if(e.depth===-1)continue;const u={type:e.items.length?"group":"link",label:e.name,link:e.href,items:[],active:a,hasActiveSubItem:m,modified:!0};t.push(u),e.items.length&&c({contentItems:e.items,sidebarItems:u.items,activeItemId:o,location:n,routingBasePath:i});break}}}export{L as useMenuItems};
+import{useMemo as b}from"react";import{useLocation as h}from"react-router";import{useActiveSectionId as I}from"@redocly/theme/core/openapi";import{pathMatchedLink as k}from"../../../utils/index.js";import{DEFAULT_WEBHOOKS_TAG_NAME as A}from"../../../constants.js";import{joinWithSeparator as y}from"../../../services/history/helpers.js";function L({items:s,routingBasePath:r}){const t=h(),o=I(t,!1,!1);return b(()=>S(s,o,t,r),[o,s,t,r])}function S(s,r="",t,o){const n=[];return c({contentItems:s,sidebarItems:n,activeItemId:r,location:t,routingBasePath:o}),n}function d(s,r="",t,o){return s.href?r&&o?y(o,s.id)===r:r&&!o?s.id===r:k(t,s.href):!1}function l(s,r="",t,o){return(s.items||[]).some(i=>d(i,r,t,o)||l(i,r,t,o))}function c(s){const{contentItems:r,sidebarItems:t,activeItemId:o,location:n,routingBasePath:i}=s;let p=!0;for(const e of r){const a=d(e,o,n,i),m=l(e,o,n,i);switch(e.type){case"group":t.push({type:"separator",label:e.name,active:a,hasActiveSubItem:m}),c({...s,contentItems:e.items,sidebarItems:t});break;case"tag":const f={type:"group",label:e.name,items:[],link:e.href,active:a,hasActiveSubItem:m,modified:!0};t.push(f),c({contentItems:e.items,sidebarItems:f.items||[],activeItemId:o,location:n,routingBasePath:i});break;case"operation":case"schema":case"tool":case"rsrc":case"prompt":e.isWebhook&&p&&e.parent.name!==A&&(t.push({type:"separator",label:"Webhooks",variant:"secondary"}),p=!1),t.push({type:"link",label:e.name,httpVerb:e.type=="operation"?e.httpVerb:e.type,link:e.href,badges:e.badges,active:a,hasActiveSubItem:m,modified:!0,deprecated:e.deprecated,isAdditionalOperation:e.isAdditionalOperation});break;case"section":if(e.depth===-1)continue;const u={type:e.items.length?"group":"link",label:e.name,link:e.href,items:[],active:a,hasActiveSubItem:m,modified:!0};t.push(u),e.items.length&&c({contentItems:e.items,sidebarItems:u.items,activeItemId:o,location:n,routingBasePath:i});break}}}export{L as useMenuItems};

package/lib/components/StickySidebar/StickyResponsiveSidebar.js

@@ -1,4 +1,4 @@
-import{Fragment as l,jsx as n,jsxs as f}from"react/jsx-runtime";import{memo as b,useEffect as h,useRef as u,useState as x}from"react";import{useAtom as y}from"jotai";import{useLocation as S}from"react-router-dom";import{useMount as v,breakpoints as k}from"@redocly/theme/core/openapi";import{isSidebarOpenedAtom as $}from"../../jotai/app.js";import{SidebarActions as g}from"./SidebarActions.js";import{styled as w}from"../../styled-components.js";const j=w.div`
+import{Fragment as l,jsx as n,jsxs as f}from"react/jsx-runtime";import{memo as b,useEffect as h,useRef as u,useState as x}from"react";import{useAtom as y}from"jotai";import{useLocation as S}from"react-router";import{useMount as v,breakpoints as k}from"@redocly/theme/core/openapi";import{isSidebarOpenedAtom as $}from"../../jotai/app.js";import{SidebarActions as g}from"./SidebarActions.js";import{styled as w}from"../../styled-components.js";const j=w.div`
   overflow: hidden;
   flex-direction: column;
   backface-visibility: hidden;

package/lib/components/Tabs/__tests__/Tabs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/Tabs/__tests__/Tabs.test.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { render, fireEvent } from '@testing-library/react';
+import { Tabs } from '../Tabs.js';
+import { useTabsState } from '../useTabsState.js';
+describe('Tabs', () => {
+    const TestComponent = () => {
+        const tabs = [
+            { key: 'tab1', title: 'Tab 1' },
+            { key: 'tab2', title: 'Tab 2' },
+        ];
+        const { activeTab, handleTabChange } = useTabsState({ tabs });
+        return (_jsxs("div", { children: [_jsx(Tabs, { tabs: tabs, activeTab: tabs[0], onChange: handleTabChange }), _jsx("div", { children: activeTab === tabs[0].key ? 'Content 1' : 'Content 2' })] }));
+    };
+    test('should render tab list and content components', () => {
+        const { getByText } = render(_jsx(TestComponent, {}));
+        expect(getByText('Tab 1')).toBeInTheDocument();
+        expect(getByText('Tab 2')).toBeInTheDocument();
+        expect(getByText(/Content 1/)).toBeInTheDocument();
+    });
+    test('should switch active tab when clicking on a Tab', () => {
+        const { getByText } = render(_jsx(TestComponent, {}));
+        const tab2 = getByText('Tab 2');
+        fireEvent.click(tab2);
+        expect(getByText(/Content 2/)).toBeInTheDocument();
+    });
+});
+//# sourceMappingURL=Tabs.test.js.map

package/lib/components/TagItem/OperationsNavigation.js

@@ -1,4 +1,4 @@
-import{jsx as s,jsxs as y}from"react/jsx-runtime";import{useMemo as E,memo as W,useState as _,useCallback as D}from"react";import{useNavigate as V}from"react-router-dom";import{LayoutVariant as z}from"@redocly/config";import{useAtomValue as K}from"jotai/index";import{SamplesPanel as L}from"../common/index.js";import{layoutAtom as X}from"../../jotai/app.js";import{OperationNavigationItems as i}from"./OperationNavigationItems.js";import{StyledButton as q}from"./styled.js";import{useTranslate as F}from"../../hooks/index.js";import{styled as x}from"../../styled-components.js";import{isRenderableMenuItem as G}from"../../utils/menu.js";const b=8;function H({items:c,routingBasePath:n}){const o=F(),[p,w]=_(!1),C=V(),O=K(X)===z.STACKED,{operations:m,webhooks:h,schemas:u,mcpTools:d,showMoreCount:v,totalCount:P,mcpResources:g,mcpPrompts:f,tags:l}=E(()=>{const a=c.filter(e=>G(e)),T=p?a:a.slice(0,b),{operations:M,additionalOperations:R,webhooks:A,schemas:B,mcpTools:I,mcpResources:N,mcpPrompts:j}=T.reduce((e,t)=>{if(t.type==="operation"&&t.isWebhook)e.webhooks.push(t);else if(t.type==="operation"){const k=t;k.isAdditionalOperation?e.additionalOperations.push(k):e.operations.push(k)}else t.type==="schema"?e.schemas.push(t):t.type==="tool"?e.mcpTools.push(t):t.type==="rsrc"?e.mcpResources.push(t):t.type==="prompt"&&e.mcpPrompts.push(t);return e},{operations:[],additionalOperations:[],webhooks:[],schemas:[],mcpTools:[],mcpResources:[],mcpPrompts:[]});return{operations:[...M,...R],schemas:B,mcpTools:I,webhooks:A,mcpResources:N,mcpPrompts:j,showMoreCount:!p&&a.length>b?a.length-b:0,totalCount:a.length,tags:c.filter(e=>e.type==="tag")}},[p,c]),r=D(a=>C(a),[C]),S=u.length>0||d.length>0||g.length>0||f.length>0||m.length>0||h.length>0;return!P&&l.length===0?null:y(J,{isStacked:O,"data-testid":"operation-navigation-list",children:[u.length>0&&s(i,{items:u,onClick:r,routingBasePath:n,translate:o,title:o("openapi.schemas","Schemas")}),d.length>0&&s(i,{items:d,onClick:r,routingBasePath:n,translate:o,title:o("openapi.mcp.tools","MCP Tools")}),g.length>0&&s(i,{items:g,onClick:r,routingBasePath:n,translate:o,title:o("openapi.mcp.resources","MCP Resources")}),f.length>0&&s(i,{items:f,onClick:r,routingBasePath:n,translate:o,title:o("openapi.mcp.prompts","MCP Prompts")}),m.length>0&&s(i,{items:m,onClick:r,routingBasePath:n,translate:o,title:o("openapi.operations","Operations")}),h.length>0&&s(i,{items:h,onClick:r,routingBasePath:n,translate:o,title:o("openapi.webhooks","Webhooks")}),!p&&!!v&&y(U,{variant:"link",size:"large","data-testid":"show-more-operations",fullWidth:!0,onClick:()=>w(!0),children:[o("openapi.actions.show","Show")," ",v," ",o("openapi.actions.more","more"),"..."]}),l.length>0&&S&&s(Q,{}),l.length>0&&s(i,{items:l,onClick:r,routingBasePath:n,translate:o,disableTooltip:!0})]})}const co=W(H),J=x(L)`
+import{jsx as s,jsxs as y}from"react/jsx-runtime";import{useMemo as E,memo as W,useState as _,useCallback as D}from"react";import{useNavigate as V}from"react-router";import{LayoutVariant as z}from"@redocly/config";import{useAtomValue as K}from"jotai/index";import{SamplesPanel as L}from"../common/index.js";import{layoutAtom as X}from"../../jotai/app.js";import{OperationNavigationItems as i}from"./OperationNavigationItems.js";import{StyledButton as q}from"./styled.js";import{useTranslate as F}from"../../hooks/index.js";import{styled as x}from"../../styled-components.js";import{isRenderableMenuItem as G}from"../../utils/menu.js";const b=8;function H({items:c,routingBasePath:n}){const o=F(),[p,w]=_(!1),C=V(),O=K(X)===z.STACKED,{operations:m,webhooks:h,schemas:u,mcpTools:d,showMoreCount:v,totalCount:P,mcpResources:g,mcpPrompts:f,tags:l}=E(()=>{const a=c.filter(e=>G(e)),T=p?a:a.slice(0,b),{operations:M,additionalOperations:R,webhooks:A,schemas:B,mcpTools:I,mcpResources:N,mcpPrompts:j}=T.reduce((e,t)=>{if(t.type==="operation"&&t.isWebhook)e.webhooks.push(t);else if(t.type==="operation"){const k=t;k.isAdditionalOperation?e.additionalOperations.push(k):e.operations.push(k)}else t.type==="schema"?e.schemas.push(t):t.type==="tool"?e.mcpTools.push(t):t.type==="rsrc"?e.mcpResources.push(t):t.type==="prompt"&&e.mcpPrompts.push(t);return e},{operations:[],additionalOperations:[],webhooks:[],schemas:[],mcpTools:[],mcpResources:[],mcpPrompts:[]});return{operations:[...M,...R],schemas:B,mcpTools:I,webhooks:A,mcpResources:N,mcpPrompts:j,showMoreCount:!p&&a.length>b?a.length-b:0,totalCount:a.length,tags:c.filter(e=>e.type==="tag")}},[p,c]),r=D(a=>C(a),[C]),S=u.length>0||d.length>0||g.length>0||f.length>0||m.length>0||h.length>0;return!P&&l.length===0?null:y(J,{isStacked:O,"data-testid":"operation-navigation-list",children:[u.length>0&&s(i,{items:u,onClick:r,routingBasePath:n,translate:o,title:o("openapi.schemas","Schemas")}),d.length>0&&s(i,{items:d,onClick:r,routingBasePath:n,translate:o,title:o("openapi.mcp.tools","MCP Tools")}),g.length>0&&s(i,{items:g,onClick:r,routingBasePath:n,translate:o,title:o("openapi.mcp.resources","MCP Resources")}),f.length>0&&s(i,{items:f,onClick:r,routingBasePath:n,translate:o,title:o("openapi.mcp.prompts","MCP Prompts")}),m.length>0&&s(i,{items:m,onClick:r,routingBasePath:n,translate:o,title:o("openapi.operations","Operations")}),h.length>0&&s(i,{items:h,onClick:r,routingBasePath:n,translate:o,title:o("openapi.webhooks","Webhooks")}),!p&&!!v&&y(U,{variant:"link",size:"large","data-testid":"show-more-operations",fullWidth:!0,onClick:()=>w(!0),children:[o("openapi.actions.show","Show")," ",v," ",o("openapi.actions.more","more"),"..."]}),l.length>0&&S&&s(Q,{}),l.length>0&&s(i,{items:l,onClick:r,routingBasePath:n,translate:o,disableTooltip:!0})]})}const co=W(H),J=x(L)`
   display: flex;
   flex-direction: column;
   gap: var(--spacing-xxs);

package/lib/components/TagItem/TagItem.js

@@ -1,4 +1,4 @@
-import{jsx as i,jsxs as e}from"react/jsx-runtime";import{memo as T,useCallback as v}from"react";import{useNavigate as W}from"react-router-dom";import{useAtomValue as M}from"jotai";import{LayoutVariant as C}from"@redocly/config";import{Markdown as o}from"@redocly/theme/components/Markdown/Markdown";import{breakpoints as d}from"@redocly/theme/core/openapi";import{Button as I}from"@redocly/theme/components/Button/Button";import{PageActions as j}from"@redocly/theme/components/PageActions/PageActions";import{H2 as B}from"@redocly/theme/components/Typography/H2";import{LinkIcon as A}from"@redocly/theme/icons/LinkIcon/LinkIcon";import{encodeBackSlashes as L,getBreadcrumbs as H}from"../../utils/index.js";import{joinWithSeparator as $}from"../../services/history/helpers.js";import{Row as P,SamplesMiddlePanel as w,SamplesPanel as c,ShareLink as D}from"../common/index.js";import{Markdown as N}from"../Markdown/index.js";import{OperationsNavigation as V}from"./OperationsNavigation.js";import{Breadcrumbs as _}from"./Breadcrumbs.js";import{layoutAtom as E}from"../../jotai/app.js";import{useTranslate as F}from"../../hooks/index.js";import{styled as r}from"../../styled-components.js";import{StyledShareLink as K}from"../common/linkify.js";function O({item:a,routingBasePath:n="",isExpanded:g}){const b=F(),{description:k,name:f,href:x}=a,t=W(),h=M(E),l=$(n,a.href),S=v(()=>{t(l)},[t,l]),p=!!a.items.length,m=h===C.STACKED,s=!p,u=H(a),y=v(z=>{t($(n,L(z)))},[t,n]);return e(R,{expanded:g,children:[e(P,{layout:h,children:[e(q,{fullWidth:s,isStacked:m,children:[e(G,{fullWidth:s,isStacked:m,children:[u.length>0&&i(_,{breadcrumbs:u,onClick:y}),e(Q,{children:[i(D,{to:x,"aria-label":`link to ${f}`}),f]}),i(j,{pageSlug:l})]}),i(J,{fullWidth:s,isStacked:m,children:i(N,{source:k})})]}),p&&i(V,{items:a.items,routingBasePath:n})]}),p&&!g&&e(U,{type:"button",variant:"text",size:"medium",onClick:S,children:["+ ",b("openapi.actions.show","Show")]})]})}const $a=T(O),R=r.div`
+import{jsx as i,jsxs as e}from"react/jsx-runtime";import{memo as T,useCallback as v}from"react";import{useNavigate as W}from"react-router";import{useAtomValue as M}from"jotai";import{LayoutVariant as C}from"@redocly/config";import{Markdown as o}from"@redocly/theme/components/Markdown/Markdown";import{breakpoints as d}from"@redocly/theme/core/openapi";import{Button as I}from"@redocly/theme/components/Button/Button";import{PageActions as j}from"@redocly/theme/components/PageActions/PageActions";import{H2 as B}from"@redocly/theme/components/Typography/H2";import{LinkIcon as A}from"@redocly/theme/icons/LinkIcon/LinkIcon";import{encodeBackSlashes as L,getBreadcrumbs as H}from"../../utils/index.js";import{joinWithSeparator as $}from"../../services/history/helpers.js";import{Row as P,SamplesMiddlePanel as w,SamplesPanel as c,ShareLink as D}from"../common/index.js";import{Markdown as N}from"../Markdown/index.js";import{OperationsNavigation as V}from"./OperationsNavigation.js";import{Breadcrumbs as _}from"./Breadcrumbs.js";import{layoutAtom as E}from"../../jotai/app.js";import{useTranslate as F}from"../../hooks/index.js";import{styled as r}from"../../styled-components.js";import{StyledShareLink as K}from"../common/linkify.js";function O({item:a,routingBasePath:n="",isExpanded:g}){const b=F(),{description:k,name:f,href:x}=a,t=W(),h=M(E),l=$(n,a.href),S=v(()=>{t(l)},[t,l]),p=!!a.items.length,m=h===C.STACKED,s=!p,u=H(a),y=v(z=>{t($(n,L(z)))},[t,n]);return e(R,{expanded:g,children:[e(P,{layout:h,children:[e(q,{fullWidth:s,isStacked:m,children:[e(G,{fullWidth:s,isStacked:m,children:[u.length>0&&i(_,{breadcrumbs:u,onClick:y}),e(Q,{children:[i(D,{to:x,"aria-label":`link to ${f}`}),f]}),i(j,{pageSlug:l})]}),i(J,{fullWidth:s,isStacked:m,children:i(N,{source:k})})]}),p&&i(V,{items:a.items,routingBasePath:n})]}),p&&!g&&e(U,{type:"button",variant:"text",size:"medium",onClick:S,children:["+ ",b("openapi.actions.show","Show")]})]})}const $a=T(O),R=r.div`
   padding-top: var(--spacing-lg);
   padding-bottom: ${({expanded:a})=>a?"var(--spacing-xxl)":""};
 `,q=r(w)`

package/lib/components/ViewNested/__tests__/ViewNested.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/ViewNested/__tests__/ViewNested.test.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render, screen } from '@testing-library/react';
+import { ViewNested } from '../ViewNested.js';
+describe('ViewNested', () => {
+    it('should render nested array content directly without show properties button', () => {
+        render(_jsx(ViewNested, { expandByDefault: false, isNestedArray: true, children: _jsx("div", { children: "Nested Array Content" }) }));
+        expect(screen.getByText('Nested Array Content')).toBeInTheDocument();
+        expect(screen.queryByText(/Show \d+ properties/)).toBeNull();
+    });
+    it('should auto-expand nested arrays', () => {
+        render(_jsx(ViewNested, { expandByDefault: false, isNestedArray: true, children: _jsx("div", { children: "Nested Content" }) }));
+        const nestedContent = screen.getByText('Nested Content');
+        expect(nestedContent).toBeVisible();
+    });
+    it('should expand via "Expand all" within the depth limit', () => {
+        render(_jsx(ViewNested, { expandByDefault: false, expandable: true, expandText: "Show 1 property", level: 5, expandedAll: true, children: _jsx("div", { children: "Deep Content" }) }));
+        expect(screen.getByText('Deep Content')).toBeInTheDocument();
+        expect(screen.queryByText('Show 1 property')).toBeNull();
+    });
+    it('should NOT auto-expand beyond the depth limit on "Expand all" (prevents freeze on DAG-shaped schemas)', () => {
+        render(_jsx(ViewNested, { expandByDefault: false, expandable: true, expandText: "Show 1 property", level: 50, expandedAll: true, children: _jsx("div", { children: "Very Deep Content" }) }));
+        // Stays collapsed: the node is still manually expandable, just not force-expanded.
+        expect(screen.queryByText('Very Deep Content')).toBeNull();
+        expect(screen.getByText('Show 1 property')).toBeInTheDocument();
+    });
+    it('should respect the adaptive expandAllDepth over the default ceiling', () => {
+        render(_jsx(ViewNested, { expandByDefault: false, expandable: true, expandText: "Show 1 property", level: 6, expandedAll: true, expandAllDepth: 5, children: _jsx("div", { children: "Adaptive Deep Content" }) }));
+        expect(screen.queryByText('Adaptive Deep Content')).toBeNull();
+        expect(screen.getByText('Show 1 property')).toBeInTheDocument();
+    });
+    it('should cap expandAllDepth by the ceiling even when the budget allows more', () => {
+        render(_jsx(ViewNested, { expandByDefault: false, expandable: true, expandText: "Show 1 property", level: 12, expandedAll: true, expandAllDepth: 15, children: _jsx("div", { children: "Beyond Ceiling Content" }) }));
+        expect(screen.queryByText('Beyond Ceiling Content')).toBeNull();
+        expect(screen.getByText('Show 1 property')).toBeInTheDocument();
+    });
+    it('should always collapse on "Collapse all" regardless of depth', () => {
+        render(_jsx(ViewNested, { expandByDefault: true, expandable: true, expandText: "Show 1 property", level: 50, expandedAll: false, children: _jsx("div", { children: "Deep Content To Collapse" }) }));
+        expect(screen.queryByText('Deep Content To Collapse')).toBeNull();
+        expect(screen.getByText('Show 1 property')).toBeInTheDocument();
+    });
+});
+//# sourceMappingURL=ViewNested.test.js.map

package/lib/components/__tests__/Samples/ExampleSwitch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/__tests__/Samples/ExampleSwitch.test.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render, fireEvent } from '@testing-library/react';
+import { ExampleSwitch } from '../../Samples/index.js';
+import { exampleXML, examples } from '../mocks/examples.js';
+describe('ExampleSwitch', () => {
+    const exampleKey = 'cat';
+    it('should correctly render ExampleSwitch', () => {
+        const { getByTestId, getAllByRole } = render(_jsx(ExampleSwitch, { exampleKey: exampleKey, examples: examples, onChange: () => { } }));
+        expect(getByTestId('dropdown')).toBeInTheDocument();
+        const triggerButton = getByTestId('dropdown').querySelector('button');
+        if (triggerButton) {
+            fireEvent.click(triggerButton);
+        }
+        const menuItems = getAllByRole('menuitem');
+        expect(menuItems.length).toBe(3);
+    });
+    it('should correctly display ExampleSwitch with a different number of examples in the media type', () => {
+        let examplesObj = {
+            exampleKey: 'bee',
+            examples: examples,
+        };
+        const { getByTestId, getAllByRole, rerender } = render(_jsx(ExampleSwitch, { exampleKey: examplesObj.exampleKey, examples: examplesObj.examples, onChange: () => { } }));
+        expect(getByTestId('dropdown')).toBeInTheDocument();
+        let triggerButton = getByTestId('dropdown').querySelector('button');
+        if (triggerButton) {
+            fireEvent.click(triggerButton);
+        }
+        expect(getAllByRole('menuitem').length).toBe(3);
+        if (triggerButton) {
+            fireEvent.click(triggerButton);
+        }
+        examplesObj = {
+            exampleKey: 'foo',
+            examples: exampleXML,
+        };
+        rerender(_jsx(ExampleSwitch, { exampleKey: examplesObj.exampleKey, examples: examplesObj.examples, onChange: () => { } }));
+        expect(getByTestId('dropdown')).toBeInTheDocument();
+        triggerButton = getByTestId('dropdown').querySelector('button');
+        if (triggerButton) {
+            fireEvent.click(triggerButton);
+        }
+        expect(getAllByRole('menuitem').length).toBe(2);
+    });
+});
+//# sourceMappingURL=ExampleSwitch.test.js.map

package/lib/components/__tests__/Samples/use-example-key.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/__tests__/Samples/use-example-key.test.js

@@ -0,0 +1,28 @@
+import { renderHook } from '@testing-library/react';
+import { normalizeOptions, OpenAPIParser, } from '../../../services/index.js';
+import { getOperation } from '../../../models/index.js';
+import testDefinition from '../../MediaTypeSwitch/__tests__/fixtures/test-definition.json';
+import { useExampleKey } from '../../Samples/use-example-key.js';
+describe('useExampleKey method', () => {
+    const options = normalizeOptions({});
+    const parser = new OpenAPIParser(testDefinition, undefined, options);
+    test('should take firstKey as exampleKey if activeExampleName and defaultExampleName are missing', () => {
+        const operation = getOperation(parser, {
+            pointer: '#/paths/~1test/get',
+            pathName: '/test',
+            httpVerb: 'GET',
+            pathParameters: [],
+            pathServers: [],
+            isWebhook: false,
+            operationId: 'getPet',
+            ...testDefinition.paths['/test'].get,
+        }, undefined, options, '');
+        const { result } = renderHook(() => useExampleKey(operation, { key: 'test' }));
+        expect(result.current.exampleKey).toBe('key');
+    });
+    test('should not brake if no operation passed and should take firstKey as exampleKey', () => {
+        const { result } = renderHook(() => useExampleKey(undefined, { key: 'test' }));
+        expect(result.current.exampleKey).toBe('key');
+    });
+});
+//# sourceMappingURL=use-example-key.test.js.map

package/lib/components/__tests__/common/ClearButton.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/__tests__/common/ClearButton.test.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { vi } from 'vitest';
+import { render } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { ClearButton } from '../../common/ClearButton/index.js';
+describe('ClearButton component', () => {
+    const handleClear = vi.fn();
+    it('render component correctly', () => {
+        const { container } = render(_jsx(ClearButton, { handleClear: handleClear }));
+        expect(container).toMatchSnapshot();
+    });
+    it('trigger `handleClear` func on click', async () => {
+        const { getByRole } = render(_jsx(ClearButton, { handleClear: handleClear }));
+        await userEvent.click(getByRole('button'));
+        expect(handleClear).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=ClearButton.test.js.map

package/lib/components/__tests__/common/Dropdown.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/__tests__/common/Dropdown.test.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render, fireEvent } from '@testing-library/react';
+import { Select, SimpleSelect } from '../../common/Select/index.js';
+describe('Select component', () => {
+    const onChange = vi.fn();
+    const options = [
+        { idx: 0, title: 'First option', value: 'option1' },
+        { idx: 1, title: 'Second option', value: 'option2' },
+    ];
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('render Select component correctly', () => {
+        const { container, getByTestId, getAllByRole } = render(_jsx(Select, { variant: "dark", options: options, value: options[0].value, onChange: onChange }));
+        expect(container.firstChild).toMatchSnapshot();
+        const dropdown = getByTestId('dropdown');
+        const triggerButton = dropdown.querySelector('button');
+        expect(triggerButton).toBeInTheDocument();
+        if (triggerButton) {
+            fireEvent.click(triggerButton);
+        }
+        const menuItems = getAllByRole('menuitem');
+        fireEvent.click(menuItems[1]);
+        expect(onChange).toHaveBeenCalled();
+    });
+    it('render SimpleSelect dark variant correctly', () => {
+        const { container, getByTestId, getAllByRole } = render(_jsx(SimpleSelect, { variant: "dark", options: options, value: options[0].value, onChange: onChange }));
+        expect(container.firstChild).toMatchSnapshot();
+        const dropdown = getByTestId('dropdown');
+        const triggerButton = dropdown.querySelector('button');
+        expect(triggerButton).toBeInTheDocument();
+        if (triggerButton) {
+            fireEvent.click(triggerButton);
+        }
+        const menuItems = getAllByRole('menuitem');
+        fireEvent.click(menuItems[1]);
+        expect(onChange).toHaveBeenCalled();
+    });
+    it('render Select with empty init value', () => {
+        const { getByTestId, getAllByRole } = render(_jsx(Select, { variant: "dark", options: options, value: "", onChange: onChange }));
+        const dropdown = getByTestId('dropdown');
+        const triggerButton = dropdown.querySelector('button');
+        if (triggerButton) {
+            fireEvent.click(triggerButton);
+        }
+        const menuItems = getAllByRole('menuitem');
+        expect(menuItems[0]).toHaveTextContent('First option');
+        fireEvent.click(menuItems[1]);
+        expect(onChange).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=Dropdown.test.js.map

package/lib/components/__tests__/mocks/examples.d.ts

@@ -0,0 +1,4 @@
+import type { ExampleModelsMap } from '../../Samples';
+export declare const examples: ExampleModelsMap;
+export declare const examplesJSON: ExampleModelsMap;
+export declare const exampleXML: ExampleModelsMap;