@redocly/theme 0.56.0-rc.2 → 0.56.1

package/lib/components/VersionPicker/VersionPicker.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import type { Version } from '@redocly/config';
-import type { SelectProps } from '../../core/types/select';
-import { Select } from '../../components/Select/Select';
+import type { SelectProps } from '@redocly/theme/core/types/select';
+import { Select } from '@redocly/theme/components/Select/Select';
 export declare function VersionPicker(props: {
     versions?: Version[];
     onChange: (v: Version) => void;

package/lib/components/VersionPicker/VersionPicker.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -30,9 +40,9 @@ exports.VersionPickerSelect = void 0;
 exports.VersionPicker = VersionPicker;
 const React = __importStar(require("react"));
 const styled_components_1 = __importDefault(require("styled-components"));
-const hooks_1 = require("../../core/hooks");
-const Select_1 = require("../../components/Select/Select");
-const SelectInput_1 = require("../../components/Select/SelectInput");
+const hooks_1 = require("@redocly/theme/core/hooks");
+const Select_1 = require("@redocly/theme/components/Select/Select");
+const SelectInput_1 = require("@redocly/theme/components/Select/SelectInput");
 function VersionPicker(props) {
     const themeConfig = (0, hooks_1.useThemeConfig)();
     const { versionPicker } = themeConfig;

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

@@ -1,4 +1,4 @@
-import type { EntityRelationType } from '../../core/types';
+import type { EntityRelationType } from '../types/catalog';
 export declare const CATALOG_TAG_MAX_LENGTH = 15;
 export declare const ENTITY_RELATION_TYPES: readonly ["partOf", "hasParts", "creates", "createdBy", "owns", "ownedBy", "implements", "implementedBy", "dependsOn", "dependencyOf", "uses", "usedBy", "produces", "consumes", "linksTo", "supersedes", "supersededBy", "compatibleWith", "extends", "extendedBy", "relatesTo", "hasMember", "memberOf", "triggers", "triggeredBy"];
 export declare const reverseRelationMap: Record<EntityRelationType, EntityRelationType>;

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

@@ -1,6 +1,10 @@
 export { REDOCLY_TEAMS_RBAC } from '@redocly/config';
 export declare const DEFAULT_LOCALE_PLACEHOLDER = "default_locale";
 export declare const CONTENT_ID = "content";
+export declare const ICONS_CDN_URL: {
+    'font-awesome': string;
+    code: string;
+};
 export declare enum FEEDBACK_TYPES {
     RATING = "rating",
     SENTIMENT = "sentiment",

package/lib/core/constants/common.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MobileMenuType = exports.MenuItemType = exports.DEFAULT_FEEDBACK_TYPE = exports.FEEDBACK_TYPES = exports.CONTENT_ID = exports.DEFAULT_LOCALE_PLACEHOLDER = exports.REDOCLY_TEAMS_RBAC = void 0;
+exports.MobileMenuType = exports.MenuItemType = exports.DEFAULT_FEEDBACK_TYPE = exports.FEEDBACK_TYPES = exports.ICONS_CDN_URL = exports.CONTENT_ID = exports.DEFAULT_LOCALE_PLACEHOLDER = exports.REDOCLY_TEAMS_RBAC = void 0;
 var config_1 = require("@redocly/config");
 Object.defineProperty(exports, "REDOCLY_TEAMS_RBAC", { enumerable: true, get: function () { return config_1.REDOCLY_TEAMS_RBAC; } });
 exports.DEFAULT_LOCALE_PLACEHOLDER = 'default_locale';
 exports.CONTENT_ID = 'content';
+exports.ICONS_CDN_URL = {
+    'font-awesome': 'https://cdn.redocly.com/icons/fa/7.0.0',
+    code: 'https://cdn.redocly.com/icons/code/5.24.0',
+};
 var FEEDBACK_TYPES;
 (function (FEEDBACK_TYPES) {
     FEEDBACK_TYPES["RATING"] = "rating";

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

@@ -0,0 +1,7 @@
+export type CodeSnippetContextType = {
+    activeSnippetName: string;
+    setActiveSnippetName: (name: string) => void;
+};
+export declare const CODE_GROUP_SNIPPET_NAME_KEY = "redocly:codeGroupSnippetName";
+export declare const CodeSnippetContext: import("react").Context<CodeSnippetContextType | null>;
+export declare function useActiveCodeSnippetName(mode: 'tabs' | 'dropdown'): [string, (name: string) => void];

package/lib/core/contexts/CodeSnippetContext.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeSnippetContext = exports.CODE_GROUP_SNIPPET_NAME_KEY = void 0;
+exports.useActiveCodeSnippetName = useActiveCodeSnippetName;
+const react_1 = require("react");
+exports.CODE_GROUP_SNIPPET_NAME_KEY = 'redocly:codeGroupSnippetName';
+exports.CodeSnippetContext = (0, react_1.createContext)(null);
+function useActiveCodeSnippetName(mode) {
+    const context = (0, react_1.useContext)(exports.CodeSnippetContext);
+    if (!context) {
+        throw new Error('useCodeSnippetContext must be used within a CodeSnippetContext');
+    }
+    const [activeSnippetName, setActiveSnippetName] = (0, react_1.useState)(mode === 'tabs' ? '' : context.activeSnippetName);
+    if (mode === 'tabs') {
+        // use non-synced state for tabs mode
+        return [activeSnippetName, setActiveSnippetName];
+    }
+    else {
+        // use global synced state for dropdown mode
+        return [context.activeSnippetName, context.setActiveSnippetName];
+    }
+}
+//# sourceMappingURL=CodeSnippetContext.js.map

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

@@ -1,3 +1,4 @@
 export * from './ThemeDataContext';
 export * from './CodeWalkthrough/CodeWalkthroughControlsContext';
 export * from './CodeWalkthrough/CodeWalkthroughStepsContext';
+export * from './CodeSnippetContext';

package/lib/core/contexts/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ThemeDataContext"), exports);
 __exportStar(require("./CodeWalkthrough/CodeWalkthroughControlsContext"), exports);
 __exportStar(require("./CodeWalkthrough/CodeWalkthroughStepsContext"), exports);
+__exportStar(require("./CodeSnippetContext"), exports);
 //# sourceMappingURL=index.js.map

package/lib/core/hooks/__mocks__/use-theme-hooks.d.ts

@@ -64,4 +64,5 @@ export declare const useThemeHooks: jest.Mock<{
     }, [], any>;
     useLoadAndNavigate: jest.Mock<any, any, any>;
     usePageProps: jest.Mock<any, any, any>;
+    usePageData: jest.Mock<any, any, any>;
 }, [], any>;

package/lib/core/hooks/__mocks__/use-theme-hooks.js

@@ -87,5 +87,6 @@ exports.useThemeHooks = jest.fn(() => ({
     })),
     useLoadAndNavigate: jest.fn(),
     usePageProps: jest.fn().mockReturnValue({}),
+    usePageData: jest.fn().mockReturnValue(null),
 }));
 //# sourceMappingURL=use-theme-hooks.js.map

package/lib/core/hooks/catalog/useCatalogTableHeaderCellActions.d.ts

@@ -1,4 +1,4 @@
-import { BaseEntity, CatalogColumn } from '../../../components/Catalog/CatalogTableView/CatalogTableView';
+import { BaseEntity, CatalogColumn } from '@redocly/theme/components/Catalog/CatalogTableView/CatalogTableView';
 import { SortOption } from '../../types';
 type CatalogTableHeaderCellActionsProps<T extends BaseEntity> = {
     column: CatalogColumn<T>;

package/lib/core/hooks/code-walkthrough/use-renderable-files.d.ts

@@ -1,7 +1,6 @@
 import type { CodeWalkthroughFile } from '@redocly/config';
-import type { IconProps } from '../../../icons/types';
 export type RenderableFile = CodeWalkthroughFile & {
-    FileIcon: React.FunctionComponent<IconProps>;
+    fileIcon: React.JSX.Element;
     parentFolder: string;
     isNameDuplicate: boolean;
     inRootDir: boolean;

package/lib/core/hooks/code-walkthrough/use-renderable-files.js

@@ -10,11 +10,11 @@ function useRenderableFiles(files) {
         const filePaths = files.map(({ path }) => path);
         const rootDir = (0, find_closest_common_directory_1.findClosestCommonDirectory)(filePaths);
         const renderableFiles = files.map((file) => {
-            const FileIcon = getFileTypeIcon(file.basename);
+            const fileIcon = getFileTypeIcon(file.basename);
             const parentFolder = file.path.split('/').slice(-2, -1)[0];
             const isNameDuplicate = files.some((_file) => file.basename === _file.basename && file.path !== _file.path);
             const inRootDir = file.path === `${(0, urls_1.removeLeadingSlash)(rootDir)}/${file.basename}`;
-            return Object.assign(Object.assign({}, file), { FileIcon,
+            return Object.assign(Object.assign({}, file), { fileIcon,
                 inRootDir,
                 parentFolder,
                 isNameDuplicate });

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

@@ -40,3 +40,4 @@ export * from './catalog/useCatalogEntities';
 export * from './use-active-page-version';
 export * from './use-page-versions';
 export * from './use-user-teams';
+export * from './use-page-actions';

package/lib/core/hooks/index.js

@@ -56,4 +56,5 @@ __exportStar(require("./catalog/useCatalogEntities"), exports);
 __exportStar(require("./use-active-page-version"), exports);
 __exportStar(require("./use-page-versions"), exports);
 __exportStar(require("./use-user-teams"), exports);
+__exportStar(require("./use-page-actions"), exports);
 //# sourceMappingURL=index.js.map

package/lib/core/hooks/use-active-heading.d.ts

@@ -1,2 +1,7 @@
-export type UseActiveHeadingReturnType = string | undefined;
-export declare function useActiveHeading(contentElement: HTMLDivElement | null, displayedHeaders: Array<string | undefined>): UseActiveHeadingReturnType;
+export declare function useActiveHeading(contentElement: HTMLDivElement | null, displayedHeadings?: Array<{
+    id: string;
+    depth: number;
+} | null>): {
+    heading: string | undefined;
+    handleHeadingClick: (headingId: string) => void;
+};

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

@@ -3,11 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useActiveHeading = useActiveHeading;
 const react_1 = require("react");
 const react_router_dom_1 = require("react-router-dom");
-function useActiveHeading(contentElement, displayedHeaders) {
-    const [heading, setHeading] = (0, react_1.useState)(displayedHeaders.length > 1 ? displayedHeaders[0] : undefined);
+const utils_1 = require("../utils");
+function useActiveHeading(contentElement, displayedHeadings) {
+    const [heading, setHeading] = (0, react_1.useState)(undefined);
     const [headingElements, setHeadingElements] = (0, react_1.useState)([]);
     const headingElementsRef = (0, react_1.useRef)({});
+    const displayedHeadingsRef = (0, react_1.useRef)(displayedHeadings);
+    const lockObserver = (0, react_1.useRef)(false);
     const location = (0, react_router_dom_1.useLocation)();
+    (0, react_1.useEffect)(() => {
+        setHeading(undefined);
+        headingElementsRef.current = {};
+    }, [location.pathname]);
+    (0, react_1.useEffect)(() => {
+        displayedHeadingsRef.current = displayedHeadings;
+    }, [displayedHeadings]);
     const getVisibleHeadings = () => {
         const visibleHeadings = [];
         for (const key in headingElementsRef.current) {
@@ -18,28 +28,98 @@ function useActiveHeading(contentElement, displayedHeaders) {
         }
         return visibleHeadings;
     };
+    const isTopOfPage = () => window.scrollY <= 50;
+    // Returns viewport ratio for intersection observer based on screen height
+    const getViewportRatio = () => {
+        const vh = window.innerHeight;
+        if (vh >= 1400)
+            return 0.4;
+        if (vh >= 1000)
+            return 0.3;
+        return 0.25;
+    };
     const getIndexFromId = (0, react_1.useCallback)((id) => {
         return headingElements.findIndex((item) => item.id === id);
     }, [headingElements]);
     const findHeaders = (allContent) => {
         const allHeaders = allContent.querySelectorAll('.heading-anchor');
-        return Array.from(allHeaders);
+        const headers = Array.from(allHeaders);
+        if (displayedHeadingsRef.current && displayedHeadingsRef.current.length > 0) {
+            const displayedIds = displayedHeadingsRef.current.map((h) => h === null || h === void 0 ? void 0 : h.id).filter(Boolean);
+            return headers.filter((header) => displayedIds.includes(header.id));
+        }
+        return headers;
     };
-    const intersectionCallback = (0, react_1.useCallback)((headings) => {
+    const calculateVirtualPositions = (0, react_1.useCallback)((headers) => {
+        var _a;
+        if (!headers.length)
+            return {};
+        const navbarHeight = ((_a = document.querySelector('nav')) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect().height) || 0;
+        const viewportHeight = window.innerHeight;
+        const triggerOffset = navbarHeight + viewportHeight * 0.25;
+        const lastHeader = headers[headers.length - 1];
+        const lastHeaderTop = lastHeader.offsetTop;
+        const maxScrollableHeight = document.body.scrollHeight - viewportHeight;
+        const requiredUplift = Math.max(0, lastHeaderTop - maxScrollableHeight + triggerOffset);
+        const virtualPositions = {};
+        for (let i = 0; i < headers.length; i++) {
+            const header = headers[i];
+            const headerTop = header.offsetTop;
+            const normalizedPosition = headers.length === 1 ? 0 : i / (headers.length - 1);
+            const adjustmentFactor = (0, utils_1.enhancedSmoothstep)(normalizedPosition, 0.4);
+            const uplift = requiredUplift * adjustmentFactor;
+            const virtualTop = headerTop - uplift;
+            virtualPositions[header.id] = virtualTop;
+        }
+        return virtualPositions;
+    }, []);
+    const getTriggerOffset = (0, react_1.useCallback)(() => {
         var _a;
-        headingElementsRef.current = headings.reduce((map, headingElement) => {
-            map[headingElement.target.id] = headingElement;
+        const navbarHeight = ((_a = document.querySelector('nav')) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect().height) || 0;
+        return navbarHeight + window.innerHeight * getViewportRatio();
+    }, []);
+    const findActiveHeaderByVirtualPosition = (0, react_1.useCallback)((headers, scrollY, triggerOffset) => {
+        const virtualPositions = calculateVirtualPositions(headers);
+        let activeHeader = headers[0];
+        for (const header of headers) {
+            const virtualTop = virtualPositions[header.id] || header.offsetTop;
+            if (virtualTop <= scrollY + triggerOffset) {
+                activeHeader = header;
+            }
+            else {
+                break;
+            }
+        }
+        return activeHeader;
+    }, [calculateVirtualPositions]);
+    const intersectionCallback = (0, react_1.useCallback)((entries) => {
+        var _a, _b, _c;
+        if (lockObserver.current) {
+            return;
+        }
+        headingElementsRef.current = entries.reduce((map, entry) => {
+            map[entry.target.id] = entry;
             return map;
         }, headingElementsRef.current);
-        const totalHeight = window.scrollY + window.innerHeight;
-        // handle bottom of the page
-        if (totalHeight >= document.body.scrollHeight) {
-            const newHeading = ((_a = headingElements[(headingElements === null || headingElements === void 0 ? void 0 : headingElements.length) - 1]) === null || _a === void 0 ? void 0 : _a.id) || undefined;
+        if (isTopOfPage()) {
+            const newHeading = ((_a = headingElements[0]) === null || _a === void 0 ? void 0 : _a.id) || undefined;
             setHeading(newHeading);
             return;
         }
         const visibleHeadings = getVisibleHeadings();
         if (!visibleHeadings.length) {
+            const triggerOffset = getTriggerOffset();
+            if (isTopOfPage()) {
+                setHeading(((_b = headingElements[0]) === null || _b === void 0 ? void 0 : _b.id) || undefined);
+                return;
+            }
+            const totalHeight = window.scrollY + window.innerHeight;
+            if (totalHeight >= document.body.scrollHeight - 10) {
+                setHeading(((_c = headingElements[headingElements.length - 1]) === null || _c === void 0 ? void 0 : _c.id) || undefined);
+                return;
+            }
+            const activeHeader = findActiveHeaderByVirtualPosition(headingElements, window.scrollY, triggerOffset);
+            setHeading(activeHeader.id);
             return;
         }
         if (visibleHeadings.length === 1) {
@@ -49,31 +129,88 @@ function useActiveHeading(contentElement, displayedHeaders) {
         visibleHeadings.sort((a, b) => {
             return getIndexFromId(a.target.id) - getIndexFromId(b.target.id);
         });
+        const firstVisibleHeading = visibleHeadings[0];
+        if (getIndexFromId(firstVisibleHeading.target.id) === 0 && isTopOfPage()) {
+            setHeading(firstVisibleHeading.target.id);
+            return;
+        }
+        const totalHeight = scrollY + window.innerHeight;
+        if (totalHeight >= document.body.scrollHeight - 10) {
+            setHeading(visibleHeadings[visibleHeadings.length - 1].target.id);
+            return;
+        }
         setHeading(visibleHeadings[0].target.id);
-    }, [getIndexFromId, headingElements]);
+    }, [getIndexFromId, headingElements, getTriggerOffset, findActiveHeaderByVirtualPosition]);
+    const handleHeadingClick = (0, react_1.useCallback)((headingId) => {
+        lockObserver.current = true;
+        setHeading(headingId);
+        const headingElement = headingElements.find((el) => el.id === headingId);
+        if (headingElement && headingElement.scrollIntoView) {
+            headingElement.scrollIntoView({ behavior: 'smooth', block: 'start' });
+        }
+        setTimeout(() => {
+            headingElementsRef.current = {};
+            lockObserver.current = false;
+        }, 300);
+    }, [headingElements]);
     (0, react_1.useEffect)(() => {
+        var _a;
         if (!contentElement) {
             return;
         }
-        setHeadingElements(findHeaders(contentElement));
-    }, [contentElement, location]);
+        const headers = findHeaders(contentElement);
+        setHeadingElements(headers);
+        if (headers.length > 0 && !heading) {
+            if (isTopOfPage()) {
+                setHeading(headers[0].id);
+            }
+            else {
+                const totalHeight = scrollY + window.innerHeight;
+                if (totalHeight >= document.body.scrollHeight - 10) {
+                    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);
+                    setHeading(activeHeader.id);
+                }
+            }
+        }
+    }, [
+        contentElement,
+        location,
+        heading,
+        calculateVirtualPositions,
+        getTriggerOffset,
+        findActiveHeaderByVirtualPosition,
+    ]);
     (0, react_1.useEffect)(() => {
         if (!(headingElements === null || headingElements === void 0 ? void 0 : headingElements.length)) {
             return;
         }
         headingElementsRef.current = {};
-        // Bottom rootMargin -30% changes part of the view where IntersectionObserver starts to detect headers
+        const triggerOffset = getTriggerOffset();
         const observer = new IntersectionObserver(intersectionCallback, {
-            rootMargin: '0px 0px -30% 0px',
-            threshold: 1,
+            rootMargin: `-${triggerOffset}px 0px -${window.innerHeight * getViewportRatio()}px 0px`,
+            threshold: [0, 0.1, 0.3, 0.5, 0.7, 1],
         });
-        headingElements === null || headingElements === void 0 ? void 0 : headingElements.forEach((element) => {
-            if (displayedHeaders.includes(element.id)) {
-                observer.observe(element);
-            }
+        headingElements.forEach((element) => {
+            observer.observe(element);
         });
-        return () => observer.disconnect();
-    }, [headingElements, displayedHeaders, intersectionCallback]);
-    return heading;
+        const handleScroll = () => {
+            var _a;
+            if (lockObserver.current)
+                return;
+            if (isTopOfPage()) {
+                setHeading(((_a = headingElements[0]) === null || _a === void 0 ? void 0 : _a.id) || undefined);
+            }
+        };
+        window.addEventListener('scroll', handleScroll, { passive: true });
+        return () => {
+            observer.disconnect();
+            window.removeEventListener('scroll', handleScroll);
+        };
+    }, [headingElements, intersectionCallback, getTriggerOffset]);
+    return { heading, handleHeadingClick };
 }
 //# sourceMappingURL=use-active-heading.js.map

package/lib/core/hooks/use-active-section-id.d.ts

@@ -1,3 +1,3 @@
 import type { Location } from 'react-router-dom';
 export type UseActiveSectionIdReturnType = string;
-export declare function useActiveSectionId(location: Location, hasOverviewPage?: boolean, withNavbar?: boolean): UseActiveSectionIdReturnType;
+export declare function useActiveSectionId(location: Location, hasOverviewPage?: boolean, withNavbar?: boolean, sectionOffset?: number): UseActiveSectionIdReturnType;

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

@@ -7,10 +7,10 @@ exports.useActiveSectionId = useActiveSectionId;
 const react_1 = require("react");
 const lodash_throttle_1 = __importDefault(require("lodash.throttle"));
 const use_navbar_height_1 = require("./use-navbar-height");
-function useActiveSectionId(location, hasOverviewPage = false, withNavbar = true) {
+function useActiveSectionId(location, hasOverviewPage = false, withNavbar = true, sectionOffset = 150) {
     const [itemId, setItemId] = (0, react_1.useState)('');
     const navbarHeight = (0, use_navbar_height_1.useNavbarHeight)(location);
-    const heightOffset = (withNavbar ? navbarHeight : 0) + 150; // use 150px to account next section visibility;
+    const heightOffset = (withNavbar ? navbarHeight : 0) + sectionOffset;
     const scrollListener = (0, react_1.useMemo)(() => (0, lodash_throttle_1.default)(() => {
         const sections = document.querySelectorAll('[data-section-id]');
         if (sections.length < 2) {

package/lib/core/hooks/use-codeblock-tabs-controls.d.ts

@@ -1,6 +1,6 @@
-import type { FileTabs } from '../../components/CodeBlock/CodeBlock';
+import type { CodeBlockTabItems } from '../../components/CodeBlock/CodeBlock';
 type CodeBlockTabsProps = {
-    tabs: FileTabs;
+    tabs: CodeBlockTabItems;
     containerRef: React.RefObject<HTMLDivElement | null>;
     tabRefs: React.RefObject<HTMLButtonElement[]>;
 };

package/lib/core/hooks/use-codeblock-tabs-controls.js

@@ -14,11 +14,11 @@ function useCodeBlockTabsControls({ tabs, containerRef, tabRefs }) {
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [(_a = tabRefs === null || tabRefs === void 0 ? void 0 : tabRefs.current) === null || _a === void 0 ? void 0 : _a.length]);
     const { currentIndex, isFirstTab, isLastTab } = (0, react_1.useMemo)(() => {
-        const currentIndex = tabs.files.findIndex((file) => file.name === tabs.activeTabName);
+        const currentIndex = tabs.items.findIndex((file) => file.name === tabs.value);
         return {
             currentIndex,
             isFirstTab: currentIndex === 0,
-            isLastTab: currentIndex === tabs.files.length - 1,
+            isLastTab: currentIndex === tabs.items.length - 1,
         };
     }, [tabs]);
     (0, react_1.useEffect)(() => {
@@ -37,15 +37,15 @@ function useCodeBlockTabsControls({ tabs, containerRef, tabRefs }) {
     }, [containerRef.current]);
     const handlePrevTab = (0, react_1.useCallback)(() => {
         if (!isFirstTab) {
-            const prevTab = tabs.files[currentIndex - 1].name;
-            tabs.handleTabSwitch(prevTab);
+            const prevTab = tabs.items[currentIndex - 1].name;
+            tabs.onChange(prevTab);
         }
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [currentIndex]);
     const handleNextTab = (0, react_1.useCallback)(() => {
         if (!isLastTab) {
-            const nextTab = tabs.files[currentIndex + 1].name;
-            tabs.handleTabSwitch(nextTab);
+            const nextTab = tabs.items[currentIndex + 1].name;
+            tabs.onChange(nextTab);
         }
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [currentIndex]);

package/lib/core/hooks/use-local-state.d.ts

@@ -0,0 +1 @@
+export declare function useLocalState<T>(key: string, initialValue: T): [T, (value: T) => void];

package/lib/core/hooks/use-local-state.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocalState = useLocalState;
+const react_1 = require("react");
+function getInitialValue(key, initialValue) {
+    if (typeof window === 'undefined') {
+        return initialValue;
+    }
+    try {
+        const savedValue = localStorage.getItem(key);
+        if (savedValue) {
+            return JSON.parse(savedValue);
+        }
+    }
+    catch (error) {
+        console.error(`Error reading from localStorage for key "${key}":`, error);
+    }
+    return initialValue;
+}
+function useLocalState(key, initialValue) {
+    const [value, setValue] = (0, react_1.useState)(() => getInitialValue(key, initialValue));
+    (0, react_1.useEffect)(() => {
+        try {
+            localStorage.setItem(key, JSON.stringify(value));
+        }
+        catch (error) {
+            console.error(`Error writing to localStorage for key "${key}":`, error);
+        }
+    }, [key, value]);
+    return [value, setValue];
+}
+//# sourceMappingURL=use-local-state.js.map

package/lib/core/hooks/use-page-actions.d.ts

@@ -0,0 +1,2 @@
+import type { PageAction } from '../types';
+export declare function usePageActions(pageSlug: string): PageAction[];