@sp-days-framework/docusaurus-plugin-slidev 1.1.0-beta2 → 1.1.0

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

@@ -1,90 +1,100 @@
+/**
+ * SlidevOverview styles
+ * Layout with fixed-size banner and content containers
+ */
+
+/* Main container - centers everything */
 .container {
-  max-width: 1500px;
-  margin: 0 auto;
-  padding: 2rem;
-  position: relative;
   display: flex;
   flex-direction: column;
   align-items: center;
+  padding: 2rem;
+  min-height: calc(100vh - var(--ifm-navbar-height));
 }
 
-.headerWrapper {
-  margin-bottom: 3rem;
+/* ============================================
+   Banner Section - Fixed width container
+   ============================================ */
+.bannerWrapper {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
   width: 100%;
+  max-width: 1200px;
+  margin-bottom: 2rem;
 }
 
-.header {
+.banner {
+  width: 100%;
+  max-width: 800px;
   text-align: center;
+  padding: 0 1rem;
 }
 
 .title {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.75rem;
   font-size: 2.5rem;
   font-weight: 700;
   color: var(--ifm-heading-color);
-  margin-bottom: 1rem;
+  margin: 0 0 0.75rem 0;
+}
+
+.titleIcon {
+  color: var(--ifm-color-primary);
+  flex-shrink: 0;
 }
 
 .subtitle {
   font-size: 1.15rem;
   color: var(--ifm-color-emphasis-700);
+  margin: 0;
   max-width: 600px;
-  margin: 0 auto;
-}
-
-.devModeWarning {
-  padding: 1.5rem;
-  margin-bottom: 2rem;
-  border-radius: 8px;
-  background: var(--ifm-color-warning-contrast-background);
-  border-left: 4px solid var(--ifm-color-warning);
-}
-
-.warningTitle {
+  margin-left: auto;
+  margin-right: auto;
+}
+
+/* Back button - positioned absolutely to left of banner */
+.backButton {
+  position: absolute;
+  left: 0;
+  top: 50%;
+  transform: translateY(-50%);
+  width: 48px;
+  height: 48px;
+  border-radius: 50%;
+  border: 2px solid var(--ifm-color-emphasis-300);
+  background: var(--ifm-background-color);
+  color: var(--ifm-color-emphasis-700);
+  cursor: pointer;
+  transition: all 0.2s ease;
   display: flex;
   align-items: center;
-  gap: 0.5rem;
-  margin-bottom: 0.5rem;
-  font-weight: 600;
-  color: var(--ifm-color-warning-darkest);
-}
-
-.warningIcon {
-  width: 24px;
-  height: 24px;
-}
-
-.warningText {
-  margin: 0;
-  color: var(--ifm-color-warning-contrast-foreground);
-  line-height: 1.6;
+  justify-content: center;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  text-decoration: none;
 }
 
-.warningText em {
-  display: block;
-  margin-top: 0.5rem;
-  font-size: 0.9rem;
+.backButton:hover {
+  border-color: var(--ifm-color-primary-contrast-background);
+  color: var(--ifm-color-primary-contrast-background);
+  background: var(--ifm-color-primary-lightest);
+  transform: translateY(-50%) scale(1.05);
+  text-decoration: none;
 }
 
-/* .warningCode {
-  display: inline-block;
-  padding: 0.2rem 0.5rem;
-  margin: 0 0.25rem;
-  background: var(--ifm-code-background);
-  border-radius: 4px;
-  font-family: var(--ifm-font-family-monospace);
-  font-size: 0.9rem;
-  color: var(--ifm-color-warning-contrast-background);
-} */
-
-/* Controls (Sort and View Toggle) - Fixed to top-right of viewport */
+/* Controls - positioned absolutely to right of banner */
 .controls {
-  position: fixed;
-  top: calc(var(--ifm-navbar-height) + 1rem);
-  right: 2rem;
+  position: absolute;
+  right: 0;
+  top: 50%;
+  transform: translateY(-50%);
   display: flex;
   gap: 0.5rem;
   align-items: center;
-  z-index: 100;
   background: var(--ifm-background-color);
   padding: 0.5rem;
   border-radius: 8px;
@@ -105,102 +115,87 @@
 }
 
 .controlButton:hover {
-  border-color: var(--ifm-color-primary);
+  border-color: var(--ifm-color-primary-contrast-background);
   color: var(--ifm-color-primary-contrast-background);
   background: var(--ifm-color-primary-lightest);
 }
 
-/* Content Container - Fixed min-height to prevent jumping */
-.contentContainer {
+/* ============================================
+   Dev Mode Warning
+   ============================================ */
+.devModeWarning {
   width: 100%;
-  max-width: 1500px;
-  position: relative;
-}
-
-/* Visibility toggle classes */
-
-.grid.hidden {
-  /* Keep in DOM but hidden - preserves iframe state */
-  display: none;
-}
-
-/* Grid View */
-.grid {
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: center;
-  gap: 1.5rem;
-  margin-bottom: 2rem;
-}
-
-/* Details View (Table) */
-.detailsTable {
+  max-width: 1200px;
+  padding: 1.5rem;
   margin-bottom: 2rem;
-  overflow-x: auto;
-  width: 100%;
-}
-
-.detailsTable.hidden {
-  /* Keep in DOM but hidden */
-  display: none;
-}
-
-.detailsTable table {
-  display: table;
-  border-collapse: collapse;
-  background: var(--ifm-background-surface-color);
   border-radius: 8px;
-  overflow: hidden;
-}
-
-.detailsTable thead {
-  background: var(--ifm-color-emphasis-100);
+  background: var(--ifm-color-warning-contrast-background);
+  border-left: 4px solid var(--ifm-color-warning);
 }
 
-.detailsTable th {
-  padding: 1rem;
-  text-align: left;
+.warningTitle {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.5rem;
   font-weight: 600;
-  color: var(--ifm-color-emphasis-800);
-  font-size: 0.9rem;
-  border-bottom: 2px solid var(--ifm-color-emphasis-200);
-}
-
-.detailsTable td {
-  padding: 1rem;
-  border-bottom: 1px solid var(--ifm-color-emphasis-200);
-  font-size: 0.9rem;
+  color: var(--ifm-color-warning-darkest);
 }
 
-.detailsTable tbody tr:last-child td {
-  border-bottom: none;
+.warningIcon {
+  width: 24px;
+  height: 24px;
 }
 
-.detailsTable tbody tr:hover {
-  background: var(--ifm-color-emphasis-50);
+.warningText {
+  margin: 0;
+  color: var(--ifm-color-warning-contrast-foreground);
+  line-height: 1.6;
 }
 
-.detailsTitle {
-  font-weight: 600;
-  color: var(--ifm-color-emphasis-900);
+.warningText code {
+  display: inline-block;
+  padding: 0.2rem 0.5rem;
+  margin: 0 0.25rem;
+  background: var(--ifm-code-background);
+  border-radius: 4px;
+  font-family: var(--ifm-font-family-monospace);
+  font-size: 0.9rem;
 }
 
-.detailsLink {
-  font-weight: 600;
-  color: var(--ifm-color-primary);
-  text-decoration: none;
+/* ============================================
+   Content Container - Fixed width
+   ============================================ */
+.contentContainer {
+  width: 100%;
+  max-width: 1200px;
+  min-height: 400px;
 }
 
-.detailsLink:hover {
-  text-decoration: underline;
+/* Grid View - items wrap and fill available space */
+.grid {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 1.5rem;
 }
 
-.detailsDescription {
-  color: var(--ifm-color-emphasis-700);
+/* List View - full width items */
+.list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  width: 100%;
 }
 
-/* Empty State */
+/* ============================================
+   Empty State
+   ============================================ */
 .emptyState {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
   text-align: center;
   padding: 4rem 2rem;
   color: var(--ifm-color-emphasis-600);
@@ -209,7 +204,7 @@
 .emptyStateIcon {
   width: 64px;
   height: 64px;
-  margin: 0 auto 1rem;
+  margin-bottom: 1rem;
   opacity: 0.5;
 }
 
@@ -235,49 +230,83 @@
   color: var(--ifm-color-emphasis-900);
 }
 
+/* ============================================
+   Responsive Styles
+   ============================================ */
+@media (max-width: 992px) {
+  .bannerWrapper {
+    flex-direction: column;
+    gap: 1rem;
+    padding: 0 60px; /* Space for side buttons */
+  }
+
+  .backButton {
+    position: absolute;
+    left: 50px;
+  }
+
+  .controls {
+    position: absolute;
+    right: 50px;
+  }
+}
+
 @media (max-width: 768px) {
   .container {
     padding: 1rem;
   }
 
+  .bannerWrapper {
+    flex-direction: column;
+    gap: 1rem;
+    padding: 0;
+    position: relative;
+  }
+
+  .banner {
+    padding: 0;
+    order: 2;
+  }
+
   .title {
-    font-size: 2rem;
+    font-size: 1.75rem;
   }
 
   .subtitle {
     font-size: 1rem;
   }
 
-  .headerWrapper {
-    flex-direction: column;
-    gap: 1rem;
+  .backButton {
+    position: relative;
+    top: auto;
+    left: auto;
+    transform: none;
+    order: 1;
+    align-self: flex-start;
   }
 
-  .header {
-    margin-bottom: 0;
+  .backButton:hover {
+    transform: scale(1.05);
   }
 
   .controls {
-    top: calc(var(--ifm-navbar-height) + 0.5rem);
-    right: 1rem;
-    padding: 0.25rem;
+    position: relative;
+    top: auto;
+    right: auto;
+    transform: none;
+    order: 3;
+    align-self: center;
   }
 
-  .contentContainer {
-    min-width: 100%;
+  .devModeWarning {
+    padding: 1rem;
   }
 
   .grid {
-    flex-direction: column;
-    align-items: center;
-  }
-
-  .detailsTable {
-    font-size: 0.85rem;
+    gap: 1rem;
   }
 
-  .detailsTable th,
-  .detailsTable td {
-    padding: 0.75rem 0.5rem;
+  .contentContainer {
+    min-height: 200px;
   }
 }

package/lib/types/index.d.ts

@@ -7,14 +7,16 @@
 export interface PluginOptions {
     /**
      * Directory to scan for Slidev markdown files
+     * Also determines the URL path where presentations are served
+     * e.g., './slidev' -> '/slidev/', './presentations' -> '/presentations/'
      * @default './slidev'
      */
-    sourceDir: string;
+    path: string;
     /**
-     * Output directory inside static/ for built presentations
-     * @default 'slides'
+     * @deprecated Use `path` instead. Will be removed in a future version.
+     * Alias for `path` - directory to scan for Slidev markdown files
      */
-    outputDir: string;
+    sourceDir?: string;
     /**
      * Global theme override for all presentations
      * Example: '@slidev/theme-seriph'
@@ -29,18 +31,34 @@ export interface PluginOptions {
     download: boolean;
     /**
      * URL path for the auto-generated overview page
+     * Matches Docusaurus convention for route configuration
      * @default '/slidev'
      */
-    overviewPath: string;
+    routeBasePath: string;
+    /**
+     * @deprecated Use `routeBasePath` instead. Will be removed in a future version.
+     * Alias for `routeBasePath`
+     */
+    overviewPath?: string;
     /**
      * Custom title for the overview page
      * @default 'Slidev Presentations'
      */
+    pageTitle?: string;
+    /**
+     * @deprecated Use `pageTitle` instead. Will be removed in a future version.
+     * Alias for `pageTitle`
+     */
     overviewTitle?: string;
     /**
      * Custom tagline/description for the overview page
      * @default 'Interactive presentation overview'
      */
+    pageTagline?: string;
+    /**
+     * @deprecated Use `pageTagline` instead. Will be removed in a future version.
+     * Alias for `pageTagline`
+     */
     overviewTagline?: string;
     /**
      * Plugin ID for multiple instances
@@ -50,7 +68,7 @@ export interface PluginOptions {
     /**
      * Timeout in seconds for building each presentation
      * If a build takes longer than this, it will be terminated
-     * @default 60
+     * @default 120
      */
     buildTimeout?: number;
     /**
@@ -59,6 +77,13 @@ export interface PluginOptions {
      * @default false
      */
     verbose?: boolean;
+    /**
+     * Maximum number of parallel Slidev builds
+     * Higher values speed up builds but use more system resources
+     * Set to 1 for sequential builds (legacy behavior)
+     * @default 4 (capped at CPU count)
+     */
+    maxParallelBuilds?: number;
 }
 /**
  * Metadata extracted from a Slidev presentation
@@ -108,6 +133,17 @@ export interface PresentationMetadata {
      * Example: '/slides/module-01-slides/preview.html'
      */
     previewUrl?: string;
+    /**
+     * Manual sort position override from frontmatter
+     * If not specified, sorting falls back to sourcePath then title
+     */
+    position?: number;
+    /**
+     * Category path if presentation is inside a directory
+     * Empty string for root-level presentations
+     * Example: 'advanced' or 'workshops/intro'
+     */
+    category?: string;
 }
 /**
  * Slidev frontmatter configuration
@@ -122,6 +158,12 @@ export interface SlidevFrontmatter {
     transition?: string;
     background?: string;
     class?: string;
+    /**
+     * Manual sort position override
+     * Lower numbers appear first in the overview
+     * Supports decimals for fine-grained ordering (e.g., 2.5)
+     */
+    position?: number;
     fonts?: {
         sans?: string;
         serif?: string;
@@ -129,6 +171,39 @@ export interface SlidevFrontmatter {
     };
     [key: string]: any;
 }
+/**
+ * Category metadata from _category_.yml or _category_.json files
+ * Used to configure directory groupings in the overview
+ */
+export interface CategoryMetadata {
+    /**
+     * Directory path relative to sourceDir (e.g., 'advanced', 'workshops/intro')
+     */
+    path: string;
+    /**
+     * Display name for the category
+     * Falls back to directory name if not specified
+     */
+    label: string;
+    /**
+     * Description shown in the category card/header
+     */
+    description?: string;
+    /**
+     * Sort position for the category
+     * Lower numbers appear first
+     * @default 99
+     */
+    position: number;
+    /**
+     * Number of presentations in this category
+     */
+    count: number;
+    /**
+     * URL path to navigate to this category's view
+     */
+    url: string;
+}
 /**
  * Build result for a single presentation
  */
@@ -159,6 +234,10 @@ export interface PluginContentData {
      * List of all discovered presentations
      */
     presentations: PresentationMetadata[];
+    /**
+     * List of all discovered categories (directories with presentations)
+     */
+    categories: CategoryMetadata[];
     /**
      * Plugin configuration
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,aAAa,EAAE,oBAAoB,EAAE,CAAC;IAEtC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/lib/utils/fileSystem.d.ts

@@ -1,6 +1,10 @@
 /**
  * File system utilities for Slidev Plugin
  */
+/**
+ * The cache directory name within .docusaurus
+ */
+export declare const SLIDEV_CACHE_DIR = "docusaurus-plugin-slidev";
 /**
  * Cleans up the output directory before building presentations
  * Removes all subdirectories and files but preserves .gitignore
@@ -16,4 +20,53 @@ export declare function cleanupSourceDirectory(sourcePath: string): void;
  * Content: ignore all files except .gitignore itself
  */
 export declare function createGitignore(outputPath: string): void;
+/**
+ * Gets the Slidev cache directory path within .docusaurus
+ * This is used to isolate builds and prevent race conditions
+ * @param siteDir The Docusaurus site root directory
+ * @param pluginId The plugin instance ID (for multi-instance support)
+ * @returns Path to the plugin's cache directory
+ */
+export declare function getSlidevCacheDir(siteDir: string, pluginId?: string): string;
+/**
+ * Creates an isolated build directory for a single presentation
+ * Copies the source .md file to its own directory to prevent index.html conflicts
+ * during parallel builds.
+ *
+ * @param sourceAbsolutePath Absolute path to the source .md file
+ * @param presentationId The unique ID for this presentation
+ * @param cacheDir The base cache directory
+ * @returns Path to the copied .md file in the isolated directory
+ */
+export declare function createIsolatedBuildDir(sourceAbsolutePath: string, presentationId: string, cacheDir: string): string;
+/**
+ * Cleans up the isolated build directory after a build completes
+ * Removes Slidev artifacts (index.html, .slidev, dist) from the isolated directory
+ *
+ * @param isolatedDir The isolated build directory to clean
+ */
+export declare function cleanupIsolatedBuildDir(isolatedDir: string): void;
+/**
+ * Cleans the entire Slidev cache directory
+ * Should be called at the start of a build to ensure a clean state
+ *
+ * @param cacheDir The cache directory to clean
+ */
+export declare function cleanupSlidevCache(cacheDir: string): void;
+/**
+ * Gets the Slidev build output directory path within .docusaurus cache
+ * This is where built presentations are stored before being copied to final output
+ * @param siteDir The Docusaurus site root directory
+ * @param pluginId The plugin instance ID (for multi-instance support)
+ * @returns Path to the plugin's build output directory
+ */
+export declare function getSlidevBuildOutputDir(siteDir: string, pluginId?: string): string;
+/**
+ * Copies built presentations from cache directory to final output directory
+ * This is called in the postBuild hook to copy presentations to the final build output
+ *
+ * @param cacheOutputDir The cache directory containing built presentations
+ * @param finalOutputDir The final output directory (e.g., build/slides)
+ */
+export declare function copyBuiltPresentationsToOutput(cacheOutputDir: string, finalOutputDir: string): void;
 //# sourceMappingURL=fileSystem.d.ts.map

package/lib/utils/fileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fileSystem.d.ts","sourceRoot":"","sources":["../../src/utils/fileSystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAyB/D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CA4B/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAcxD"}
+{"version":3,"file":"fileSystem.d.ts","sourceRoot":"","sources":["../../src/utils/fileSystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAyB/D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CA4B/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAcxD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAkB,GAC3B,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAuBjE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWzD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAkB,GAC3B,MAAM,CAQR;AA2BD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,IAAI,CAuBN"}