@widlarzgroup/docusaurus-ui 0.0.1

package/lib/theme/DocItem/TOC/Desktop/index.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = DocItemTOCDesktop;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const theme_common_1 = require("@docusaurus/theme-common");
+const client_1 = require("@docusaurus/plugin-content-docs/client");
+const TOC_1 = __importDefault(require("@theme/TOC"));
+function DocItemTOCDesktop() {
+    const { toc, frontMatter } = (0, client_1.useDoc)();
+    return ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: (0, jsx_runtime_1.jsx)(TOC_1.default, { toc: toc, minHeadingLevel: frontMatter.toc_min_heading_level, maxHeadingLevel: frontMatter.toc_max_heading_level, className: theme_common_1.ThemeClassNames.docs.docTocDesktop }) }));
+}
+//# sourceMappingURL=index.js.map

package/lib/theme/DocItem/TOC/Desktop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/theme/DocItem/TOC/Desktop/index.tsx"],"names":[],"mappings":";;;;;AAOA,oCAaC;;AAnBD,2DAAyD;AACzD,mEAA8D;AAE9D,qDAA6B;AAG7B,SAAwB,iBAAiB;IACvC,MAAM,EAAC,GAAG,EAAE,WAAW,EAAC,GAAG,IAAA,eAAM,GAAE,CAAC;IACpC,OAAO,CACL,2DACE,uBAAC,aAAG,IACF,GAAG,EAAE,GAAG,EACR,eAAe,EAAE,WAAW,CAAC,qBAAqB,EAClD,eAAe,EAAE,WAAW,CAAC,qBAAqB,EAClD,SAAS,EAAE,8BAAe,CAAC,IAAI,CAAC,aAAa,GAC7C,GAED,CACJ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+import { type ReactNode } from 'react';
+import type { Props } from '@theme/DocSidebarItem/Category';
+import type { WithCustomProps } from '../../../types/sidebar';
+export default function DocSidebarItemCategory(props: WithCustomProps<Props>): ReactNode;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/DocSidebarItem/Category/index.tsx"],"names":[],"mappings":"AAAA,OAAc,EAEZ,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAqBf,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAG5D,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AAiIzB,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,GAC5B,SAAS,CAUX"}

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

