@sp-days-framework/docusaurus-plugin-interactive-tasks 1.0.0

package/lib/theme/DocSidebarItem/Category/index.js

@@ -0,0 +1,316 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = DocSidebarItemCategory;
+const react_1 = __importStar(require("react"));
+const clsx_1 = __importDefault(require("clsx"));
+const theme_common_1 = require("@docusaurus/theme-common");
+const internal_1 = require("@docusaurus/theme-common/internal");
+const client_1 = require("@docusaurus/plugin-content-docs/client");
+const Link_1 = __importDefault(require("@docusaurus/Link"));
+const Translate_1 = require("@docusaurus/Translate");
+const useIsBrowser_1 = __importDefault(require("@docusaurus/useIsBrowser"));
+const DocSidebarItems_1 = __importDefault(require("@theme/DocSidebarItems"));
+const Link_2 = __importDefault(require("@theme/DocSidebarItem/Link"));
+const useDocTaskStats_1 = require("../../../utils/useDocTaskStats");
+const useTaskBadgeAnimation_1 = require("../../../utils/useTaskBadgeAnimation");
+const usePluginId_1 = require("../../../utils/usePluginId");
+const icons_1 = require("../../../utils/icons");
+const badgeStyles_1 = require("../../../utils/badgeStyles");
+const styles_module_css_1 = __importDefault(require("./styles.module.css"));
+/**
+ * Recursively extract all docIds from category items
+ */
+function extractDocIds(items) {
+    const docIds = [];
+    for (const item of items) {
+        if (item.type === 'link' && item.docId) {
+            docIds.push(item.docId);
+        }
+        else if (item.type === 'category' && item.items) {
+            docIds.push(...extractDocIds(item.items));
+        }
+    }
+    return docIds;
+}
+// If we navigate to a category and it becomes active, it should automatically
+// expand itself
+function useAutoExpandActiveCategory({ isActive, collapsed, updateCollapsed, activePath, }) {
+    const wasActive = (0, theme_common_1.usePrevious)(isActive);
+    const previousActivePath = (0, theme_common_1.usePrevious)(activePath);
+    (0, react_1.useEffect)(() => {
+        const justBecameActive = isActive && !wasActive;
+        const stillActiveButPathChanged = isActive && wasActive && activePath !== previousActivePath;
+        if ((justBecameActive || stillActiveButPathChanged) && collapsed) {
+            updateCollapsed(false);
+        }
+    }, [
+        isActive,
+        wasActive,
+        collapsed,
+        updateCollapsed,
+        activePath,
+        previousActivePath,
+    ]);
+}
+/**
+ * When a collapsible category has no link, we still link it to its first child
+ * during SSR as a temporary fallback. This allows to be able to navigate inside
+ * the category even when JS fails to load, is delayed or simply disabled
+ * React hydration becomes an optional progressive enhancement
+ * see https://github.com/facebookincubator/infima/issues/36#issuecomment-772543188
+ * see https://github.com/facebook/docusaurus/issues/3030
+ */
+function useCategoryHrefWithSSRFallback(item) {
+    const isBrowser = (0, useIsBrowser_1.default)();
+    return (0, react_1.useMemo)(() => {
+        if (item.href && !item.linkUnlisted) {
+            return item.href;
+        }
+        // In these cases, it's not necessary to render a fallback
+        // We skip the "findFirstCategoryLink" computation
+        if (isBrowser || !item.collapsible) {
+            return undefined;
+        }
+        return (0, client_1.findFirstSidebarItemLink)(item);
+    }, [item, isBrowser]);
+}
+function CollapseButton({ collapsed, categoryLabel, onClick, }) {
+    return (react_1.default.createElement("button", { "aria-label": collapsed
+            ? (0, Translate_1.translate)({
+                id: 'theme.DocSidebarItem.expandCategoryAriaLabel',
+                message: "Expand sidebar category '{label}'",
+                description: 'The ARIA label to expand the sidebar category',
+            }, { label: categoryLabel })
+            : (0, Translate_1.translate)({
+                id: 'theme.DocSidebarItem.collapseCategoryAriaLabel',
+                message: "Collapse sidebar category '{label}'",
+                description: 'The ARIA label to collapse the sidebar category',
+            }, { label: categoryLabel }), "aria-expanded": !collapsed, type: "button", className: "clean-btn menu__caret", onClick: onClick }));
+}
+function CategoryLinkLabel({ label, taskStats, isAnimatingCompletion, isRemovingCheckmark, }) {
+    if (!taskStats) {
+        return (react_1.default.createElement("span", { title: label, className: styles_module_css_1.default.categoryLinkLabel }, label));
+    }
+    const badgeConfig = taskStats.badgeConfig;
+    const hideBadge = (0, badgeStyles_1.shouldHideBadge)(badgeConfig);
+    const disableIcon = (0, badgeStyles_1.shouldDisableIcon)(badgeConfig);
+    // If badge is hidden, render without badge
+    if (hideBadge) {
+        return (react_1.default.createElement("span", { title: label, className: styles_module_css_1.default.categoryLinkLabel }, label));
+    }
+    const badgeClass = taskStats.isComplete ? styles_module_css_1.default.categoryBadgeComplete : styles_module_css_1.default.categoryBadgeIncomplete;
+    const badgeStyles = (0, badgeStyles_1.getBadgeStyles)(badgeConfig, taskStats.isComplete);
+    // Show icon only if complete AND icon not disabled
+    const showIcon = taskStats.isComplete && !disableIcon;
+    // Determine checkmark visibility classes
+    const checkmarkClasses = (0, clsx_1.default)(styles_module_css_1.default.categoryBadgeCheckmark, {
+        [styles_module_css_1.default.categoryBadgeCheckmarkVisible]: showIcon && !isAnimatingCompletion && !isRemovingCheckmark,
+        [styles_module_css_1.default.categoryBadgeCheckmarkAnimating]: showIcon && isAnimatingCompletion,
+        [styles_module_css_1.default.categoryBadgeCheckmarkRemoving]: isRemovingCheckmark,
+    });
+    // Determine number visibility classes
+    const numberClasses = (0, clsx_1.default)(styles_module_css_1.default.categoryBadgeNumber, {
+        [styles_module_css_1.default.categoryBadgeNumberVisible]: !showIcon || isRemovingCheckmark,
+        [styles_module_css_1.default.categoryBadgeNumberRemoving]: showIcon && isAnimatingCompletion,
+    });
+    return (react_1.default.createElement("div", { className: styles_module_css_1.default.categoryWithTasks },
+        react_1.default.createElement("span", { title: label, className: (0, clsx_1.default)(styles_module_css_1.default.categoryLinkLabel, styles_module_css_1.default.categoryContent) }, label),
+        react_1.default.createElement("div", { className: (0, clsx_1.default)(styles_module_css_1.default.categoryBadge, badgeClass, isAnimatingCompletion && styles_module_css_1.default.categoryBadgeAnimating), style: badgeStyles },
+            react_1.default.createElement("span", { className: numberClasses },
+                taskStats.completedTasks,
+                "/",
+                taskStats.totalTasks),
+            react_1.default.createElement("span", { className: checkmarkClasses }, icons_1.CHECKMARKS_ICON))));
+}
+// Memoize the collapsible category component to prevent unnecessary re-renders
+const MemoizedDocSidebarItemCategoryCollapsible = (0, react_1.memo)(DocSidebarItemCategoryCollapsible);
+function DocSidebarItemCategory(props) {
+    const visibleChildren = (0, client_1.useVisibleSidebarItems)(props.item.items, props.activePath);
+    if (visibleChildren.length === 0) {
+        return react_1.default.createElement(DocSidebarItemCategoryEmpty, { ...props });
+    }
+    else {
+        return react_1.default.createElement(MemoizedDocSidebarItemCategoryCollapsible, { ...props });
+    }
+}
+function isCategoryWithHref(category) {
+    return typeof category.href === 'string';
+}
+// If a category doesn't have any visible children, we render it as a link
+function DocSidebarItemCategoryEmpty({ item, ...props }) {
+    // If the category has no link, we don't render anything
+    // It's not super useful to render a category you can't open nor click
+    if (!isCategoryWithHref(item)) {
+        return null;
+    }
+    // We remove props that don't make sense for a link and forward the rest
+    const { type, collapsed, collapsible, items, linkUnlisted, ...forwardableProps } = item;
+    const linkItem = {
+        type: 'link',
+        ...forwardableProps,
+    };
+    return react_1.default.createElement(Link_2.default, { item: linkItem, ...props });
+}
+function DocSidebarItemCategoryCollapsible({ item, onItemClick, activePath, level, index, ...props }) {
+    const { items, label, collapsible, className, href } = item;
+    const { docs: { sidebar: { autoCollapseCategories }, }, } = (0, theme_common_1.useThemeConfig)();
+    const hrefWithSSRFallback = useCategoryHrefWithSSRFallback(item);
+    const isActive = (0, client_1.isActiveSidebarItem)(item, activePath);
+    const isCurrentPage = (0, internal_1.isSamePath)(href, activePath);
+    // Get the correct plugin ID
+    const pluginId = (0, usePluginId_1.usePluginId)();
+    // Get task statistics for all children
+    // Optimize: Create stable dependency to prevent recalculation on every render
+    const docIds = (0, react_1.useMemo)(() => {
+        return extractDocIds(items);
+    }, [JSON.stringify(items)]);
+    // Pass customProps directly from sidebar item to get badge configuration
+    const taskStats = (0, useDocTaskStats_1.useCategoryTaskStats)(docIds, pluginId, item.customProps);
+    const isComplete = taskStats?.isComplete || false;
+    // Generate a unique category identifier for animation tracking
+    // Use the label as identifier since categories don't have docIds
+    const categoryId = `category-${label.replace(/\s+/g, '-').toLowerCase()}`;
+    // Animation tracking
+    const { hasAnimated, markAsAnimated } = (0, useTaskBadgeAnimation_1.useTaskBadgeAnimation)(pluginId, categoryId);
+    // Local state for animations
+    const [isAnimatingCompletion, setIsAnimatingCompletion] = (0, react_1.useState)(false);
+    const [isRemovingCheckmark, setIsRemovingCheckmark] = (0, react_1.useState)(false);
+    // Track previous completion state
+    const prevIsComplete = (0, react_1.useRef)(isComplete);
+    // Detect when completion state changes
+    (0, react_1.useEffect)(() => {
+        if (prevIsComplete.current !== isComplete) {
+            // When tasks become completed
+            if (isComplete && !prevIsComplete.current) {
+                // Only animate if not already animated this session
+                if (!hasAnimated) {
+                    setIsAnimatingCompletion(true);
+                    setIsRemovingCheckmark(false);
+                    markAsAnimated();
+                    // Clear animation state after animation completes
+                    setTimeout(() => {
+                        setIsAnimatingCompletion(false);
+                    }, 400); // Match animation duration
+                }
+            }
+            // When tasks are uncompleted (undo)
+            if (!isComplete && prevIsComplete.current) {
+                setIsRemovingCheckmark(true);
+                setIsAnimatingCompletion(false);
+                setTimeout(() => {
+                    setIsRemovingCheckmark(false);
+                }, 400);
+            }
+            prevIsComplete.current = isComplete;
+        }
+    }, [isComplete, hasAnimated, markAsAnimated]);
+    const { collapsed, setCollapsed } = (0, theme_common_1.useCollapsible)({
+        // Active categories are always initialized as expanded. The default
+        // (`item.collapsed`) is only used for non-active categories.
+        initialState: () => {
+            if (!collapsible) {
+                return false;
+            }
+            return isActive ? false : item.collapsed;
+        },
+    });
+    const { expandedItem, setExpandedItem } = (0, client_1.useDocSidebarItemsExpandedState)();
+    // Use this instead of `setCollapsed`, because it is also reactive
+    const updateCollapsed = (toCollapsed = !collapsed) => {
+        setExpandedItem(toCollapsed ? null : index);
+        setCollapsed(toCollapsed);
+    };
+    useAutoExpandActiveCategory({
+        isActive,
+        collapsed,
+        updateCollapsed,
+        activePath,
+    });
+    (0, react_1.useEffect)(() => {
+        if (collapsible &&
+            expandedItem != null &&
+            expandedItem !== index &&
+            autoCollapseCategories) {
+            setCollapsed(true);
+        }
+    }, [collapsible, expandedItem, index, setCollapsed, autoCollapseCategories]);
+    const handleItemClick = (e) => {
+        onItemClick?.(item);
+        if (collapsible) {
+            if (href) {
+                // When already on the category's page, we collapse it
+                // We don't use "isActive" because it would collapse the
+                // category even when we browse a children element
+                // See https://github.com/facebook/docusaurus/issues/11213
+                if (isCurrentPage) {
+                    e.preventDefault();
+                    updateCollapsed();
+                }
+                else {
+                    // When navigating to a new category, we always expand
+                    // see https://github.com/facebook/docusaurus/issues/10854#issuecomment-2609616182
+                    updateCollapsed(false);
+                }
+            }
+            else {
+                e.preventDefault();
+                updateCollapsed();
+            }
+        }
+    };
+    return (react_1.default.createElement("li", { className: (0, clsx_1.default)(theme_common_1.ThemeClassNames.docs.docSidebarItemCategory, theme_common_1.ThemeClassNames.docs.docSidebarItemCategoryLevel(level), 'menu__list-item', {
+            'menu__list-item--collapsed': collapsed,
+        }, className) },
+        react_1.default.createElement("div", { className: (0, clsx_1.default)('menu__list-item-collapsible', {
+                'menu__list-item-collapsible--active': isCurrentPage,
+            }) },
+            react_1.default.createElement(Link_1.default, { className: (0, clsx_1.default)(styles_module_css_1.default.categoryLink, 'menu__link', {
+                    'menu__link--sublist': collapsible,
+                    'menu__link--sublist-caret': !href && collapsible,
+                    'menu__link--active': isActive,
+                }), onClick: handleItemClick, "aria-current": isCurrentPage ? 'page' : undefined, role: collapsible && !href ? 'button' : undefined, "aria-expanded": collapsible && !href ? !collapsed : undefined, href: collapsible ? hrefWithSSRFallback ?? '#' : hrefWithSSRFallback, ...props },
+                react_1.default.createElement(CategoryLinkLabel, { label: label, taskStats: taskStats, isAnimatingCompletion: isAnimatingCompletion, isRemovingCheckmark: isRemovingCheckmark })),
+            href && collapsible && (react_1.default.createElement(CollapseButton, { collapsed: collapsed, categoryLabel: label, onClick: (e) => {
+                    e.preventDefault();
+                    updateCollapsed();
+                } }))),
+        react_1.default.createElement(theme_common_1.Collapsible, { lazy: true, as: "ul", className: "menu__list", collapsed: collapsed },
+            react_1.default.createElement(DocSidebarItems_1.default, { items: items, tabIndex: collapsed ? -1 : 0, onItemClick: onItemClick, activePath: activePath, level: level + 1 }))));
+}
+//# sourceMappingURL=index.js.map

