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

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

@@ -0,0 +1,529 @@
+/* ===================== TASK COMPONENT ===================== */
+
+.taskContainer {
+  margin-bottom: 1.5rem;
+  border: 2px solid var(--ifm-color-emphasis-300);
+  border-radius: 8px;
+  background-color: var(--ifm-background-surface-color);
+  transition: border-color 0.2s ease, box-shadow 0.2s ease,
+    max-height 0.3s ease-out;
+  overflow: hidden;
+}
+
+.taskContainer:hover {
+  border-color: var(--ifm-color-emphasis-500);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+.taskCompleted {
+  border-color: var(--ifm-color-success);
+  /* background-color: var(--ifm-color-success-contrast-background); */
+}
+
+.taskCompletedAnimating {
+  animation: borderPulse 0.6s ease-out;
+}
+
+@keyframes borderPulse {
+  0%,
+  100% {
+    box-shadow: 0 0 0 0 var(--ifm-color-success-lightest);
+  }
+
+  50% {
+    box-shadow: 0 0 0 8px var(--ifm-color-success-lightest);
+  }
+}
+
+.taskCompleted:hover {
+  border-color: var(--ifm-color-success-dark);
+}
+
+/* ===================== TASK HEADER ===================== */
+
+.taskHeader {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1rem 1.25rem;
+  cursor: pointer;
+  user-select: none;
+  position: relative;
+  background: var(--ifm-background-surface-color);
+  transition: background 0.3s ease;
+}
+
+.taskHeader::before {
+  content: "";
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: linear-gradient(
+    to bottom,
+    var(--ifm-color-emphasis-200) 0%,
+    transparent 80%
+  );
+  opacity: 0;
+  transition: opacity 0.3s ease;
+  pointer-events: none;
+  z-index: 0;
+}
+
+.taskHeader:hover::before {
+  opacity: 1;
+}
+
+.taskHeaderLeft {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  flex: 1;
+  min-width: 0;
+  position: relative;
+  z-index: 1;
+}
+
+.taskBadge {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.25rem 0.625rem;
+  font-size: 0.75rem;
+  font-weight: 500;
+  color: var(--ifm-color-primary);
+  background-color: var(--ifm-color-emphasis-200);
+  border-radius: 4px;
+  border: 1px solid var(--ifm-color-emphasis-300);
+  white-space: nowrap;
+  flex-shrink: 0;
+}
+
+.taskName {
+  margin: 0;
+  font-size: 1.1rem;
+  font-weight: 600;
+  color: var(--ifm-font-color-base);
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex: 1;
+  min-width: 0;
+  margin-bottom: 1px;
+  transition: color 0.6s ease-out;
+}
+
+.taskCompleted .taskName {
+  color: var(--ifm-color-success);
+}
+
+.checkmark {
+  display: inline-flex;
+  align-items: center;
+  color: var(--ifm-color-success);
+  flex-shrink: 0;
+  /* Always hidden by default */
+  opacity: 0;
+  transform: scale(0);
+}
+
+.checkmarkVisible {
+  /* Static visible state (when completed but not animating) */
+  opacity: 1;
+  transform: scale(1);
+}
+
+.checkmarkAnimating {
+  animation: checkmarkPop 0.6s ease-out forwards;
+}
+
+.checkmarkRemoving {
+  animation: checkmarkZoomOut 0.6s ease-out forwards;
+}
+
+@keyframes checkmarkPop {
+  0% {
+    transform: scale(0);
+    opacity: 0;
+  }
+
+  50% {
+    transform: scale(1.2);
+    opacity: 1;
+  }
+
+  100% {
+    transform: scale(1);
+    opacity: 1;
+  }
+}
+
+@keyframes checkmarkZoomOut {
+  0% {
+    transform: scale(1);
+    opacity: 1;
+  }
+
+  100% {
+    transform: scale(0);
+    opacity: 0;
+  }
+}
+
+.expandButton {
+  background: none;
+  border: none;
+  padding: 0.25rem;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--ifm-color-emphasis-700);
+  transition: color 0.2s ease;
+  flex-shrink: 0;
+  position: relative;
+  z-index: 1;
+}
+
+.expandButton:hover {
+  color: var(--ifm-color-primary);
+}
+
+.chevron {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: transform 0.2s ease;
+  color: currentColor;
+}
+
+.chevronCollapsed {
+  transform: rotate(-90deg);
+}
+
+/* ===================== TASK BODY ===================== */
+
+.taskBody {
+  padding: 0 1.25rem 1rem 1.25rem;
+  animation: slideDown 0.3s ease-out;
+  overflow: hidden;
+}
+
+.taskBodyCollapsing {
+  animation: slideUp 0.3s ease-out;
+}
+
+@keyframes slideDown {
+  from {
+    opacity: 0;
+    max-height: 0;
+    transform: translateY(-8px);
+  }
+
+  to {
+    opacity: 1;
+    max-height: 2000px;
+    transform: translateY(0);
+  }
+}
+
+@keyframes slideUp {
+  from {
+    opacity: 1;
+    max-height: 2000px;
+    transform: translateY(0);
+  }
+
+  to {
+    opacity: 0;
+    max-height: 0;
+    transform: translateY(-8px);
+  }
+}
+
+/* ===================== TASK FOOTER ===================== */
+
+.taskFooter {
+  padding: 1rem 1.25rem 1rem 1.25rem;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+  position: relative;
+  animation: slideDown 0.3s ease-out;
+  overflow: hidden;
+}
+
+.taskFooterCollapsing {
+  animation: slideUp 0.3s ease-out;
+}
+
+.taskFooter::before {
+  content: "";
+  position: absolute;
+  top: 0;
+  left: 1.25rem;
+  right: 1.25rem;
+  height: 1px;
+  background: linear-gradient(
+    to right,
+    transparent,
+    var(--ifm-color-emphasis-300) 20%,
+    var(--ifm-color-emphasis-300) 80%,
+    transparent
+  );
+  margin-bottom: 1rem;
+}
+
+.taskActions {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex: 1;
+}
+
+.taskButton {
+  padding: 0.5rem 1rem;
+  font-size: 0.875rem;
+  font-weight: 600;
+  border-radius: 6px;
+  border: 1.5px solid;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  background: var(--ifm-background-surface-color);
+  white-space: nowrap;
+}
+
+/* Hint Button (Warning) */
+.hintButton {
+  border-color: var(--ifm-color-warning-darker);
+  color: var(--ifm-color-warning-darkest);
+  font-weight: 600;
+}
+
+.hintButton:hover {
+  background: var(--ifm-color-warning-contrast-background);
+  border-color: var(--ifm-color-warning-darkest);
+}
+
+.hintButton.active {
+  background: var(--ifm-color-warning-darker);
+  color: var(--ifm-color-secondary-contrast-background);
+}
+
+/* Solution Button (Info) */
+.solutionButton {
+  border-color: var(--ifm-color-info-darker);
+  color: var(--ifm-color-info-darkest);
+  font-weight: 600;
+}
+
+.solutionButton:hover {
+  background: var(--ifm-color-info-contrast-background);
+  border-color: var(--ifm-color-info-darkest);
+}
+
+.solutionButton.active {
+  background: var(--ifm-color-info-darker);
+  color: var(--ifm-color-secondary-contrast-background);
+}
+
+/* Complete Button (Primary) */
+.completeButton {
+  border-color: var(--ifm-color-primary);
+  color: var(--ifm-color-primary);
+  margin-left: auto;
+}
+
+.completeButton:hover {
+  background: var(--ifm-color-primary);
+  color: var(--ifm-color-white);
+}
+
+/* Completed Button (when task is done - shown as Undo) */
+.completedButton {
+  border-color: var(--ifm-color-danger);
+  color: var(--ifm-color-danger);
+}
+
+.completedButton:hover {
+  background: var(--ifm-color-danger);
+  color: var(--ifm-color-white);
+}
+
+/* ===================== PANELS (Hint/Solution) ===================== */
+
+.panelWrapper {
+  position: relative;
+  margin: 0 1.25rem 0rem 1.25rem;
+}
+
+.panelSpacer {
+  /* Invisible spacer that maintains layout space */
+  width: 100%;
+  overflow: hidden;
+}
+
+.panelContainer {
+  border-radius: 6px;
+  overflow: hidden;
+  transition: margin 0.3s ease-out;
+}
+
+.panelAbsolute {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  opacity: 0;
+  pointer-events: none;
+  visibility: hidden;
+  transform: translateX(0);
+}
+
+.panelVisible {
+  /* Don't set opacity here - let animations handle it */
+  pointer-events: auto;
+  visibility: visible;
+}
+
+.panelContainerExpanding {
+  animation: expandPanel 0.3s ease-out forwards;
+}
+
+.panelContainerCollapsing {
+  animation: collapsePanel 0.3s ease-out forwards;
+}
+
+.hintPanelContainerExpandingSwitching {
+  animation: expandLeftToRight 0.3s ease-out forwards;
+}
+
+.hintPanelContainerCollapsingSwitching {
+  animation: collapseRightToLeft 0.3s ease-out forwards;
+}
+
+.solutionPanelContainerExpandingSwitching {
+  animation: expandRightToLeft 0.3s ease-out forwards;
+}
+
+.solutionPanelContainerCollapsingSwitching {
+  animation: collapseLeftToRight 0.3s ease-out forwards;
+}
+
+@keyframes expandPanel {
+  from {
+    opacity: 0;
+    transform: translateY(-8px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes collapsePanel {
+  from {
+    opacity: 1;
+    transform: translateY(0);
+  }
+
+  to {
+    opacity: 0;
+    transform: translateY(-8px);
+  }
+}
+
+@keyframes expandRightToLeft {
+  /* Appears from the RIGHT, slides to center (used when showing hint from solution) */
+  from {
+    opacity: 0;
+    transform: translateX(30px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+
+@keyframes collapseRightToLeft {
+  /* Disappears to the LEFT (used when hiding hint to show solution) */
+  from {
+    opacity: 1;
+    transform: translateX(0);
+  }
+
+  to {
+    opacity: 0;
+    transform: translateX(-30px);
+  }
+}
+
+@keyframes expandLeftToRight {
+  /* Appears from the LEFT, slides to center (used when showing solution from hint) */
+  from {
+    opacity: 0;
+    transform: translateX(-30px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+
+@keyframes collapseLeftToRight {
+  /* Disappears to the RIGHT (used when hiding solution to show hint) */
+  from {
+    opacity: 1;
+    transform: translateX(0);
+  }
+
+  to {
+    opacity: 0;
+    transform: translateX(30px);
+  }
+}
+
+/* ===================== DARK MODE ===================== */
+
+html[data-theme="dark"] .taskContainer {
+  border-color: var(--ifm-color-emphasis-200);
+}
+
+html[data-theme="dark"] .taskContainer:hover {
+  border-color: var(--ifm-color-emphasis-400);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+}
+
+html[data-theme="dark"] .taskCompleted {
+  border-color: var(--ifm-color-success-dark);
+}
+
+html[data-theme="dark"] .taskCompleted:hover {
+  border-color: var(--ifm-color-success);
+}
+
+html[data-theme="dark"] .hintButton {
+  border-color: var(--ifm-color-warning-light);
+  color: var(--ifm-color-warning-light);
+}
+
+html[data-theme="dark"] .hintButton.active {
+  background: var(--ifm-color-warning-darker);
+  color: var(--ifm-color-secondary-contrast-background);
+}
+
+html[data-theme="dark"] .solutionButton {
+  border-color: var(--ifm-color-info-light);
+  color: var(--ifm-color-info-light);
+}
+
+html[data-theme="dark"] .solutionButton.active {
+  background: var(--ifm-color-info-darker);
+  color: var(--ifm-color-secondary-contrast-background);
+}

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

@@ -0,0 +1,10 @@
+/**
+ * TaskAutoHideToggle Component
+ * A navbar button that toggles the auto-collapse functionality for completed tasks.
+ *
+ * This component manages its own state using localStorage instead of TaskContext
+ * because navbar items render outside the TaskProvider scope.
+ */
+import React from 'react';
+export default function TaskAutoHideToggle(): React.ReactElement;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/TaskAutoHideToggle/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAQnD,MAAM,CAAC,OAAO,UAAU,kBAAkB,IAAI,KAAK,CAAC,YAAY,CA+C/D"}

package/lib/theme/TaskAutoHideToggle/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * TaskAutoHideToggle Component
+ * A navbar button that toggles the auto-collapse functionality for completed tasks.
+ *
+ * This component manages its own state using localStorage instead of TaskContext
+ * because navbar items render outside the TaskProvider scope.
+ */
+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 = TaskAutoHideToggle;
+const react_1 = __importStar(require("react"));
+const icons_1 = require("../../utils/icons");
+const storage_1 = require("../../utils/storage");
+const styles_module_css_1 = __importDefault(require("./styles.module.css"));
+function TaskAutoHideToggle() {
+    const [autoCollapse, setAutoCollapse] = (0, react_1.useState)(() => (0, storage_1.loadAutoCollapseFromStorage)());
+    // Listen for changes from storage events (cross-tab) and custom events (same page)
+    (0, react_1.useEffect)(() => {
+        const handleStorageChange = () => {
+            setAutoCollapse((0, storage_1.loadAutoCollapseFromStorage)());
+        };
+        const handleCustomEvent = () => {
+            setAutoCollapse((0, storage_1.loadAutoCollapseFromStorage)());
+        };
+        // Listen to storage events (cross-tab sync)
+        window.addEventListener('storage', handleStorageChange);
+        // Listen to custom events (same-page sync from TaskProvider)
+        window.addEventListener('task-auto-collapse-changed', handleCustomEvent);
+        return () => {
+            window.removeEventListener('storage', handleStorageChange);
+            window.removeEventListener('task-auto-collapse-changed', handleCustomEvent);
+        };
+    }, []);
+    const handleToggle = () => {
+        const newValue = !autoCollapse;
+        setAutoCollapse(newValue);
+        (0, storage_1.saveAutoCollapseToStorage)(newValue);
+        // Dispatch custom event to notify TaskProvider and other components
+        window.dispatchEvent(new CustomEvent('task-auto-collapse-changed'));
+    };
+    return (react_1.default.createElement("button", { type: "button", className: styles_module_css_1.default.toggleButton, onClick: handleToggle, "aria-label": autoCollapse ? 'Disable auto-collapse' : 'Enable auto-collapse', title: autoCollapse ? 'Auto-collapse enabled' : 'Auto-collapse disabled' }, autoCollapse ? icons_1.ENABLED_ICON : icons_1.DISABLED_ICON));
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/theme/TaskAutoHideToggle/index.tsx"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUH,qCA+CC;AAvDD,+CAAmD;AACnD,6CAAgE;AAChE,iDAG6B;AAC7B,4EAAyC;AAEzC,SAAwB,kBAAkB;IACxC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,IAAA,gBAAQ,EAAU,GAAG,EAAE,CAC7D,IAAA,qCAA2B,GAAE,CAC9B,CAAC;IAEF,mFAAmF;IACnF,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,mBAAmB,GAAG,GAAG,EAAE;YAC/B,eAAe,CAAC,IAAA,qCAA2B,GAAE,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF,MAAM,iBAAiB,GAAG,GAAG,EAAE;YAC7B,eAAe,CAAC,IAAA,qCAA2B,GAAE,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF,4CAA4C;QAC5C,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;QAExD,6DAA6D;QAC7D,MAAM,CAAC,gBAAgB,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,CAAC;QAEzE,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;YAC3D,MAAM,CAAC,mBAAmB,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,CAAC;QAC9E,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,MAAM,QAAQ,GAAG,CAAC,YAAY,CAAC;QAC/B,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAA,mCAAyB,EAAC,QAAQ,CAAC,CAAC;QAEpC,oEAAoE;QACpE,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC;IAEF,OAAO,CACL,0CACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,2BAAM,CAAC,YAAY,EAC9B,OAAO,EAAE,YAAY,gBACT,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,sBAAsB,EAC3E,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,wBAAwB,IAEvE,YAAY,CAAC,CAAC,CAAC,oBAAY,CAAC,CAAC,CAAC,qBAAa,CACrC,CACV,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,41 @@
+/**
+ * TaskAutoHideToggle Styles
+ */
+
+.toggleButton {
+  background: none;
+  border: none;
+  cursor: pointer;
+  margin-right: 0.5rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.25rem;
+  height: 40px;
+  color: var(--ifm-navbar-link-color);
+  transition: opacity 0.2s ease, background-color 0.2s ease;
+  border-radius: 4px;
+}
+
+.toggleButton:hover {
+  opacity: 0.8;
+  background-color: var(--ifm-color-emphasis-200);
+}
+
+.toggleButton:active {
+  opacity: 0.6;
+}
+
+.toggleButton:focus-visible {
+  outline: 2px solid var(--ifm-color-primary);
+  outline-offset: 2px;
+}
+
+/* Dark mode adjustments */
+html[data-theme='dark'] .toggleButton {
+  color: var(--ifm-navbar-link-color);
+}
+
+html[data-theme='dark'] .toggleButton:hover {
+  background-color: var(--ifm-color-emphasis-300);
+}

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

@@ -0,0 +1,16 @@
+/**
+ * TaskExample Component
+ * Interactive collapsible task example with optional hint and solution sections
+ * Similar to Task component but:
+ * - Uses "Example N" numbering instead of "Task N"
+ * - Does NOT persist completion state to localStorage
+ * - Animations work but state is not saved
+ * - Not included in task registry (no progress tracking)
+ */
+import { type ReactNode, type ReactElement } from 'react';
+export interface TaskExampleProps {
+    name: string;
+    children?: ReactNode;
+}
+export default function TaskExample({ name, children }: TaskExampleProps): ReactElement;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/TaskExample/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAc,EAAE,KAAK,SAAS,EAAY,KAAK,YAAY,EAAqB,MAAM,OAAO,CAAC;AAM9F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,YAAY,CAsTtF"}