@@ -0,0 +1,224 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = DocSidebarItemCategory;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = 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-original/DocSidebarItems"));
+const Link_2 = __importDefault(require("@theme-original/DocSidebarItem/Link"));
+const ProBadge_1 = __importDefault(require("../../../components/ProBadge/ProBadge"));
+const StatusBadge_1 = __importDefault(require("../../../components/StatusBadge/StatusBadge"));
+const styles_module_css_1 = __importDefault(require("./styles.module.css"));
+// 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 ((0, jsx_runtime_1.jsx)("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, isRootCategory, customProps, }) {
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("span", { title: label, className: (0, clsx_1.default)(styles_module_css_1.default.categoryLinkLabel, {
+                    [styles_module_css_1.default.categoryLinkLabelRoot]: isRootCategory,
+                    [styles_module_css_1.default.categoryLinkLabelNested]: !isRootCategory,
+                }), children: label }), customProps?.plan === 'pro' && (0, jsx_runtime_1.jsx)(ProBadge_1.default, {}), customProps?.badgeType && (0, jsx_runtime_1.jsx)(StatusBadge_1.default, { type: customProps.badgeType })] }));
+}
+function DocSidebarItemCategory(props) {
+    const visibleChildren = (0, client_1.useVisibleSidebarItems)(props.item.items, props.activePath);
+    if (visibleChildren.length === 0) {
+        return (0, jsx_runtime_1.jsx)(DocSidebarItemCategoryEmpty, { ...props });
+    }
+    else {
+        return (0, jsx_runtime_1.jsx)(DocSidebarItemCategoryCollapsible, { ...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: _type, collapsed: _collapsed, collapsible: _collapsible, items: _items, linkUnlisted: _linkUnlisted, ...forwardableProps } = item;
+    const linkItem = {
+        type: 'link',
+        ...forwardableProps,
+    };
+    return (0, jsx_runtime_1.jsx)(Link_2.default, { item: linkItem, ...props });
+}
+function DocSidebarItemCategoryCollapsible({ item, onItemClick, activePath, level, index, ...props }) {
+    const { items, label, collapsible, className, href, customProps } = 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);
+    // Root categories (level === 1) are always expanded and non-collapsible
+    const isRootCategory = level === 1;
+    const { collapsed, setCollapsed } = (0, theme_common_1.useCollapsible)({
+        // Root categories (level === 1) are always expanded
+        // Level 2 categories respect the collapsed prop from sidebars.ts
+        // Deeper nested categories (level > 2) are collapsed by default, unless they are active
+        initialState: () => {
+            if (isRootCategory) {
+                return false; // Always expanded for root categories
+            }
+            if (!collapsible) {
+                return false;
+            }
+            // Level 2 categories: respect the collapsed prop from sidebars.ts
+            if (level === 2) {
+                return item.collapsed ?? false; // Use sidebar config, default to open
+            }
+            // Deeper nested categories (level > 2): only expand if active, otherwise collapse
+            return isActive ? false : true;
+        },
+    });
+    const { expandedItem, setExpandedItem } = (0, client_1.useDocSidebarItemsExpandedState)();
+    // Use this instead of `setCollapsed`, because it is also reactive
+    const updateCollapsed = (toCollapsed = !collapsed) => {
+        // Root categories cannot be collapsed
+        if (isRootCategory) {
+            return;
+        }
+        setExpandedItem(toCollapsed ? null : index);
+        setCollapsed(toCollapsed);
+    };
+    // Only auto-expand for nested categories, not root
+    // We need to call the hook unconditionally (React rules), but make it a no-op for root categories
+    useAutoExpandActiveCategory({
+        isActive: isActive && !isRootCategory,
+        collapsed: isRootCategory ? false : collapsed,
+        updateCollapsed: isRootCategory ? () => { } : updateCollapsed,
+        activePath,
+    });
+    (0, react_1.useEffect)(() => {
+        // Root categories should never collapse - always keep them expanded
+        if (isRootCategory) {
+            setCollapsed(false);
+            return;
+        }
+        // Auto-collapse when other categories expand (only if autoCollapseCategories is enabled)
+        if (collapsible &&
+            expandedItem != null &&
+            expandedItem !== index &&
+            autoCollapseCategories) {
+            setCollapsed(true);
+        }
+    }, [
+        collapsible,
+        expandedItem,
+        index,
+        setCollapsed,
+        autoCollapseCategories,
+        isRootCategory,
+    ]);
+    const handleItemClick = (e) => {
+        onItemClick?.(item);
+        // Root categories cannot be collapsed, so skip collapse logic
+        if (isRootCategory) {
+            return;
+        }
+        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();
+            }
+        }
+    };
+    // Dynamic indent for nested categories (level 3+)
+    const nestedIndent = level >= 3 ? (level - 2) * 0.05 : 0;
+    return ((0, jsx_runtime_1.jsxs)("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,
+            [styles_module_css_1.default.rootCategoryContainer]: isRootCategory,
+        }, className), children: [(0, jsx_runtime_1.jsx)("div", { className: (0, clsx_1.default)('menu__list-item-collapsible', {
+                    'menu__list-item-collapsible--active': isCurrentPage,
+                }), children: (0, jsx_runtime_1.jsxs)(Link_1.default, { className: (0, clsx_1.default)(styles_module_css_1.default.categoryLink, 'menu__link', {
+                        [styles_module_css_1.default.categoryLinkRoot]: isRootCategory,
+                        'menu__link--sublist': collapsible && !isRootCategory,
+                        'menu__link--sublist-caret': !href && collapsible && !isRootCategory,
+                        'menu__link--active': isActive,
+                    }), style: nestedIndent > 0
+                        ? { paddingLeft: `${nestedIndent + 0.5}rem` }
+                        : undefined, onClick: handleItemClick, "aria-current": isCurrentPage ? 'page' : undefined, role: collapsible && !href && !isRootCategory ? 'button' : undefined, "aria-expanded": collapsible && !href && !isRootCategory ? !collapsed : undefined, href: collapsible && !isRootCategory
+                        ? (hrefWithSSRFallback ?? '#')
+                        : hrefWithSSRFallback, ...props, children: [href && collapsible && !isRootCategory && ((0, jsx_runtime_1.jsx)(CollapseButton, { collapsed: collapsed, categoryLabel: label, onClick: (e) => {
+                                e.preventDefault();
+                                updateCollapsed();
+                            } })), (0, jsx_runtime_1.jsx)(CategoryLinkLabel, { label: label, isRootCategory: isRootCategory, customProps: customProps })] }) }), (0, jsx_runtime_1.jsx)(theme_common_1.Collapsible, { lazy: true, as: "ul", className: (0, clsx_1.default)('menu__list', isRootCategory && styles_module_css_1.default.categoryList), collapsed: collapsed, children: (0, jsx_runtime_1.jsx)(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,119 @@
+.categoryLink {
+  overflow: hidden;
+  display: flex;
+  align-items: center;
+  padding-left: 0;
+  gap: 0.1;
+  position: relative;
+}
+
+.categoryLink::after {
+  order: -1;
+  margin-left: 1rem;
+  min-width: 1rem;
+  width: 1rem;
+  height: 1rem;
+  flex-shrink: 0;
+  background-size: contain;
+}
+
+.categoryLinkLabel {
+  overflow: hidden;
+  display: -webkit-box;
+  line-clamp: 2;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  color: var(--color-text-primary);
+}
+
+.categoryLinkRoot {
+  padding-left: 1.5rem;
+}
+
+/* Root category container with full-height border */
+.rootCategoryContainer {
+  position: relative;
+  margin-left: 1rem;
+}
+
+/* Circle outline at the top */
+.rootCategoryContainer::before {
+  content: '';
+  position: absolute;
+  left: calc(0.5rem - 4px);
+  top: 0.85rem;
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  border: 1px solid var(--ifm-toc-border-color);
+  background-color: var(--ifm-background-color);
+  z-index: 2;
+  pointer-events: none;
+  transition: border-color 0.15s ease, background-color 0.15s ease;
+}
+
+/* Circle outline turns blue on hover */
+.rootCategoryContainer:has(> :global(.menu__list-item-collapsible) > :global(.menu__link):hover)::before {
+  border-color: var(--ifm-color-primary-light);
+}
+
+/* Circle outline turns blue when category has active item */
+.rootCategoryContainer:has(:global(.menu__link--active))::before {
+  border-color: var(--ifm-color-primary-light);
+}
+
+/* Vertical line starting from the circle */
+.rootCategoryContainer::after {
+  content: '';
+  position: absolute;
+  left: 0.5rem;
+  top: calc(0.85rem + 8px);
+  bottom: 0;
+  width: 1px;
+  background-color: var(--ifm-toc-border-color);
+  z-index: 1;
+  pointer-events: none;
+}
+
+.categoryLinkLabelRoot {
+  font-size: 1rem;
+  font-weight: 600;
+}
+
+.categoryLinkLabelNested {
+  font-size: 0.85rem;
+  font-weight: 500;
+}
+
+.categoryList {
+  position: relative;
+  margin-left: 0;
+  padding-left: 0;
+}
+
+/* Reset margin for nested lists inside root category */
+.categoryList :global(.menu__list) {
+  margin-left: 0;
+  padding-left: 0;
+}
+
+/* Border indicator on nested items only (not on root category link itself) */
+.rootCategoryContainer .categoryList :global(.menu__link) {
+  position: relative;
+}
+
+.rootCategoryContainer .categoryList :global(.menu__link)::before {
+  content: '';
+  position: absolute;
+  left: 0.5rem;
+  top: 0;
+  bottom: 0;
+  width: 2px;
+  background-color: transparent;
+  z-index: 2;
+  transition: background-color 0.15s ease;
+}
+
+.rootCategoryContainer .categoryList :global(.menu__link:hover)::before {
+  background-color: var(--ifm-color-primary-light);
+}

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

@@ -0,0 +1,5 @@
+import { type ReactNode } from 'react';
+import type { Props } from '@theme/DocSidebarItem/Link';
+import type { WithCustomProps } from '../../../types/sidebar';
+export default function DocSidebarItemLink({ item, onItemClick, activePath, level, index: _index, ...props }: WithCustomProps<Props>): ReactNode;
+//# 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,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAO9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAGxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAYvD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EACzC,IAAI,EACJ,WAAW,EACX,UAAU,EACV,KAAK,EACL,KAAK,EAAE,MAAM,EACb,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,SAAS,CAuDpC"}

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

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = DocSidebarItemLink;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const clsx_1 = __importDefault(require("clsx"));
+const theme_common_1 = require("@docusaurus/theme-common");
+const client_1 = require("@docusaurus/plugin-content-docs/client");
+const Link_1 = __importDefault(require("@docusaurus/Link"));
+const isInternalUrl_1 = __importDefault(require("@docusaurus/isInternalUrl"));
+const ExternalLink_1 = __importDefault(require("@theme/Icon/ExternalLink"));
+const ProBadge_1 = __importDefault(require("../../../components/ProBadge/ProBadge"));
+const StatusBadge_1 = __importDefault(require("../../../components/StatusBadge/StatusBadge"));
+const styles_module_css_1 = __importDefault(require("./styles.module.css"));
+function LinkLabel({ label }) {
+    return ((0, jsx_runtime_1.jsx)("span", { title: label, className: styles_module_css_1.default.linkLabel, children: label }));
+}
+function DocSidebarItemLink({ item, onItemClick, activePath, level, index: _index, ...props }) {
+    const { href, label, className, autoAddBaseUrl, customProps } = item;
+    const isActive = (0, client_1.isActiveSidebarItem)(item, activePath);
+    const isInternalLink = (0, isInternalUrl_1.default)(href);
+    const isLink = item.type === 'link';
+    // Dynamic indent for nested items (level 3+)
+    const nestedIndent = level >= 3 ? (level - 2) * 0.05 : 0;
+    return ((0, jsx_runtime_1.jsx)("li", { className: (0, clsx_1.default)(theme_common_1.ThemeClassNames.docs.docSidebarItemLink, theme_common_1.ThemeClassNames.docs.docSidebarItemLinkLevel(level), 'menu__list-item', className), children: (0, jsx_runtime_1.jsxs)(Link_1.default, { className: (0, clsx_1.default)('menu__link', styles_module_css_1.default.menuLink, !isInternalLink && styles_module_css_1.default.menuExternalLink, {
+                'menu__link--active': isActive,
+            }), style: nestedIndent > 0
+                ? { paddingLeft: `${nestedIndent + 2.5}rem` }
+                : undefined, autoAddBaseUrl: autoAddBaseUrl, "aria-current": isActive ? 'page' : undefined, to: href, ...(isInternalLink && {
+                onClick: onItemClick ? () => onItemClick(item) : undefined,
+            }), ...props, children: [(0, jsx_runtime_1.jsx)(LinkLabel, { label: label }), !isInternalLink && (0, jsx_runtime_1.jsx)(ExternalLink_1.default, {}), isLink && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [customProps?.plan === 'pro' && (0, jsx_runtime_1.jsx)(ProBadge_1.default, {}), customProps?.badgeType && ((0, jsx_runtime_1.jsx)(StatusBadge_1.default, { type: customProps.badgeType }))] }))] }) }, label));
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/theme/DocSidebarItem/Link/index.tsx"],"names":[],"mappings":";;;;;AAsBA,qCA8DC;;AAnFD,gDAAwB;AACxB,2DAA2D;AAC3D,mEAA6E;AAC7E,4DAAoC;AACpC,8EAAsD;AACtD,4EAAwD;AAExD,8EAAsD;AACtD,uFAA+D;AAG/D,4EAAyC;AAEzC,SAAS,SAAS,CAAC,EAAE,KAAK,EAAqB;IAC7C,OAAO,CACL,iCAAM,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,2BAAM,CAAC,SAAS,YAC5C,KAAK,GACD,CACR,CAAC;AACJ,CAAC;AAED,SAAwB,kBAAkB,CAAC,EACzC,IAAI,EACJ,WAAW,EACX,UAAU,EACV,KAAK,EACL,KAAK,EAAE,MAAM,EACb,GAAG,KAAK,EACe;IACvB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAA,4BAAmB,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,IAAA,uBAAa,EAAC,IAAI,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;IAEpC,6CAA6C;IAC7C,MAAM,YAAY,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,OAAO,CACL,+BACE,SAAS,EAAE,IAAA,cAAI,EACb,8BAAe,CAAC,IAAI,CAAC,kBAAkB,EACvC,8BAAe,CAAC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,EACnD,iBAAiB,EACjB,SAAS,CACV,YAGD,wBAAC,cAAI,IACH,SAAS,EAAE,IAAA,cAAI,EACb,YAAY,EACZ,2BAAM,CAAC,QAAQ,EACf,CAAC,cAAc,IAAI,2BAAM,CAAC,gBAAgB,EAC1C;gBACE,oBAAoB,EAAE,QAAQ;aAC/B,CACF,EACD,KAAK,EACH,YAAY,GAAG,CAAC;gBACd,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,GAAG,KAAK,EAAE;gBAC7C,CAAC,CAAC,SAAS,EAEf,cAAc,EAAE,cAAc,kBAChB,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAC3C,EAAE,EAAE,IAAI,KACJ,CAAC,cAAc,IAAI;gBACrB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D,CAAC,KACE,KAAK,aAET,uBAAC,SAAS,IAAC,KAAK,EAAE,KAAK,GAAI,EAC1B,CAAC,cAAc,IAAI,uBAAC,sBAAgB,KAAG,EACvC,MAAM,IAAI,CACT,6DACG,WAAW,EAAE,IAAI,KAAK,KAAK,IAAI,uBAAC,kBAAQ,KAAG,EAC3C,WAAW,EAAE,SAAS,IAAI,CACzB,uBAAC,qBAAW,IAAC,IAAI,EAAE,WAAW,CAAC,SAAS,GAAI,CAC7C,IACA,CACJ,IACI,IAlCF,KAAK,CAmCP,CACN,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+.menuExternalLink {
+  align-items: center;
+}
+
+.menuLink {
+  padding-left: 2rem;
+  padding-top: 0.25rem;
+  padding-bottom: 0.25rem;
+}
+
+.linkLabel {
+  overflow: hidden;
+  display: -webkit-box;
+  line-clamp: 2;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  font-size: 0.8rem;
+}

package/lib/theme/TOC/index.d.ts

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

package/lib/theme/TOC/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/TOC/index.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AAUtC,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAC,SAAS,EAAE,GAAG,KAAK,EAAC,EAAE,KAAK,GAAG,SAAS,CAWnE"}

package/lib/theme/TOC/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = TOC;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const clsx_1 = __importDefault(require("clsx"));
+const TOCItems_1 = __importDefault(require("@theme/TOCItems"));
+const styles_module_css_1 = __importDefault(require("./styles.module.css"));
+const TWGBadge_1 = __importDefault(require("../../components/TWGBadge/TWGBadge"));
+// Using a custom className
+// This prevents TOCInline/TOCCollapsible getting highlighted by mistake
+const LINK_CLASS_NAME = 'table-of-contents__link toc-highlight';
+const LINK_ACTIVE_CLASS_NAME = 'table-of-contents__link--active';
+function TOC({ className, ...props }) {
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, clsx_1.default)(styles_module_css_1.default.tableOfContents, 'thin-scrollbar', className), children: [(0, jsx_runtime_1.jsx)(TOCItems_1.default, { ...props, linkClassName: LINK_CLASS_NAME, linkActiveClassName: LINK_ACTIVE_CLASS_NAME }), (0, jsx_runtime_1.jsx)(TWGBadge_1.default, { visibleOnLarge: true })] }));
+}
+//# sourceMappingURL=index.js.map