package/lib/theme/DocSidebarItem/Category/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/theme/DocSidebarItem/Category/index.tsx"],"names":[],"mappings":"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"}

package/lib/theme/DocSidebarItem/Category/styles.module.css

@@ -0,0 +1,187 @@
+.categoryLink {
+  overflow: hidden;
+}
+
+:global(.menu__link--sublist-caret)::after {
+  margin-left: auto;
+  flex-shrink: 0;
+}
+
+.categoryLinkLabel {
+  flex: 1;
+  overflow: hidden;
+  display: -webkit-box;
+  line-clamp: 2;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+}
+
+/* Task progress badge styles for categories */
+.categoryWithTasks {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex: 1;
+  min-width: 0;
+}
+
+.categoryContent {
+  flex: 1;
+  min-width: 0;
+}
+
+.categoryBadge {
+  padding: 0.25rem 0.5rem;
+  border-radius: 4px;
+  font-weight: 700;
+  font-size: 0.75rem;
+  text-align: center;
+  white-space: nowrap;
+  min-width: 35px;
+  flex-shrink: 0;
+  transition: background-color 0.2s ease, color 0.2s ease;
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 25px;
+}
+
+.categoryBadgeAnimating {
+  animation: categoryBadgePulse 0.4s ease-out;
+}
+
+/* Badge number container */
+.categoryBadgeNumber {
+  position: absolute;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0;
+  transition: opacity 0.2s ease;
+}
+
+.categoryBadgeNumber.categoryBadgeNumberVisible {
+  opacity: 1;
+}
+
+.categoryBadgeNumber.categoryBadgeNumberRemoving {
+  animation: categoryNumberFadeOut 0.2s ease-out forwards;
+}
+
+/* Badge checkmark container */
+.categoryBadgeCheckmark {
+  position: absolute;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0;
+}
+
+.categoryBadgeCheckmark.categoryBadgeCheckmarkVisible {
+  opacity: 1;
+}
+
+.categoryBadgeCheckmark.categoryBadgeCheckmarkAnimating {
+  animation: categoryCheckmarkFadeIn 0.2s ease-out 0.2s forwards;
+}
+
+.categoryBadgeCheckmark.categoryBadgeCheckmarkRemoving {
+  animation: categoryCheckmarkFadeOut 0.2s ease-out forwards;
+}
+
+/* Add spacing only for sub-categories with ::after chevron */
+:global(.menu__link--sublist-caret) .categoryBadge {
+  margin-right: 15px;
+}
+
+.categoryBadgeIncomplete {
+  background-color: var(--task-badge-bg, var(--ifm-color-primary));
+  color: var(--task-badge-color, var(--ifm-color-primary-contrast-background));
+}
+
+.categoryBadgeComplete {
+  background-color: var(--task-badge-bg, var(--ifm-color-success));
+  color: var(--task-badge-color, var(--ifm-color-success-contrast-background));
+}
+
+/* Dark mode support via CSS custom properties */
+[data-theme="dark"] .categoryBadgeIncomplete {
+  background-color: var(
+    --task-badge-bg-dark,
+    var(--task-badge-bg, var(--ifm-color-primary))
+  );
+  color: var(
+    --task-badge-color-dark,
+    var(--task-badge-color, var(--ifm-color-primary-contrast-background))
+  );
+}
+
+[data-theme="dark"] .categoryBadgeComplete {
+  background-color: var(
+    --task-badge-bg-dark,
+    var(--task-badge-bg, var(--ifm-color-success))
+  );
+  color: var(
+    --task-badge-color-dark,
+    var(--task-badge-color, var(--ifm-color-success-contrast-background))
+  );
+}
+
+/* Keyframe animations */
+@keyframes categoryBadgePulse {
+  0% {
+    box-shadow: 0 0 0 0 var(--ifm-color-success);
+  }
+
+  50% {
+    box-shadow: 0 0 0 4px rgba(var(--ifm-color-success-rgb, 0, 200, 100), 0.4);
+  }
+
+  100% {
+    box-shadow: 0 0 0 0 rgba(var(--ifm-color-success-rgb, 0, 200, 100), 0);
+  }
+}
+
+@keyframes categoryNumberFadeOut {
+  0% {
+    opacity: 1;
+  }
+
+  100% {
+    opacity: 0;
+  }
+}
+
+@keyframes categoryCheckmarkFadeIn {
+  0% {
+    opacity: 0;
+  }
+
+  100% {
+    opacity: 1;
+  }
+}
+
+@keyframes categoryCheckmarkFadeOut {
+  0% {
+    opacity: 1;
+  }
+
+  100% {
+    opacity: 0;
+  }
+}
+
+/* Responsive adjustments */
+@media (max-width: 768px) {
+  .categoryWithTasks {
+    gap: 0.375rem;
+  }
+
+  .categoryBadge {
+    padding: 0.2rem 0.4rem;
+    font-size: 0.7rem;
+    min-width: 30px;
+  }
+}

