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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Helse Sør-Øst
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,339 @@
+# Docusaurus Interactive Tasks Plugin
+
+A Docusaurus plugin that transforms documentation into interactive learning experiences with tasks, hints, solutions, and automatic progress tracking.
+
+## Features
+
+- **Interactive Tasks** - Collapsible task components with completion tracking
+- **Hints & Solutions** - Optional toggleable hints and solutions for each task
+- **Auto-Numbering** - Automatic task numbering per page
+- **Persistent Progress** - Completion status saved to localStorage
+- **Progress Tracking** - Visual progress indicators in sidebar and task progression components
+- **Sidebar Badges** - Automatic completion badges (e.g., "2/5") in sidebar navigation
+- **Auto-Collapse Toggle** - Navbar button to enable/disable auto-collapsing of completed tasks
+- **Task Examples** - Non-persistent example tasks for demonstrations
+- **Standard Markdown Support** - Full support for Docusaurus admonitions and markdown features within tasks
+
+## Installation
+
+```bash
+npm install @sp-days-framework/docusaurus-plugin-interactive-tasks
+```
+
+## Quick Start
+
+### 1. Configure Docusaurus
+
+Add the plugin and remark plugin to your `docusaurus.config.js`:
+
+```js
+module.exports = {
+  plugins: ["@sp-days-framework/docusaurus-plugin-interactive-tasks"],
+
+  presets: [
+    [
+      "classic",
+      {
+        docs: {
+          remarkPlugins: [
+            require("@sp-days-framework/docusaurus-plugin-interactive-tasks")
+              .remarkTaskDirective,
+          ],
+        },
+      },
+    ],
+  ],
+};
+```
+
+### 2. Create Your First Task
+
+Use directive syntax in your MDX files:
+
+```mdx
+::::task[Setup Your Environment]
+
+Install Node.js and npm. Verify the installation:
+
+- `node --version`
+- `npm --version`
+
+:::hint
+Check the official Node.js website for installation instructions.
+:::
+
+:::solution
+Download from https://nodejs.org/. npm is included with Node.js.
+:::
+
+::::
+```
+
+**Syntax Rules:**
+
+- Use **4 colons** (`::::`) for task containers
+- Use **3 colons** (`:::`) for hint and solution blocks
+- Tasks are automatically numbered within each page
+- Completion state persists across sessions
+
+## Usage
+
+### Basic Task
+
+A simple task without hints or solutions:
+
+```mdx
+::::task[Create a Component]
+
+Create a new React component in `src/components/MyComponent.tsx`.
+
+::::
+```
+
+### Task with Hint
+
+Add a hint to guide users:
+
+```mdx
+::::task[Configure TypeScript]
+
+Set up TypeScript configuration for strict mode.
+
+:::hint
+Look for the `tsconfig.json` file in your project root.
+:::
+
+::::
+```
+
+### Task with Hint and Solution
+
+Provide both a hint and complete solution:
+
+```mdx
+::::task[Add API Route]
+
+Create a new API endpoint for user authentication.
+
+:::hint
+API routes in Next.js go in the `app/api` directory.
+:::
+
+:::solution
+Create `app/api/auth/route.ts`:
+
+\`\`\`typescript
+export async function POST(request: Request) {
+const body = await request.json();
+// Authentication logic here
+return Response.json({ success: true });
+}
+\`\`\`
+:::
+
+::::
+```
+
+### Task Examples (Non-Persistent)
+
+For demonstration purposes, use task examples that don't save completion state:
+
+```mdx
+::::task-example[Optional Task]
+
+This task won't save its completion state to localStorage.
+
+:::hint
+Perfect for examples or optional exercises.
+:::
+
+::::
+```
+
+**Key Differences from Regular Tasks:**
+- Uses `::::task-example` instead of `::::task`
+- Displays "Example N" numbering instead of "Task N"
+- Completion state is not persisted to localStorage
+- Not included in task registry or progress tracking
+- Ideal for demonstrations, tutorials, or non-critical exercises
+
+### Using Docusaurus Features Inside Tasks
+
+Tasks fully support standard Docusaurus markdown features and admonitions. You can use code blocks, tables, images, and Docusaurus admonitions (note, tip, info, warning, danger, caution, important) within task content.
+
+```mdx
+::::task[Setup Environment]
+
+Follow these steps to configure your development environment.
+
+:::note
+Make sure you have Node.js 18+ installed before proceeding.
+:::
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+:::
+
+::::
+```
+
+### Progress Tracking Components
+
+#### TaskProgression
+
+Display progress for a specific document:
+
+```mdx
+import TaskProgression from "@theme/TaskProgression";
+
+<TaskProgression path="/docs/module1" pluginId="default" />
+```
+
+**Props:**
+
+- `path` (string, required) - Path to the document (absolute or relative)
+  - Absolute: `"/docs/module1"` or `"/docs/module1.mdx"`
+  - Relative: `"./sibling-doc"` or `"../parent-doc"`
+  - Current page: `"."`
+- `pluginId` (string, optional) - Used for [Docs Multi-instance](https://docusaurus.io/docs/docs-multi-instance) ID (default: `"default"`)
+
+#### TaskProgressionOverview
+
+Display progress across all documents:
+
+```mdx
+import TaskProgressionOverview from "@theme/TaskProgressionOverview";
+
+<TaskProgressionOverview pluginId="default" />
+```
+
+**Props:**
+
+- `pluginId` (string, optional) - Used for [Docs Multi-instance](https://docusaurus.io/docs/docs-multi-instance) ID (default: `"default"`)
+
+### Auto-Collapse Toggle
+
+A navbar button is automatically injected that allows users to toggle auto-collapsing of completed tasks. When enabled, completed tasks automatically collapse to reduce visual clutter.
+
+The toggle state persists across sessions and syncs across browser tabs in real-time.
+
+### Sidebar Badges
+
+Task completion badges are automatically displayed in the sidebar navigation, showing progress like "2/5" for documents containing tasks. These badges:
+
+- Update in real-time as tasks are completed
+- Only appear on documents that contain tasks
+- Support both individual documents and category aggregation
+
+## Configuration
+
+### Plugin Installation
+
+The plugin requires **no configuration options** - it automatically discovers all Docusaurus docs instances:
+
+```js
+module.exports = {
+  plugins: ["@sp-days-framework/docusaurus-plugin-interactive-tasks"],
+};
+```
+
+### Remark Plugin Configuration
+
+You must add the `remarkTaskDirective` to each docs instance's `remarkPlugins` array:
+
+```js
+module.exports = {
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        docs: {
+          // Default docs instance
+          remarkPlugins: [
+            require('@sp-days-framework/docusaurus-plugin-interactive-tasks').remarkTaskDirective,
+          ],
+        },
+      },
+    ],
+  ],
+  plugins: [
+    '@sp-days-framework/docusaurus-plugin-interactive-tasks',
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'community',
+        path: 'community',
+        // Community docs instance
+        remarkPlugins: [
+          require('@sp-days-framework/docusaurus-plugin-interactive-tasks').remarkTaskDirective,
+        ],
+      },
+    ],
+  ],
+};
+```
+
+### Multi-Instance Support
+
+The plugin **fully supports** [Docusaurus multi-instance docs](https://docusaurus.io/docs/docs-multi-instance):
+
+- Automatically discovers all docs plugin instances
+- Task completion state is isolated per instance
+- `TaskProgression` and `TaskProgressionOverview` auto-detect the parent doc's instance
+- Sidebar badges work across all instances
+
+**Example:** If you use `<TaskProgression path="./intro.mdx" />` in a `community` docs instance, it automatically uses `pluginId="community"`. To reference tasks from a different instance, specify `pluginId` explicitly:
+
+```mdx
+<!-- In community docs, but showing tasks from default -->
+<TaskProgression path="/docs/intro.mdx" pluginId="default" />
+```
+
+## How It Works
+
+### Task Persistence
+
+- Task completion status is saved to `localStorage` with a unique key per task
+- Keys are generated using: `task-{pluginId}-{docId}-{taskNumber}-{encodedName}`
+- Progress syncs across browser tabs via storage events
+- Task examples use `task-example` directive and don't persist state
+
+### Task Registry
+
+During build, a webpack plugin scans all MDX files for task directives and generates a registry (`task-registry.json`) containing:
+
+- Total task count per document
+- Task names and numbers
+- Document metadata (title, section, permalink)
+
+This registry powers:
+
+- Sidebar badges showing task completion (e.g., "2/5")
+- TaskProgression components
+- TaskProgressionOverview component
+
+### Path Resolution
+
+The `TaskProgression` component supports multiple path formats:
+
+```mdx
+<!-- Absolute path -->
+
+<TaskProgression path="/docs/module1" />
+
+<!-- Relative to current page -->
+
+<TaskProgression path="./sibling-page" />
+<TaskProgression path="../parent-page" />
+
+<!-- Current page -->
+
+<TaskProgression path="." />
+
+<!-- With file extension -->
+
+<TaskProgression path="/docs/module1.mdx" />
+```

package/lib/contexts/DocTaskCounterContext.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Doc Task Counter Context
+ * Provides auto-incrementing task numbers for each doc page
+ */
+export interface DocTaskCounterContextValue {
+    /**
+     * Get the next task number and increment the counter
+     */
+    getNextTaskNumber: () => number;
+    /**
+     * Reset the counter (called when navigating to a new page)
+     */
+    resetCounter: () => void;
+}
+//# sourceMappingURL=DocTaskCounterContext.d.ts.map

package/lib/contexts/DocTaskCounterContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocTaskCounterContext.d.ts","sourceRoot":"","sources":["../../src/contexts/DocTaskCounterContext.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAEhC;;OAEG;IACH,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B"}

package/lib/contexts/DocTaskCounterContext.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Doc Task Counter Context
+ * Provides auto-incrementing task numbers for each doc page
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DocTaskCounterContext.js.map

package/lib/contexts/DocTaskCounterContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocTaskCounterContext.js","sourceRoot":"","sources":["../../src/contexts/DocTaskCounterContext.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/lib/contexts/TaskContext.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Task Context Types
+ */
+export interface TaskState {
+    completed: boolean;
+    pluginId?: string;
+    docId?: string;
+    taskNumber?: number;
+    name?: string;
+}
+export interface TasksState {
+    [taskKey: string]: TaskState;
+}
+/**
+ * Badge color configuration for a specific state (completed/incomplete)
+ */
+export interface BadgeColorConfig {
+    lightmode?: string;
+    darkmode?: string;
+}
+/**
+ * Badge configuration for customizing task progress display
+ */
+export interface BadgeConfig {
+    /** Hide the progress badge completely */
+    hide?: boolean;
+    /** Disable the checkmark icon (always show numbers) */
+    disableIcon?: boolean;
+    /** Badge colors configuration */
+    colors?: {
+        completed?: BadgeColorConfig;
+        incomplete?: BadgeColorConfig;
+        font?: BadgeColorConfig;
+    };
+}
+export interface DocPageRegistry {
+    id: string;
+    pluginId: string;
+    title: string;
+    description: string;
+    sectionName: string;
+    permalink: string;
+    source: string;
+    sidebarPosition?: number;
+    totalTasks: number;
+    tasks: Record<string, {
+        number: number;
+        name: string;
+    }>;
+    badgeConfig?: BadgeConfig;
+}
+/**
+ * Category metadata from sidebar structure
+ */
+export interface CategoryRegistry {
+    label: string;
+    path: string;
+    customProps?: Record<string, any>;
+    badgeConfig?: BadgeConfig;
+}
+export interface TaskRegistry {
+    docPages: Record<string, DocPageRegistry>;
+    categories: Record<string, CategoryRegistry>;
+}
+export interface TaskContextValue {
+    tasks: TasksState;
+    autoCollapseCompletedTasks: boolean;
+    setTaskCompleted: (taskKey: string, completed: boolean, pluginId?: string, docId?: string, taskNumber?: number, name?: string) => void;
+    setAutoCollapseCompletedTasks: (autoCollapse: boolean) => void;
+    taskRegistry: TaskRegistry | null;
+}
+//# sourceMappingURL=TaskContext.d.ts.map

package/lib/contexts/TaskContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskContext.d.ts","sourceRoot":"","sources":["../../src/contexts/TaskContext.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,iCAAiC;IACjC,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,gBAAgB,CAAC;QAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,IAAI,CAAC,EAAE,gBAAgB,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,0BAA0B,EAAE,OAAO,CAAC;IACpC,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,KACV,IAAI,CAAC;IACV,6BAA6B,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/D,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC"}

package/lib/contexts/TaskContext.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Task Context Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TaskContext.js.map

package/lib/contexts/TaskContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskContext.js","sourceRoot":"","sources":["../../src/contexts/TaskContext.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/lib/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Docusaurus Interactive Tasks Plugin
+ * A plugin providing interactive task components with progress tracking
+ */
+import type { LoadContext, Plugin } from "@docusaurus/types";
+export interface PluginOptions {
+}
+export default function interactiveTasksPlugin(context: LoadContext, options: PluginOptions): Plugin;
+export declare function getSwizzleComponentList(): string[];
+export { validateThemeConfig } from "./validateThemeConfig";
+export { useDocTaskStats, useCategoryTaskStats } from "./utils/useDocTaskStats";
+export type { DocTaskStats } from "./utils/useDocTaskStats";
+export { remarkTaskDirective } from "./plugin/remarkTaskDirective";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAK7D,MAAM,WAAW,aAAa;CAE7B;AAED,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,aAAa,GACrB,MAAM,CAoCR;AAGD,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAChF,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAK5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC"}

package/lib/index.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Docusaurus Interactive Tasks Plugin
+ * A plugin providing interactive task components with progress tracking
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remarkTaskDirective = exports.useCategoryTaskStats = exports.useDocTaskStats = exports.validateThemeConfig = void 0;
+exports.default = interactiveTasksPlugin;
+exports.getSwizzleComponentList = getSwizzleComponentList;
+const path_1 = __importDefault(require("path"));
+const TaskRegistryPlugin_1 = require("./plugin/TaskRegistryPlugin");
+function interactiveTasksPlugin(context, options) {
+    const { siteDir } = context;
+    return {
+        name: "@sp-days-framework/docusaurus-plugin-interactive-tasks",
+        getThemePath() {
+            return path_1.default.resolve(__dirname, "./theme");
+        },
+        getTypeScriptThemePath() {
+            return path_1.default.resolve(__dirname, "../src/theme");
+        },
+        getClientModules() {
+            return [];
+        },
+        configureWebpack(config, isServer) {
+            const plugins = [];
+            // Only run on client build to generate task-registry.json
+            if (!isServer) {
+                plugins.push(new TaskRegistryPlugin_1.TaskRegistryPlugin(siteDir));
+            }
+            return {
+                plugins,
+            };
+        },
+        // Export for compatibility with Docusaurus plugin system
+        getDefaultCodeTranslationMessages() {
+            return {};
+        },
+    };
+}
+// Override the docs plugin preset to add our remark plugin
+function getSwizzleComponentList() {
+    return [];
+}
+var validateThemeConfig_1 = require("./validateThemeConfig");
+Object.defineProperty(exports, "validateThemeConfig", { enumerable: true, get: function () { return validateThemeConfig_1.validateThemeConfig; } });
+// Export utility hooks for custom components
+var useDocTaskStats_1 = require("./utils/useDocTaskStats");
+Object.defineProperty(exports, "useDocTaskStats", { enumerable: true, get: function () { return useDocTaskStats_1.useDocTaskStats; } });
+Object.defineProperty(exports, "useCategoryTaskStats", { enumerable: true, get: function () { return useDocTaskStats_1.useCategoryTaskStats; } });
+// Note: usePluginId is available from theme components, not exported from plugin entry
+// Users can import it directly from the theme: import { usePluginId } from '@theme/...';
+// Export the remark plugin so users can add it to their docusaurus.config.js
+var remarkTaskDirective_1 = require("./plugin/remarkTaskDirective");
+Object.defineProperty(exports, "remarkTaskDirective", { enumerable: true, get: function () { return remarkTaskDirective_1.remarkTaskDirective; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAYH,yCAuCC;AAGD,0DAEC;AAtDD,gDAAwB;AAGxB,oEAAiE;AAOjE,SAAwB,sBAAsB,CAC5C,OAAoB,EACpB,OAAsB;IAEtB,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,OAAO;QACL,IAAI,EAAE,wDAAwD;QAE9D,YAAY;YACV,OAAO,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,sBAAsB;YACpB,OAAO,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACjD,CAAC;QAED,gBAAgB;YACd,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,gBAAgB,CAAC,MAAqB,EAAE,QAAiB;YACvD,MAAM,OAAO,GAAU,EAAE,CAAC;YAE1B,0DAA0D;YAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,IAAI,uCAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;YAChD,CAAC;YAED,OAAO;gBACL,OAAO;aACR,CAAC;QACJ,CAAC;QAED,yDAAyD;QACzD,iCAAiC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,SAAgB,uBAAuB;IACrC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,6CAA6C;AAC7C,2DAAgF;AAAvE,kHAAA,eAAe,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAE9C,uFAAuF;AACvF,yFAAyF;AAEzF,6EAA6E;AAC7E,oEAAmE;AAA1D,0HAAA,mBAAmB,OAAA"}

package/lib/plugin/TaskRegistryPlugin.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Webpack plugin that scans Docusaurus metadata for Task directives and generates a registry
+ *
+ * Scans for ::::task[Name] directives (4 colons) in MDX files
+ */
+import type { Compiler } from "webpack";
+export declare class TaskRegistryPlugin {
+    private siteDir;
+    private hasLoggedSuccess;
+    private loggedWarnings;
+    private missingFiles;
+    private hasLoggedStaleCache;
+    constructor(siteDir: string);
+    apply(compiler: Compiler): void;
+    private scanForTasks;
+    private scanPluginInstance;
+    private processDoc;
+    private extractTasksFromFile;
+    /**
+     * Detect stale cache and notify user once
+     *
+     * Checks if missing files indicate a stale .docusaurus cache
+     * and provides helpful recommendation to clear it
+     */
+    private detectAndNotifyStaleCacheOnce;
+}
+//# sourceMappingURL=TaskRegistryPlugin.d.ts.map

package/lib/plugin/TaskRegistryPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRegistryPlugin.d.ts","sourceRoot":"","sources":["../../src/plugin/TaskRegistryPlugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAiJxC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,mBAAmB,CAAkB;gBAEjC,OAAO,EAAE,MAAM;IAI3B,KAAK,CAAC,QAAQ,EAAE,QAAQ;YAgDV,YAAY;YAiCZ,kBAAkB;YA+BlB,UAAU;YAgEV,oBAAoB;IAkDlC;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;CAkDtC"}