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

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

@@ -0,0 +1,149 @@
+"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 });
+const react_1 = __importStar(require("react"));
+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 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"));
+function LinkLabel({ label }) {
+    return (react_1.default.createElement("span", { title: label, className: styles_module_css_1.default.linkLabel }, label));
+}
+function DocSidebarItemLink({ item, onItemClick, activePath, level, index, ...props }) {
+    const { href, label, className, autoAddBaseUrl, docId } = item;
+    const isActive = (0, client_1.isActiveSidebarItem)(item, activePath);
+    const isInternalLink = (0, isInternalUrl_1.default)(href);
+    // Get the correct plugin ID
+    const pluginId = (0, usePluginId_1.usePluginId)();
+    // Get task statistics for this doc
+    const stats = (0, useDocTaskStats_1.useDocTaskStats)(docId, pluginId);
+    const hasTasks = stats?.hasAnyTasks || false;
+    const isComplete = stats?.isComplete || false;
+    const badgeConfig = stats?.badgeConfig;
+    // Check if badge should be hidden
+    const hideBadge = (0, badgeStyles_1.shouldHideBadge)(badgeConfig);
+    const disableIcon = (0, badgeStyles_1.shouldDisableIcon)(badgeConfig);
+    // Animation tracking
+    const { hasAnimated, markAsAnimated } = (0, useTaskBadgeAnimation_1.useTaskBadgeAnimation)(pluginId, docId);
+    // 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]);
+    // If no tasks or badge is hidden, render standard link
+    if (!hasTasks || !stats || hideBadge) {
+        return (react_1.default.createElement("li", { className: (0, clsx_1.default)(theme_common_1.ThemeClassNames.docs.docSidebarItemLink, theme_common_1.ThemeClassNames.docs.docSidebarItemLinkLevel(level), 'menu__list-item', className), key: label },
+            react_1.default.createElement(Link_1.default, { className: (0, clsx_1.default)('menu__link', !isInternalLink && styles_module_css_1.default.menuExternalLink, {
+                    'menu__link--active': isActive,
+                }), autoAddBaseUrl: autoAddBaseUrl, "aria-current": isActive ? 'page' : undefined, to: href, ...(isInternalLink && {
+                    onClick: onItemClick ? () => onItemClick(item) : undefined,
+                }), ...props },
+                react_1.default.createElement(LinkLabel, { label: label }),
+                !isInternalLink && react_1.default.createElement(ExternalLink_1.default, null))));
+    }
+    // Render link with task progress
+    const badgeClass = isComplete ? styles_module_css_1.default.taskBadgeComplete : styles_module_css_1.default.taskBadgeIncomplete;
+    const badgeStyles = (0, badgeStyles_1.getBadgeStyles)(badgeConfig, isComplete);
+    // Show icon only if complete AND icon not disabled
+    const showIcon = isComplete && !disableIcon;
+    // Determine checkmark visibility classes
+    const checkmarkClasses = (0, clsx_1.default)(styles_module_css_1.default.taskBadgeCheckmark, {
+        [styles_module_css_1.default.taskBadgeCheckmarkVisible]: showIcon && !isAnimatingCompletion && !isRemovingCheckmark,
+        [styles_module_css_1.default.taskBadgeCheckmarkAnimating]: showIcon && isAnimatingCompletion,
+        [styles_module_css_1.default.taskBadgeCheckmarkRemoving]: isRemovingCheckmark,
+    });
+    // Determine number visibility classes
+    const numberClasses = (0, clsx_1.default)(styles_module_css_1.default.taskBadgeNumber, {
+        [styles_module_css_1.default.taskBadgeNumberVisible]: !showIcon || isRemovingCheckmark,
+        [styles_module_css_1.default.taskBadgeNumberRemoving]: showIcon && isAnimatingCompletion,
+    });
+    return (react_1.default.createElement("li", { className: (0, clsx_1.default)(theme_common_1.ThemeClassNames.docs.docSidebarItemLink, theme_common_1.ThemeClassNames.docs.docSidebarItemLinkLevel(level), 'menu__list-item', className), key: label },
+        react_1.default.createElement(Link_1.default, { className: (0, clsx_1.default)('menu__link', styles_module_css_1.default.linkWithTasks, !isInternalLink && styles_module_css_1.default.menuExternalLink, {
+                'menu__link--active': isActive,
+            }), autoAddBaseUrl: autoAddBaseUrl, "aria-current": isActive ? 'page' : undefined, to: href, ...(isInternalLink && {
+                onClick: onItemClick ? () => onItemClick(item) : undefined,
+            }), ...props },
+            react_1.default.createElement("div", { className: styles_module_css_1.default.linkContent },
+                stats.hasSectionName && (react_1.default.createElement("div", { className: styles_module_css_1.default.sectionName }, stats.sectionName)),
+                react_1.default.createElement(LinkLabel, { label: label })),
+            react_1.default.createElement("div", { className: (0, clsx_1.default)(styles_module_css_1.default.taskBadge, badgeClass, isAnimatingCompletion && styles_module_css_1.default.taskBadgeAnimating), style: badgeStyles },
+                react_1.default.createElement("span", { className: numberClasses },
+                    stats.completedTasks,
+                    "/",
+                    stats.totalTasks),
+                react_1.default.createElement("span", { className: checkmarkClasses }, icons_1.CHECKMARK_ICON)),
+            !isInternalLink && react_1.default.createElement(ExternalLink_1.default, null))));
+}
+// Memoize to prevent unnecessary re-renders
+exports.default = react_1.default.memo(DocSidebarItemLink);
+//# 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":"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"}

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