package/lib/theme/TOC/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/theme/TOC/index.tsx"],"names":[],"mappings":";;;;;AAaA,sBAWC;;AAvBD,gDAAwB;AACxB,+DAAuC;AAGvC,4EAAyC;AACzC,8EAAsD;AAEtD,2BAA2B;AAC3B,wEAAwE;AACxE,MAAM,eAAe,GAAG,uCAAuC,CAAC;AAChE,MAAM,sBAAsB,GAAG,iCAAiC,CAAC;AAEjE,SAAwB,GAAG,CAAC,EAAC,SAAS,EAAE,GAAG,KAAK,EAAQ;IACtD,OAAO,CACL,iCAAK,SAAS,EAAE,IAAA,cAAI,EAAC,2BAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,SAAS,CAAC,aACvE,uBAAC,kBAAQ,OACH,KAAK,EACT,aAAa,EAAE,eAAe,EAC9B,mBAAmB,EAAE,sBAAsB,GAC3C,EACF,uBAAC,kBAAQ,IAAC,cAAc,EAAE,IAAI,GAAI,IAC9B,CACP,CAAC;AACJ,CAAC"}

package/lib/theme/TOC/styles.module.css

@@ -0,0 +1,16 @@
+.tableOfContents {
+  max-height: calc(100vh - (var(--ifm-navbar-height) + 2rem));
+  overflow-y: auto;
+  position: sticky;
+  top: calc(var(--ifm-navbar-height) + 1rem);
+}
+
+@media (max-width: 996px) {
+  .tableOfContents {
+    display: none;
+  }
+
+  .docItemContainer {
+    padding: 0 0.3rem;
+  }
+}