package/lib/theme/DocSidebarItem/Html/index.d.ts

@@ -0,0 +1,4 @@
+import { type ReactNode } from 'react';
+import type { Props } from '@theme/DocSidebarItem/Html';
+export default function DocSidebarItemHtml({ item, level, index, }: Props): ReactNode;
+//# sourceMappingURL=index.d.ts.map

package/lib/theme/DocSidebarItem/Html/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/DocSidebarItem/Html/index.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,4BAA4B,CAAC;AAItD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EACzC,IAAI,EACJ,KAAK,EACL,KAAK,GACN,EAAE,KAAK,GAAG,SAAS,CAenB"}

package/lib/theme/DocSidebarItem/Html/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = DocSidebarItemHtml;
+const react_1 = __importDefault(require("react"));
+const clsx_1 = __importDefault(require("clsx"));
+const theme_common_1 = require("@docusaurus/theme-common");
+const styles_module_css_1 = __importDefault(require("./styles.module.css"));
+function DocSidebarItemHtml({ item, level, index, }) {
+    const { value, defaultStyle, className } = item;
+    return (react_1.default.createElement("li", { className: (0, clsx_1.default)(theme_common_1.ThemeClassNames.docs.docSidebarItemLink, theme_common_1.ThemeClassNames.docs.docSidebarItemLinkLevel(level), defaultStyle && [styles_module_css_1.default.menuHtmlItem, 'menu__list-item'], className), key: index, 
+        // eslint-disable-next-line react/no-danger
+        dangerouslySetInnerHTML: { __html: value } }));
+}
+//# sourceMappingURL=index.js.map