@@ -0,0 +1,197 @@
+.menuExternalLink {
+  align-items: center;
+}
+
+.linkLabel {
+  overflow: hidden;
+  display: -webkit-box;
+  line-clamp: 2;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+}
+
+/* Task progress badge styles */
+.linkWithTasks {
+  display: grid;
+  grid-template-columns: 1fr auto;
+  grid-template-areas: "content badge";
+  align-items: center;
+  gap: 0.5rem;
+  padding: var(--ifm-menu-link-padding-vertical)
+    var(--ifm-menu-link-padding-horizontal);
+}
+
+.linkContent {
+  grid-area: content;
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+  min-width: 0;
+}
+
+.sectionName {
+  font-weight: 700;
+  font-size: 0.75rem;
+  color: var(--ifm-color-emphasis-700);
+  line-height: 1.2;
+}
+
+.taskBadge {
+  grid-area: badge;
+  padding: 0.25rem 0.5rem;
+  border-radius: 4px;
+  font-weight: 700;
+  font-size: 0.75rem;
+  text-align: center;
+  white-space: nowrap;
+  min-width: 35px;
+  transition: background-color 0.2s ease, color 0.2s ease;
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 25px;
+}
+
+.taskBadgeAnimating {
+  animation: badgePulse 0.4s ease-out;
+}
+
+/* Badge number container */
+.taskBadgeNumber {
+  position: absolute;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0;
+  transition: opacity 0.2s ease;
+}
+
+.taskBadgeNumber.taskBadgeNumberVisible {
+  opacity: 1;
+}
+
+.taskBadgeNumber.taskBadgeNumberRemoving {
+  animation: numberFadeOut 0.2s ease-out forwards;
+}
+
+/* Badge checkmark container */
+.taskBadgeCheckmark {
+  position: absolute;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0;
+}
+
+.taskBadgeCheckmark.taskBadgeCheckmarkVisible {
+  opacity: 1;
+}
+
+.taskBadgeCheckmark.taskBadgeCheckmarkAnimating {
+  animation: checkmarkFadeIn 0.2s ease-out 0.2s forwards;
+}
+
+.taskBadgeCheckmark.taskBadgeCheckmarkRemoving {
+  animation: checkmarkFadeOut 0.2s ease-out forwards;
+}
+
+.taskBadgeIncomplete {
+  background-color: var(--task-badge-bg, var(--ifm-color-primary));
+  color: var(--task-badge-color, var(--ifm-color-primary-contrast-background));
+}
+
+.taskBadgeComplete {
+  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"] .taskBadgeIncomplete {
+  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"] .taskBadgeComplete {
+  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))
+  );
+}
+
+/* Dark mode adjustments */
+[data-theme="dark"] .sectionName {
+  color: var(--ifm-color-emphasis-600);
+}
+
+/* Keyframe animations */
+@keyframes badgePulse {
+  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 numberFadeOut {
+  0% {
+    opacity: 1;
+  }
+
+  100% {
+    opacity: 0;
+  }
+}
+
+@keyframes checkmarkFadeIn {
+  0% {
+    opacity: 0;
+  }
+
+  100% {
+    opacity: 1;
+  }
+}
+
+@keyframes checkmarkFadeOut {
+  0% {
+    opacity: 1;
+  }
+
+  100% {
+    opacity: 0;
+  }
+}
+
+/* Responsive adjustments */
+@media (max-width: 768px) {
+  .linkWithTasks {
+    gap: 0.375rem;
+  }
+
+  .sectionName {
+    font-size: 0.7rem;
+  }
+
+  .taskBadge {
+    padding: 0.2rem 0.4rem;
+    font-size: 0.7rem;
+    min-width: 30px;
+  }
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/DocSidebarItem/index.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAI5C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EAAC,IAAI,EAAE,GAAG,KAAK,EAAC,EAAE,KAAK,GAAG,SAAS,CAUzE"}

package/lib/theme/DocSidebarItem/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = DocSidebarItem;
+const react_1 = __importDefault(require("react"));
+const Category_1 = __importDefault(require("@theme/DocSidebarItem/Category"));
+const Link_1 = __importDefault(require("@theme/DocSidebarItem/Link"));
+const Html_1 = __importDefault(require("@theme/DocSidebarItem/Html"));
+function DocSidebarItem({ item, ...props }) {
+    switch (item.type) {
+        case 'category':
+            return react_1.default.createElement(Category_1.default, { item: item, ...props });
+        case 'html':
+            return react_1.default.createElement(Html_1.default, { item: item, ...props });
+        case 'link':
+        default:
+            return react_1.default.createElement(Link_1.default, { item: item, ...props });
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/theme/DocSidebarItem/index.tsx"],"names":[],"mappings":";;;;;AAMA,iCAUC;AAhBD,kDAA4C;AAC5C,8EAAoE;AACpE,sEAA4D;AAC5D,sEAA4D;AAG5D,SAAwB,cAAc,CAAC,EAAC,IAAI,EAAE,GAAG,KAAK,EAAQ;IAC5D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,8BAAC,kBAAsB,IAAC,IAAI,EAAE,IAAI,KAAM,KAAK,GAAI,CAAC;QAC3D,KAAK,MAAM;YACT,OAAO,8BAAC,cAAkB,IAAC,IAAI,EAAE,IAAI,KAAM,KAAK,GAAI,CAAC;QACvD,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,8BAAC,cAAkB,IAAC,IAAI,EAAE,IAAI,KAAM,KAAK,GAAI,CAAC;IACzD,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/DocSidebarItems/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAO,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAOlD,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,wBAAwB,CAAC;AAElD,iBAAS,eAAe,CAAC,EAAC,KAAK,EAAE,GAAG,KAAK,EAAC,EAAE,KAAK,GAAG,SAAS,CAS5D;;AAGD,wBAAqC"}

package/lib/theme/DocSidebarItems/index.js

@@ -0,0 +1,48 @@
+"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 });
+const react_1 = __importStar(require("react"));
+const client_1 = require("@docusaurus/plugin-content-docs/client");
+const DocSidebarItem_1 = __importDefault(require("@theme/DocSidebarItem"));
+function DocSidebarItems({ items, ...props }) {
+    const visibleItems = (0, client_1.useVisibleSidebarItems)(items, props.activePath);
+    return (react_1.default.createElement(client_1.DocSidebarItemsExpandedStateProvider, null, visibleItems.map((item, index) => (react_1.default.createElement(DocSidebarItem_1.default, { key: index, item: item, index: index, ...props })))));
+}
+// Optimize sidebar at each "level"
+exports.default = (0, react_1.memo)(DocSidebarItems);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/theme/DocSidebarItems/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAkD;AAClD,mEAGgD;AAChD,2EAAmD;AAInD,SAAS,eAAe,CAAC,EAAC,KAAK,EAAE,GAAG,KAAK,EAAQ;IAC/C,MAAM,YAAY,GAAG,IAAA,+BAAsB,EAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACrE,OAAO,CACL,8BAAC,6CAAoC,QAClC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CACjC,8BAAC,wBAAc,IAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,KAAM,KAAK,GAAI,CACpE,CAAC,CACmC,CACxC,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,kBAAe,IAAA,YAAI,EAAC,eAAe,CAAC,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * DocTaskCounterProvider Component
+ * Manages task auto-numbering within a doc page
+ */
+import { type ReactNode, type ReactElement } from 'react';
+export interface DocTaskCounterProviderProps {
+    children: ReactNode;
+}
+export declare function DocTaskCounterProvider({ children }: DocTaskCounterProviderProps): ReactElement;
+/**
+ * Hook to get the next task number for auto-numbering
+ * Must be called during render, not in effects or callbacks
+ */
+export declare function useTaskNumber(): number;
+/**
+ * Hook to get the next example number for task-example auto-numbering
+ * Must be called during render, not in effects or callbacks
+ */
+export declare function useTaskExampleNumber(): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/DocTaskCounterProvider/index.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAc,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EAKlB,MAAM,OAAO,CAAC;AAMf,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,EAAE,QAAQ,EAAE,EAAE,2BAA2B,GAAG,YAAY,CAoC9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAWtC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C"}

package/lib/theme/DocTaskCounterProvider/index.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * DocTaskCounterProvider Component
+ * Manages task auto-numbering within a doc page
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocTaskCounterProvider = DocTaskCounterProvider;
+exports.useTaskNumber = useTaskNumber;
+exports.useTaskExampleNumber = useTaskExampleNumber;
+const react_1 = __importStar(require("react"));
+const router_1 = require("@docusaurus/router");
+const DocTaskCounterContext = (0, react_1.createContext)(undefined);
+function DocTaskCounterProvider({ children }) {
+    const counterRef = (0, react_1.useRef)(0);
+    const exampleCounterRef = (0, react_1.useRef)(0);
+    const location = (0, router_1.useLocation)();
+    const getNextTaskNumber = (0, react_1.useCallback)(() => {
+        counterRef.current += 1;
+        return counterRef.current;
+    }, []);
+    const getNextExampleNumber = (0, react_1.useCallback)(() => {
+        exampleCounterRef.current += 1;
+        return exampleCounterRef.current;
+    }, []);
+    const resetCounter = (0, react_1.useCallback)(() => {
+        counterRef.current = 0;
+        exampleCounterRef.current = 0;
+    }, []);
+    const contextValue = {
+        getNextTaskNumber,
+        getNextExampleNumber,
+        resetCounter,
+    };
+    // Reset counter when location changes (page navigation)
+    react_1.default.useEffect(() => {
+        resetCounter();
+    }, [location.pathname, resetCounter]);
+    return (react_1.default.createElement(DocTaskCounterContext.Provider, { value: contextValue }, children));
+}
+/**
+ * Hook to get the next task number for auto-numbering
+ * Must be called during render, not in effects or callbacks
+ */
+function useTaskNumber() {
+    const context = (0, react_1.useContext)(DocTaskCounterContext);
+    if (!context) {
+        throw new Error('useTaskNumber must be used within a DocTaskCounterProvider');
+    }
+    // Get task number during render using useRef to maintain stability
+    const taskNumberRef = (0, react_1.useRef)(null);
+    if (taskNumberRef.current === null) {
+        taskNumberRef.current = context.getNextTaskNumber();
+    }
+    return taskNumberRef.current;
+}
+/**
+ * Hook to get the next example number for task-example auto-numbering
+ * Must be called during render, not in effects or callbacks
+ */
+function useTaskExampleNumber() {
+    const context = (0, react_1.useContext)(DocTaskCounterContext);
+    if (!context) {
+        throw new Error('useTaskExampleNumber must be used within a DocTaskCounterProvider');
+    }
+    // Get example number during render using useRef to maintain stability
+    const exampleNumberRef = (0, react_1.useRef)(null);
+    if (exampleNumberRef.current === null) {
+        exampleNumberRef.current = context.getNextExampleNumber();
+    }
+    return exampleNumberRef.current;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/theme/DocTaskCounterProvider/index.tsx"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBH,wDAoCC;AAMD,sCAWC;AAMD,oDAWC;AAvFD,+CAOe;AACf,+CAAiD;AAGjD,MAAM,qBAAqB,GAAG,IAAA,qBAAa,EAAyC,SAAS,CAAC,CAAC;AAM/F,SAAgB,sBAAsB,CAAC,EAAE,QAAQ,EAA+B;IAC9E,MAAM,UAAU,GAAG,IAAA,cAAM,EAAS,CAAC,CAAC,CAAC;IACrC,MAAM,iBAAiB,GAAG,IAAA,cAAM,EAAS,CAAC,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAA,oBAAW,GAAE,CAAC;IAE/B,MAAM,iBAAiB,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACzC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QACxB,OAAO,UAAU,CAAC,OAAO,CAAC;IAC5B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,oBAAoB,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC5C,iBAAiB,CAAC,OAAO,IAAI,CAAC,CAAC;QAC/B,OAAO,iBAAiB,CAAC,OAAO,CAAC;IACnC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,YAAY,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACpC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;QACvB,iBAAiB,CAAC,OAAO,GAAG,CAAC,CAAC;IAChC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,YAAY,GAAQ;QACxB,iBAAiB;QACjB,oBAAoB;QACpB,YAAY;KACb,CAAC;IAEF,wDAAwD;IACxD,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,YAAY,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAEtC,OAAO,CACL,8BAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,IAChD,QAAQ,CACsB,CAClC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,qBAAqB,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,mEAAmE;IACnE,MAAM,aAAa,GAAG,IAAA,cAAM,EAAgB,IAAI,CAAC,CAAC;IAClD,IAAI,aAAa,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACnC,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,aAAa,CAAC,OAAO,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,qBAAqB,CAAQ,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,sEAAsE;IACtE,MAAM,gBAAgB,GAAG,IAAA,cAAM,EAAgB,IAAI,CAAC,CAAC;IACrD,IAAI,gBAAgB,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACtC,gBAAgB,CAAC,OAAO,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAiB,CAAC;AAC5C,CAAC"}

package/lib/theme/MDXComponents.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MDXComponents wrapper
+ * Makes Task components available in MDX
+ *
+ * NOTE: Users don't write <Task>, <Text>, <Hint>, <Solution> directly in MDX.
+ * Instead, they write directive syntax (:::task[Name]) which is transformed
+ * by our remark plugin into these JSX components during compilation.
+ *
+ * These components must still be exported here so they're available when
+ * the transformed JSX is rendered.
+ *
+ * TaskProgression, TaskProgressionOverview, and TaskPlaceholder ARE used directly by users.
+ *
+ * CRITICAL FIX: Import Code and Pre directly from theme-classic to avoid circular resolution
+ * when DocRoot uses direct imports (which breaks the @theme-original chain).
+ */
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=MDXComponents.d.ts.map

package/lib/theme/MDXComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MDXComponents.d.ts","sourceRoot":"","sources":["../../src/theme/MDXComponents.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;;AAiBH,wBAgBE"}