package/lib/types/sidebar.d.ts

@@ -0,0 +1,17 @@
+import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
+export interface CustomSidebarProps {
+    plan?: 'pro';
+    badgeType?: 'planned' | 'new';
+}
+export type AddCustomProps<T> = T extends readonly (infer U)[] ? Array<AddCustomProps<U>> : T extends object ? Omit<{
+    [K in keyof T]: AddCustomProps<T[K]>;
+}, 'customProps'> & {
+    customProps?: CustomSidebarProps;
+} : T;
+export type TypedSidebarsConfig = AddCustomProps<SidebarsConfig>;
+export type WithCustomProps<Props extends {
+    item: unknown;
+}> = Omit<Props, 'item'> & {
+    item: AddCustomProps<Props['item']> & Props['item'];
+};
+//# sourceMappingURL=sidebar.d.ts.map

package/lib/types/sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/types/sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC1D,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACxB,CAAC,SAAS,MAAM,GACd,IAAI,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,EAAE,aAAa,CAAC,GAAG;IAC9D,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC,GACD,CAAC,CAAC;AAER,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEjE,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,IAAI,IAAI,CACjE,KAAK,EACL,MAAM,CACP,GAAG;IACF,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;CACrD,CAAC"}

package/lib/types/sidebar.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sidebar.js.map

