npm - @patch-adams/core - Versions diffs - 1.5.23 → 1.6.0 - Mend

@patch-adams/core 1.5.23 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -564,6 +564,53 @@ interface CourseMetadata {
  */
 declare function extractCourseMetadata(zip: AdmZip, format: string): CourseMetadata;
+/**
+ * Parsed course structure types for Rise SCORM packages.
+ * Used by the parse-structure API and the frontend tree view.
+ */
+/** A single block within a Rise lesson */
+interface CourseStructureBlock {
+    /** Rise block ID (e.g. "cmk2wzn2p007q3b7hsiobz031") */
+    id: string;
+    /** Block type: "text", "image", "interactive", "knowledgeCheck", etc. */
+    type: string;
+    /** Block family: "text", "media", "interactive", etc. */
+    family?: string;
+    /** Block variant: "paragraph", "accordion", "hero", etc. */
+    variant?: string;
+    /** Human-readable title derived from block content or type label */
+    title?: string;
+}
+/** A lesson (section) in a Rise course */
+interface CourseStructureLesson {
+    /** Rise lesson ID */
+    id: string;
+    /** Lesson title */
+    title: string;
+    /** Lesson type (e.g. "blocks") */
+    type: string;
+    /** Blocks within this lesson */
+    blocks: CourseStructureBlock[];
+}
+/** Parsed course structure returned by extractCourseStructure() */
+interface CourseStructure {
+    /** Course title */
+    courseTitle: string;
+    /** Course identifier from manifest */
+    courseId?: string;
+    /** Lessons in the course */
+    lessons: CourseStructureLesson[];
+}
+/** User-assigned class mappings at course, lesson, and block levels */
+interface CourseClassMappings {
+    /** Space-separated class names for the <html> element (course level) */
+    course?: string;
+    /** Lesson ID -> space-separated class names */
+    lessons?: Record<string, string>;
+    /** Block ID -> space-separated class names */
+    blocks?: Record<string, string>;
+}
 /**
  * Base configuration for any plugin
  */
@@ -880,6 +927,8 @@ interface PatchOptions {
     skin?: string;
     /** Original package filename — baked into LRS bridge for statement searchability */
     packageName?: string;
+    /** Custom CSS class mappings for course, lesson, and block levels */
+    classMappings?: CourseClassMappings;
 }
 /**
  * Main Patcher class for patching e-learning course packages
@@ -1113,6 +1162,31 @@ declare function generateJsAfterLoader(options: JsAfterOptions): string;
  */
 declare function buildJsAfterOptions(config: PatchAdamsConfig): JsAfterOptions;
+/**
+ * Class Mappings Template
+ *
+ * Generates an inline JavaScript snippet that applies user-defined CSS classes
+ * to course, lesson, and block elements at runtime.
+ *
+ * Timing: This script is injected inline (via plugin assets) so it executes
+ * synchronously BEFORE the pa-loading class is removed. The user never sees
+ * an un-styled flash — classes are applied while content is still hidden.
+ *
+ * - Course classes: added to <html> element immediately
+ * - Block classes: added to [data-block-id] elements via MutationObserver
+ * - Lesson classes: toggled on <html> via hashchange (Rise SPA routing)
+ */
+/**
+ * Check if class mappings contain any actual assignments
+ */
+declare function hasClassMappings(mappings?: CourseClassMappings): boolean;
+/**
+ * Generate an inline JavaScript snippet that applies class mappings at runtime.
+ * Returns an empty string if there are no mappings to apply.
+ */
+declare function generateClassMappingsScript(mappings: CourseClassMappings): string;
 type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
 /**
  * Simple logger utility for Patch-Adams
@@ -1129,6 +1203,19 @@ declare class Logger {
     setLevel(level: LogLevel): void;
 }
+/**
+ * Rise Course Structure Parser
+ *
+ * Extracts the hierarchical course structure (lessons + blocks) from a
+ * Rise SCORM ZIP package by parsing the embedded base64-encoded course JSON.
+ */
+/**
+ * Extract course structure from a Rise SCORM ZIP buffer.
+ * Returns null if the ZIP is not a Rise package or parsing fails.
+ */
+declare function extractCourseStructure(zipBuffer: Buffer): CourseStructure | null;
 /**
  * Plugin Registry for Patch-Adams
  *
@@ -1198,4 +1285,4 @@ declare class PluginRegistry {
  */
 declare const pluginRegistry: PluginRegistry;
-export { type AsyncAssetConfig, AsyncAssetConfigSchema, type AuthoringTool, AuthoringToolDetector, type AuthoringToolInfo, type BlockingAssetConfig, BlockingAssetConfigSchema, type CourseFingerprint, type CourseMetadata, type CssAfterOptions, type CssBeforeOptions, DEFAULT_LRS_OPTIONS, FormatDetector, type GeneratedPluginAssets, HtmlInjector, type JsAfterOptions, type JsBeforeOptions, type LocalFoldersConfig, LocalFoldersConfigSchema, type LogLevel, Logger, type LrsBridgeConfig, LrsBridgeConfigSchema, type LrsBridgeOptions, type ManifestPaths, ManifestUpdater, type PackageFormat, type PatchAdamsConfig, PatchAdamsConfigSchema, type PatchAdamsPlugin, type PatchOptions, type PatchResult, Patcher, type PluginAssets, type PluginConfig, PluginRegistry, type PluginsConfig, StorylineHtmlInjector, buildCssAfterOptions, buildCssBeforeOptions, buildJsAfterOptions, buildJsBeforeOptions, defaultConfig, extractCourseFingerprint, extractCourseMetadata, generateConfigTemplate, generateCssAfterLoader, generateCssBeforeLoader, generateJsAfterLoader, generateJsBeforeLoader, generateLrsBridgeCode, loadConfig, mergeWithDefaults, pluginRegistry };
+export { type AsyncAssetConfig, AsyncAssetConfigSchema, type AuthoringTool, AuthoringToolDetector, type AuthoringToolInfo, type BlockingAssetConfig, BlockingAssetConfigSchema, type CourseClassMappings, type CourseFingerprint, type CourseMetadata, type CourseStructure, type CourseStructureBlock, type CourseStructureLesson, type CssAfterOptions, type CssBeforeOptions, DEFAULT_LRS_OPTIONS, FormatDetector, type GeneratedPluginAssets, HtmlInjector, type JsAfterOptions, type JsBeforeOptions, type LocalFoldersConfig, LocalFoldersConfigSchema, type LogLevel, Logger, type LrsBridgeConfig, LrsBridgeConfigSchema, type LrsBridgeOptions, type ManifestPaths, ManifestUpdater, type PackageFormat, type PatchAdamsConfig, PatchAdamsConfigSchema, type PatchAdamsPlugin, type PatchOptions, type PatchResult, Patcher, type PluginAssets, type PluginConfig, PluginRegistry, type PluginsConfig, StorylineHtmlInjector, buildCssAfterOptions, buildCssBeforeOptions, buildJsAfterOptions, buildJsBeforeOptions, defaultConfig, extractCourseFingerprint, extractCourseMetadata, extractCourseStructure, generateClassMappingsScript, generateConfigTemplate, generateCssAfterLoader, generateCssBeforeLoader, generateJsAfterLoader, generateJsBeforeLoader, generateLrsBridgeCode, hasClassMappings, loadConfig, mergeWithDefaults, pluginRegistry };

package/dist/index.d.ts CHANGED Viewed

@@ -564,6 +564,53 @@ interface CourseMetadata {
  */
 declare function extractCourseMetadata(zip: AdmZip, format: string): CourseMetadata;
+/**
+ * Parsed course structure types for Rise SCORM packages.
+ * Used by the parse-structure API and the frontend tree view.
+ */
+/** A single block within a Rise lesson */
+interface CourseStructureBlock {
+    /** Rise block ID (e.g. "cmk2wzn2p007q3b7hsiobz031") */
+    id: string;
+    /** Block type: "text", "image", "interactive", "knowledgeCheck", etc. */
+    type: string;
+    /** Block family: "text", "media", "interactive", etc. */
+    family?: string;
+    /** Block variant: "paragraph", "accordion", "hero", etc. */
+    variant?: string;
+    /** Human-readable title derived from block content or type label */
+    title?: string;
+}
+/** A lesson (section) in a Rise course */
+interface CourseStructureLesson {
+    /** Rise lesson ID */
+    id: string;
+    /** Lesson title */
+    title: string;
+    /** Lesson type (e.g. "blocks") */
+    type: string;
+    /** Blocks within this lesson */
+    blocks: CourseStructureBlock[];
+}
+/** Parsed course structure returned by extractCourseStructure() */
+interface CourseStructure {
+    /** Course title */
+    courseTitle: string;
+    /** Course identifier from manifest */
+    courseId?: string;
+    /** Lessons in the course */
+    lessons: CourseStructureLesson[];
+}
+/** User-assigned class mappings at course, lesson, and block levels */
+interface CourseClassMappings {
+    /** Space-separated class names for the <html> element (course level) */
+    course?: string;
+    /** Lesson ID -> space-separated class names */
+    lessons?: Record<string, string>;
+    /** Block ID -> space-separated class names */
+    blocks?: Record<string, string>;
+}
 /**
  * Base configuration for any plugin
  */
@@ -880,6 +927,8 @@ interface PatchOptions {
     skin?: string;
     /** Original package filename — baked into LRS bridge for statement searchability */
     packageName?: string;
+    /** Custom CSS class mappings for course, lesson, and block levels */
+    classMappings?: CourseClassMappings;
 }
 /**
  * Main Patcher class for patching e-learning course packages
@@ -1113,6 +1162,31 @@ declare function generateJsAfterLoader(options: JsAfterOptions): string;
  */
 declare function buildJsAfterOptions(config: PatchAdamsConfig): JsAfterOptions;
+/**
+ * Class Mappings Template
+ *
+ * Generates an inline JavaScript snippet that applies user-defined CSS classes
+ * to course, lesson, and block elements at runtime.
+ *
+ * Timing: This script is injected inline (via plugin assets) so it executes
+ * synchronously BEFORE the pa-loading class is removed. The user never sees
+ * an un-styled flash — classes are applied while content is still hidden.
+ *
+ * - Course classes: added to <html> element immediately
+ * - Block classes: added to [data-block-id] elements via MutationObserver
+ * - Lesson classes: toggled on <html> via hashchange (Rise SPA routing)
+ */
+/**
+ * Check if class mappings contain any actual assignments
+ */
+declare function hasClassMappings(mappings?: CourseClassMappings): boolean;
+/**
+ * Generate an inline JavaScript snippet that applies class mappings at runtime.
+ * Returns an empty string if there are no mappings to apply.
+ */
+declare function generateClassMappingsScript(mappings: CourseClassMappings): string;
 type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
 /**
  * Simple logger utility for Patch-Adams
@@ -1129,6 +1203,19 @@ declare class Logger {
     setLevel(level: LogLevel): void;
 }
+/**
+ * Rise Course Structure Parser
+ *
+ * Extracts the hierarchical course structure (lessons + blocks) from a
+ * Rise SCORM ZIP package by parsing the embedded base64-encoded course JSON.
+ */
+/**
+ * Extract course structure from a Rise SCORM ZIP buffer.
+ * Returns null if the ZIP is not a Rise package or parsing fails.
+ */
+declare function extractCourseStructure(zipBuffer: Buffer): CourseStructure | null;
 /**
  * Plugin Registry for Patch-Adams
  *
@@ -1198,4 +1285,4 @@ declare class PluginRegistry {
  */
 declare const pluginRegistry: PluginRegistry;
-export { type AsyncAssetConfig, AsyncAssetConfigSchema, type AuthoringTool, AuthoringToolDetector, type AuthoringToolInfo, type BlockingAssetConfig, BlockingAssetConfigSchema, type CourseFingerprint, type CourseMetadata, type CssAfterOptions, type CssBeforeOptions, DEFAULT_LRS_OPTIONS, FormatDetector, type GeneratedPluginAssets, HtmlInjector, type JsAfterOptions, type JsBeforeOptions, type LocalFoldersConfig, LocalFoldersConfigSchema, type LogLevel, Logger, type LrsBridgeConfig, LrsBridgeConfigSchema, type LrsBridgeOptions, type ManifestPaths, ManifestUpdater, type PackageFormat, type PatchAdamsConfig, PatchAdamsConfigSchema, type PatchAdamsPlugin, type PatchOptions, type PatchResult, Patcher, type PluginAssets, type PluginConfig, PluginRegistry, type PluginsConfig, StorylineHtmlInjector, buildCssAfterOptions, buildCssBeforeOptions, buildJsAfterOptions, buildJsBeforeOptions, defaultConfig, extractCourseFingerprint, extractCourseMetadata, generateConfigTemplate, generateCssAfterLoader, generateCssBeforeLoader, generateJsAfterLoader, generateJsBeforeLoader, generateLrsBridgeCode, loadConfig, mergeWithDefaults, pluginRegistry };
+export { type AsyncAssetConfig, AsyncAssetConfigSchema, type AuthoringTool, AuthoringToolDetector, type AuthoringToolInfo, type BlockingAssetConfig, BlockingAssetConfigSchema, type CourseClassMappings, type CourseFingerprint, type CourseMetadata, type CourseStructure, type CourseStructureBlock, type CourseStructureLesson, type CssAfterOptions, type CssBeforeOptions, DEFAULT_LRS_OPTIONS, FormatDetector, type GeneratedPluginAssets, HtmlInjector, type JsAfterOptions, type JsBeforeOptions, type LocalFoldersConfig, LocalFoldersConfigSchema, type LogLevel, Logger, type LrsBridgeConfig, LrsBridgeConfigSchema, type LrsBridgeOptions, type ManifestPaths, ManifestUpdater, type PackageFormat, type PatchAdamsConfig, PatchAdamsConfigSchema, type PatchAdamsPlugin, type PatchOptions, type PatchResult, Patcher, type PluginAssets, type PluginConfig, PluginRegistry, type PluginsConfig, StorylineHtmlInjector, buildCssAfterOptions, buildCssBeforeOptions, buildJsAfterOptions, buildJsBeforeOptions, defaultConfig, extractCourseFingerprint, extractCourseMetadata, extractCourseStructure, generateClassMappingsScript, generateConfigTemplate, generateCssAfterLoader, generateCssBeforeLoader, generateJsAfterLoader, generateJsBeforeLoader, generateLrsBridgeCode, hasClassMappings, loadConfig, mergeWithDefaults, pluginRegistry };

package/dist/index.js CHANGED Viewed

@@ -5306,7 +5306,6 @@ window.pa_patcher = window.pa_patcher || {
     try {
       var xhr = new XMLHttpRequest();
       xhr.open('GET', ASSET_VERSION_URL, false);
-      xhr.timeout = 2000;
       xhr.send();
       if (xhr.status === 200) {
         window.__pa_v = JSON.parse(xhr.responseText).v || '1';
@@ -5688,6 +5687,139 @@ function buildSkinJsOptions(config) {
   };
 }
+// src/templates/class-mappings.ts
+function hasClassMappings(mappings) {
+  if (!mappings) return false;
+  if (mappings.course?.trim()) return true;
+  if (mappings.lessons && Object.values(mappings.lessons).some((v) => v?.trim())) return true;
+  if (mappings.blocks && Object.values(mappings.blocks).some((v) => v?.trim())) return true;
+  return false;
+}
+function generateClassMappingsScript(mappings) {
+  if (!hasClassMappings(mappings)) return "";
+  const courseClasses = (mappings.course || "").trim();
+  const blockMap = {};
+  const lessonMap = {};
+  if (mappings.blocks) {
+    for (const [id, classes] of Object.entries(mappings.blocks)) {
+      const trimmed = classes?.trim();
+      if (trimmed) blockMap[id] = trimmed;
+    }
+  }
+  if (mappings.lessons) {
+    for (const [id, classes] of Object.entries(mappings.lessons)) {
+      const trimmed = classes?.trim();
+      if (trimmed) lessonMap[id] = trimmed;
+    }
+  }
+  const hasBlocks = Object.keys(blockMap).length > 0;
+  const hasLessons = Object.keys(lessonMap).length > 0;
+  const parts = [];
+  parts.push(`// PA-Patcher: Custom Class Mappings`);
+  parts.push(`(function() {`);
+  parts.push(`  'use strict';`);
+  parts.push(``);
+  if (courseClasses) {
+    parts.push(`  // Course-level classes (applied to <html>)`);
+    parts.push(`  var courseClasses = ${JSON.stringify(courseClasses)};`);
+    parts.push(`  courseClasses.split(' ').forEach(function(cls) {`);
+    parts.push(`    if (cls) document.documentElement.classList.add(cls);`);
+    parts.push(`  });`);
+    parts.push(``);
+  }
+  if (hasBlocks) {
+    parts.push(`  // Block-level classes (applied to [data-block-id] elements)`);
+    parts.push(`  var blockMap = ${JSON.stringify(blockMap)};`);
+    parts.push(``);
+    parts.push(`  function applyBlockClasses() {`);
+    parts.push(`    var ids = Object.keys(blockMap);`);
+    parts.push(`    for (var i = 0; i < ids.length; i++) {`);
+    parts.push(`      var el = document.querySelector('[data-block-id="' + ids[i] + '"]');`);
+    parts.push(`      if (el) {`);
+    parts.push(`        var classes = blockMap[ids[i]].split(' ');`);
+    parts.push(`        for (var j = 0; j < classes.length; j++) {`);
+    parts.push(`          if (classes[j]) el.classList.add(classes[j]);`);
+    parts.push(`        }`);
+    parts.push(`      }`);
+    parts.push(`    }`);
+    parts.push(`  }`);
+    parts.push(``);
+  }
+  if (hasLessons) {
+    parts.push(`  // Lesson-level classes (toggled on <html> via hash navigation)`);
+    parts.push(`  var lessonMap = ${JSON.stringify(lessonMap)};`);
+    parts.push(`  var allLessonClasses = [];`);
+    parts.push(`  Object.keys(lessonMap).forEach(function(id) {`);
+    parts.push(`    lessonMap[id].split(' ').forEach(function(cls) {`);
+    parts.push(`      if (cls && allLessonClasses.indexOf(cls) === -1) allLessonClasses.push(cls);`);
+    parts.push(`    });`);
+    parts.push(`  });`);
+    parts.push(``);
+    parts.push(`  var currentLessonId = null;`);
+    parts.push(``);
+    parts.push(`  function detectCurrentLesson() {`);
+    parts.push(`    var hash = window.location.hash || '';`);
+    parts.push(`    var match = hash.match(/#\\/lessons\\/([^/]+)/);`);
+    parts.push(`    return match ? match[1] : null;`);
+    parts.push(`  }`);
+    parts.push(``);
+    parts.push(`  function applyLessonClasses() {`);
+    parts.push(`    var lessonId = detectCurrentLesson();`);
+    parts.push(`    if (lessonId === currentLessonId) return;`);
+    parts.push(`    currentLessonId = lessonId;`);
+    parts.push(`    for (var i = 0; i < allLessonClasses.length; i++) {`);
+    parts.push(`      document.documentElement.classList.remove(allLessonClasses[i]);`);
+    parts.push(`    }`);
+    parts.push(`    if (lessonId && lessonMap[lessonId]) {`);
+    parts.push(`      var classes = lessonMap[lessonId].split(' ');`);
+    parts.push(`      for (var j = 0; j < classes.length; j++) {`);
+    parts.push(`        if (classes[j]) document.documentElement.classList.add(classes[j]);`);
+    parts.push(`      }`);
+    parts.push(`    }`);
+    parts.push(`  }`);
+    parts.push(``);
+  }
+  parts.push(`  // Initialization`);
+  parts.push(`  function init() {`);
+  if (hasBlocks) {
+    parts.push(`    applyBlockClasses();`);
+  }
+  if (hasLessons) {
+    parts.push(`    applyLessonClasses();`);
+    parts.push(``);
+    parts.push(`    // Watch for Rise SPA navigation`);
+    parts.push(`    window.addEventListener('hashchange', function() {`);
+    parts.push(`      applyLessonClasses();`);
+    if (hasBlocks) {
+      parts.push(`      setTimeout(applyBlockClasses, 200);`);
+    }
+    parts.push(`    });`);
+  }
+  if (hasBlocks) {
+    parts.push(``);
+    parts.push(`    // MutationObserver for lazily-rendered Rise blocks`);
+    parts.push(`    var observer = new MutationObserver(function(mutations) {`);
+    parts.push(`      for (var i = 0; i < mutations.length; i++) {`);
+    parts.push(`        if (mutations[i].addedNodes.length > 0) {`);
+    parts.push(`          applyBlockClasses();`);
+    parts.push(`          return;`);
+    parts.push(`        }`);
+    parts.push(`      }`);
+    parts.push(`    });`);
+    parts.push(`    var container = document.querySelector('#app') || document.body;`);
+    parts.push(`    observer.observe(container, { childList: true, subtree: true });`);
+  }
+  parts.push(`  }`);
+  parts.push(``);
+  parts.push(`  if (document.readyState === 'loading') {`);
+  parts.push(`    document.addEventListener('DOMContentLoaded', init);`);
+  parts.push(`  } else {`);
+  parts.push(`    init();`);
+  parts.push(`  }`);
+  parts.push(`})();`);
+  return parts.join("\n");
+}
 // src/patcher/html-injector.ts
 var HtmlInjector = class {
   config;
@@ -7078,6 +7210,13 @@ var Patcher = class {
         console.log(`[Patcher] Fetched ${fetchedCount} remote files`);
       }
       const pluginAssets = this.generatePluginAssets();
+      if (hasClassMappings(options.classMappings)) {
+        const classMappingsJs = generateClassMappingsScript(options.classMappings);
+        if (classMappingsJs) {
+          pluginAssets.jsAfter = classMappingsJs + (pluginAssets.jsAfter ? "\n" + pluginAssets.jsAfter : "");
+          console.log("[Patcher] Class mappings JS will be injected inline into HTML");
+        }
+      }
       const hasPluginAssets = pluginAssets.cssBefore || pluginAssets.cssAfter || pluginAssets.jsBefore || pluginAssets.jsAfter;
       if (hasPluginAssets) {
         htmlInjector.setPluginAssets(pluginAssets);
@@ -7437,7 +7576,88 @@ var Logger = class {
     this.level = level;
   }
 };
+var DESERIALIZE_REGEX = /deserialize\s*\(\s*["']([A-Za-z0-9+/=]+)["']\s*\)/;
+var RISE_HTML_PATHS = [
+  "scormcontent/index.html",
+  "index.html"
+];
+function extractCourseStructure(zipBuffer) {
+  try {
+    const zip = new AdmZip(zipBuffer);
+    let htmlContent = null;
+    for (const path of RISE_HTML_PATHS) {
+      const entry = zip.getEntry(path);
+      if (entry) {
+        htmlContent = entry.getData().toString("utf-8");
+        if (DESERIALIZE_REGEX.test(htmlContent)) break;
+        htmlContent = null;
+      }
+    }
+    if (!htmlContent) {
+      return null;
+    }
+    const match = htmlContent.match(DESERIALIZE_REGEX);
+    if (!match || !match[1]) {
+      return null;
+    }
+    const jsonStr = Buffer.from(match[1], "base64").toString("utf-8");
+    const data = JSON.parse(jsonStr);
+    const course = data.course;
+    if (!course || !Array.isArray(course.lessons)) {
+      return null;
+    }
+    const lessons = course.lessons.filter((lesson) => !lesson.deleted).sort((a, b) => (a.position ?? 0) - (b.position ?? 0)).map((lesson) => {
+      const blocks = (lesson.items || []).map((block) => {
+        const structBlock = {
+          id: block.id,
+          type: block.type || "unknown"
+        };
+        if (block.family) structBlock.family = block.family;
+        if (block.variant) structBlock.variant = block.variant;
+        const title = deriveBlockTitle(block);
+        if (title) structBlock.title = title;
+        return structBlock;
+      });
+      return {
+        id: lesson.id,
+        title: lesson.title || "Untitled Lesson",
+        type: lesson.type || "blocks",
+        blocks
+      };
+    });
+    return {
+      courseTitle: course.title || course.name || "Untitled Course",
+      courseId: course.id || void 0,
+      lessons
+    };
+  } catch {
+    return null;
+  }
+}
+function deriveBlockTitle(block) {
+  if (block.title && typeof block.title === "string") {
+    return stripHtml(block.title).substring(0, 80);
+  }
+  const items = block.items;
+  if (!Array.isArray(items) || items.length === 0) return void 0;
+  const firstItem = items[0];
+  if (!firstItem) return void 0;
+  if (firstItem.heading) {
+    return stripHtml(firstItem.heading).substring(0, 80);
+  }
+  if (firstItem.title && typeof firstItem.title === "string") {
+    return stripHtml(firstItem.title).substring(0, 80);
+  }
+  if (firstItem.paragraph) {
+    const text = stripHtml(firstItem.paragraph).substring(0, 60);
+    if (text) return text + (firstItem.paragraph.length > 60 ? "..." : "");
+  }
+  return void 0;
+}
+function stripHtml(html) {
+  return html.replace(/<[^>]*>/g, "").trim();
+}
-export { AsyncAssetConfigSchema, AuthoringToolDetector, BlockingAssetConfigSchema, DEFAULT_LRS_OPTIONS, FormatDetector, HtmlInjector, LocalFoldersConfigSchema, Logger, LrsBridgeConfigSchema, ManifestUpdater, PatchAdamsConfigSchema, Patcher, PluginRegistry, StorylineHtmlInjector, buildCssAfterOptions, buildCssBeforeOptions, buildJsAfterOptions, buildJsBeforeOptions, defaultConfig, extractCourseFingerprint, extractCourseMetadata, generateConfigTemplate, generateCssAfterLoader, generateCssBeforeLoader, generateJsAfterLoader, generateJsBeforeLoader, generateLrsBridgeCode, loadConfig, mergeWithDefaults, pluginRegistry };
+export { AsyncAssetConfigSchema, AuthoringToolDetector, BlockingAssetConfigSchema, DEFAULT_LRS_OPTIONS, FormatDetector, HtmlInjector, LocalFoldersConfigSchema, Logger, LrsBridgeConfigSchema, ManifestUpdater, PatchAdamsConfigSchema, Patcher, PluginRegistry, StorylineHtmlInjector, buildCssAfterOptions, buildCssBeforeOptions, buildJsAfterOptions, buildJsBeforeOptions, defaultConfig, extractCourseFingerprint, extractCourseMetadata, extractCourseStructure, generateClassMappingsScript, generateConfigTemplate, generateCssAfterLoader, generateCssBeforeLoader, generateJsAfterLoader, generateJsBeforeLoader, generateLrsBridgeCode, hasClassMappings, loadConfig, mergeWithDefaults, pluginRegistry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map