package/lib/theme/DocSidebarItem/Html/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/theme/DocSidebarItem/Html/index.tsx"],"names":[],"mappings":";;;;;AAOA,qCAmBC;AA1BD,kDAA4C;AAC5C,gDAAwB;AACxB,2DAAyD;AAGzD,4EAAyC;AAEzC,SAAwB,kBAAkB,CAAC,EACzC,IAAI,EACJ,KAAK,EACL,KAAK,GACC;IACN,MAAM,EAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAC,GAAG,IAAI,CAAC;IAC9C,OAAO,CACL,sCACE,SAAS,EAAE,IAAA,cAAI,EACb,8BAAe,CAAC,IAAI,CAAC,kBAAkB,EACvC,8BAAe,CAAC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,EACnD,YAAY,IAAI,CAAC,2BAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,EACxD,SAAS,CACV,EACD,GAAG,EAAE,KAAK;QACV,2CAA2C;QAC3C,uBAAuB,EAAE,EAAC,MAAM,EAAE,KAAK,EAAC,GACxC,CACH,CAAC;AACJ,CAAC"}

package/lib/theme/DocSidebarItem/Html/styles.module.css

@@ -0,0 +1,6 @@
+@media (min-width: 997px) {
+  .menuHtmlItem {
+    padding: var(--ifm-menu-link-padding-vertical)
+      var(--ifm-menu-link-padding-horizontal);
+  }
+}

package/lib/theme/DocSidebarItem/Link/index.d.ts

@@ -0,0 +1,6 @@
+import React, { type ReactNode } from 'react';
+import type { Props } from '@theme/DocSidebarItem/Link';
+declare function DocSidebarItemLink({ item, onItemClick, activePath, level, index, ...props }: Props): ReactNode;
+declare const _default: React.MemoExoticComponent<typeof DocSidebarItemLink>;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/lib/theme/DocSidebarItem/Link/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/DocSidebarItem/Link/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAC,KAAK,SAAS,EAA8B,MAAM,OAAO,CAAC;AAOzE,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,4BAA4B,CAAC;AAqBtD,iBAAS,kBAAkB,CAAC,EAC1B,IAAI,EACJ,WAAW,EACX,UAAU,EACV,KAAK,EACL,KAAK,EACL,GAAG,KAAK,EACT,EAAE,KAAK,GAAG,SAAS,CAuKnB;;AAGD,wBAA8C"}