package/lib/types/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../../src/types/sidebar.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@widlarzgroup/docusaurus-ui",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "require": "./lib/index.js",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "scripts": {
+    "swizzle": "docusaurus swizzle",
+    "dev": "bun run build && tsc-watch -p tsconfig.build.json --onSuccess 'tsc-alias -p tsconfig.build.json && bun run copy-assets'",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && bun run copy-assets",
+    "copy-assets": "find src -name '*.css' -exec sh -c 'mkdir -p lib/$(dirname ${1#src/}) && cp $1 lib/${1#src/}' _ {} \\;",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@docusaurus/tsconfig": "^3.9.2",
+    "@docusaurus/types": "^3.9.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "tsc-alias": "^1.8.16",
+    "tsc-watch": "^6.2.0"
+  },
+  "peerDependencies": {
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/theme-classic": "^3.9.2",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  }
+}

package/src/components/PlatformsList/PlatformsList.module.css

@@ -0,0 +1,10 @@
+.paragraphStyle {
+  margin-top: 10;
+}
+
+.spanStyle {
+  font-family: "Orbitron", sans-serif;
+  font-optical-sizing: auto;
+  font-weight: 800;
+  font-style: normal;
+}

package/src/components/PlatformsList/PlatformsList.tsx

@@ -0,0 +1,28 @@
+import React from 'react';
+import styles from './PlatformsList.module.css';
+
+type Platform =
+  | 'Android'
+  | 'iOS'
+  | 'visionOS'
+  | 'tvOS'
+  | 'Windows UWP'
+  | 'Web'
+  | 'All';
+
+interface Platforms {
+  types: Platform[];
+}
+
+function PlatformsList({ types }: Platforms) {
+  return (
+    <p className={styles.paragraphStyle}>
+      {types.length === 1 && !types.includes('All')
+        ? 'Platform:'
+        : 'Platforms:'}
+      <span className={styles.spanStyle}>{' ' + types.join(' | ')}</span>
+    </p>
+  );
+}
+
+export default PlatformsList;

package/src/components/PlusBadge/PlusBadge.module.css

@@ -0,0 +1,17 @@
+.badge {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 18px;
+  height: 18px;
+  margin-left: 6px;
+  background: linear-gradient(135deg, var(--color-accent) 0%, var(--color-accent-dim) 100%);
+  border-radius: 4px;
+  vertical-align: middle;
+}
+
+.icon {
+  color: var(--color-bg-primary);
+  flex-shrink: 0;
+}
+