npm - @patch-adams/core - Versions diffs - 1.5.24 → 1.6.1 - Mend

@patch-adams/core 1.5.24 → 1.6.1

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.cjs CHANGED Viewed

@@ -5696,6 +5696,228 @@ 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;
+  if (mappings.blockGroups && mappings.blockGroups.length > 0) 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 blockGroups = (mappings.blockGroups || []).filter(
+    (g) => g.blockIds.length >= 2 && g.className.trim() && g.lessonId
+  );
+  const hasGroups = blockGroups.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(``);
+  }
+  if (hasGroups) {
+    const groupData = blockGroups.map((g) => ({
+      id: g.id,
+      lessonId: g.lessonId,
+      blockIds: g.blockIds,
+      className: g.className.trim()
+    }));
+    parts.push(`  // Block groups (adjacent blocks wrapped in container divs)`);
+    parts.push(`  var groupMap = ${JSON.stringify(groupData)};`);
+    parts.push(``);
+    parts.push(`  function applyBlockGroups() {`);
+    parts.push(`    var hash = window.location.hash || '';`);
+    parts.push(`    var match = hash.match(/#\\/lessons\\/([^/]+)/);`);
+    parts.push(`    var currentLesson = match ? match[1] : null;`);
+    parts.push(`    for (var g = 0; g < groupMap.length; g++) {`);
+    parts.push(`      var group = groupMap[g];`);
+    parts.push(`      if (group.lessonId !== currentLesson) continue;`);
+    parts.push(`      if (document.querySelector('[data-pa-group-id="' + group.id + '"]')) continue;`);
+    parts.push(`      var blocks = [];`);
+    parts.push(`      var allPresent = true;`);
+    parts.push(`      for (var b = 0; b < group.blockIds.length; b++) {`);
+    parts.push(`        var el = document.querySelector('[data-block-id="' + group.blockIds[b] + '"]');`);
+    parts.push(`        if (!el) { allPresent = false; break; }`);
+    parts.push(`        blocks.push(el);`);
+    parts.push(`      }`);
+    parts.push(`      if (!allPresent) continue;`);
+    parts.push(`      var parent = blocks[0].parentNode;`);
+    parts.push(`      var sameParent = true;`);
+    parts.push(`      for (var s = 1; s < blocks.length; s++) {`);
+    parts.push(`        if (blocks[s].parentNode !== parent) { sameParent = false; break; }`);
+    parts.push(`      }`);
+    parts.push(`      if (!sameParent) continue;`);
+    parts.push(`      var wrapper = document.createElement('div');`);
+    parts.push(`      wrapper.setAttribute('data-pa-group-id', group.id);`);
+    parts.push(`      var cls = group.className.split(' ');`);
+    parts.push(`      for (var c = 0; c < cls.length; c++) {`);
+    parts.push(`        if (cls[c]) wrapper.classList.add(cls[c]);`);
+    parts.push(`      }`);
+    parts.push(`      parent.insertBefore(wrapper, blocks[0]);`);
+    parts.push(`      for (var m = 0; m < blocks.length; m++) {`);
+    parts.push(`        wrapper.appendChild(blocks[m]);`);
+    parts.push(`      }`);
+    parts.push(`    }`);
+    parts.push(`  }`);
+    parts.push(``);
+    parts.push(`  function teardownBlockGroups() {`);
+    parts.push(`    var wrappers = document.querySelectorAll('[data-pa-group-id]');`);
+    parts.push(`    for (var w = 0; w < wrappers.length; w++) {`);
+    parts.push(`      var wr = wrappers[w];`);
+    parts.push(`      var par = wr.parentNode;`);
+    parts.push(`      while (wr.firstChild) {`);
+    parts.push(`        par.insertBefore(wr.firstChild, wr);`);
+    parts.push(`      }`);
+    parts.push(`      par.removeChild(wr);`);
+    parts.push(`    }`);
+    parts.push(`  }`);
+    parts.push(``);
+  }
+  parts.push(`  // Initialization`);
+  parts.push(`  function init() {`);
+  if (hasBlocks) {
+    parts.push(`    applyBlockClasses();`);
+  }
+  if (hasGroups) {
+    parts.push(`    applyBlockGroups();`);
+  }
+  if (hasLessons) {
+    parts.push(`    applyLessonClasses();`);
+  }
+  if (hasLessons || hasGroups) {
+    parts.push(``);
+    parts.push(`    // Watch for Rise SPA navigation`);
+    parts.push(`    window.addEventListener('hashchange', function() {`);
+    if (hasGroups) {
+      parts.push(`      teardownBlockGroups();`);
+    }
+    if (hasLessons) {
+      parts.push(`      applyLessonClasses();`);
+    }
+    if (hasBlocks) {
+      parts.push(`      setTimeout(applyBlockClasses, 200);`);
+    }
+    if (hasGroups) {
+      parts.push(`      setTimeout(applyBlockGroups, 300);`);
+    }
+    parts.push(`    });`);
+  }
+  if (hasBlocks || hasGroups) {
+    parts.push(``);
+    parts.push(`    // MutationObserver for lazily-rendered Rise blocks`);
+    if (hasGroups) {
+      parts.push(`    var debounceTimer = null;`);
+      parts.push(`    var observer = new MutationObserver(function() {`);
+      parts.push(`      if (debounceTimer) clearTimeout(debounceTimer);`);
+      parts.push(`      debounceTimer = setTimeout(function() {`);
+      if (hasBlocks) {
+        parts.push(`        applyBlockClasses();`);
+      }
+      parts.push(`        applyBlockGroups();`);
+      parts.push(`      }, 100);`);
+      parts.push(`    });`);
+    } else {
+      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;
@@ -7086,6 +7308,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);
@@ -7445,6 +7674,87 @@ 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__default.default(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();
+}
 exports.AsyncAssetConfigSchema = AsyncAssetConfigSchema;
 exports.AuthoringToolDetector = AuthoringToolDetector;
@@ -7467,12 +7777,15 @@ exports.buildJsBeforeOptions = buildJsBeforeOptions;
 exports.defaultConfig = defaultConfig;
 exports.extractCourseFingerprint = extractCourseFingerprint;
 exports.extractCourseMetadata = extractCourseMetadata;
+exports.extractCourseStructure = extractCourseStructure;
+exports.generateClassMappingsScript = generateClassMappingsScript;
 exports.generateConfigTemplate = generateConfigTemplate;
 exports.generateCssAfterLoader = generateCssAfterLoader;
 exports.generateCssBeforeLoader = generateCssBeforeLoader;
 exports.generateJsAfterLoader = generateJsAfterLoader;
 exports.generateJsBeforeLoader = generateJsBeforeLoader;
 exports.generateLrsBridgeCode = generateLrsBridgeCode;
+exports.hasClassMappings = hasClassMappings;
 exports.loadConfig = loadConfig;
 exports.mergeWithDefaults = mergeWithDefaults;
 exports.pluginRegistry = pluginRegistry;