scorm-review 1.1.0 → 1.3.0

package/README.md

@@ -0,0 +1,361 @@
+# scorm-review
+
+> Inject the **coreview** annotation tool into any SCORM package — no server, no browser extension, no setup needed on the reviewer's end.
+
+---
+
+## Table of Contents
+
+- [What it does](#what-it-does)
+- [How it works](#how-it-works)
+- [Requirements](#requirements)
+- [Installation](#installation)
+  - [Option A — Use with npx (no install)](#option-a--use-with-npx-no-install)
+  - [Option B — Install globally](#option-b--install-globally)
+- [Usage](#usage)
+  - [Convert a SCORM zip](#convert-a-scorm-zip)
+  - [Convert a SCORM folder](#convert-a-scorm-folder)
+  - [Convert a plain HTML file](#convert-a-plain-html-file)
+  - [Specify a custom output path](#specify-a-custom-output-path)
+  - [Show help](#show-help)
+- [Output explained](#output-explained)
+- [What gets changed inside your package](#what-gets-changed-inside-your-package)
+- [How to send to a reviewer](#how-to-send-to-a-reviewer)
+- [CLI reference](#cli-reference)
+- [How it works internally](#how-it-works-internally)
+  - [Entry point detection](#entry-point-detection)
+  - [Script injection](#script-injection)
+  - [coreview.js bundling](#coreviewjs-bundling)
+- [Project structure](#project-structure)
+- [Building from source](#building-from-source)
+- [Troubleshooting](#troubleshooting)
+
+---
+
+## What it does
+
+`scorm-review` takes a SCORM package (zip file, unzipped folder, or a standalone HTML file) and injects the **coreview** annotation tool into it. The output is a new file your reviewers can open in any browser and leave comments directly on the slides — no install needed on their end.
+
+```
+Before:  my-course.zip           ← plain SCORM package
+After:   my-course_review.zip    ← same package + annotation panel built in
+```
+
+Reviewers open `index.html` from the output zip and the annotation sidebar appears automatically.
+
+---
+
+## How it works
+
+1. Opens the input (zip, folder, or HTML file)
+2. Finds the HTML entry point (`index.html`)
+3. Injects a `<script>` tag referencing `coreview.js` into that HTML file
+4. Adds `coreview.js` (the annotation tool) next to the entry HTML
+5. Saves the modified package as a new zip (or HTML file for single-file input)
+
+The original file is never modified. A new `_review` file is always created.
+
+---
+
+## Requirements
+
+- [Node.js](https://nodejs.org/) **v18 or higher**
+
+That's all. No other tools, no browser extensions, no server.
+
+To check your Node.js version:
+
+```bash
+node --version
+# Should print v18.x.x or higher
+```
+
+If you don't have Node.js, download the LTS version from [nodejs.org](https://nodejs.org).
+
+---
+
+## Installation
+
+### Option A — Use with npx (no install)
+
+Run it directly without installing anything:
+
+```bash
+npx scorm-review ./my-course.zip
+```
+
+`npx` is included with Node.js. On first run it fetches the package automatically.
+
+### Option B — Install globally
+
+Install once, use from anywhere without the `npx` prefix:
+
+```bash
+npm install -g scorm-review
+```
+
+Then:
+
+```bash
+scorm-review ./my-course.zip
+```
+
+---
+
+## Usage
+
+### Convert a SCORM zip
+
+```bash
+npx scorm-review ./my-course.zip
+```
+
+Output in the same folder:
+
+```
+Input:  my-course.zip
+Output: C:\path\to\my-course_review.zip
+
+Processing SCORM zip... done.
+
+✓ Created: my-course_review.zip (15.2 MB)
+```
+
+### Convert a SCORM folder
+
+If your SCORM package is already unzipped:
+
+```bash
+npx scorm-review ./my-course/
+```
+
+The tool walks the folder, finds `index.html`, injects the annotation tool, and packages everything back into a zip.
+
+### Convert a plain HTML file
+
+For a standalone HTML file (not a SCORM package):
+
+```bash
+npx scorm-review ./page.html
+```
+
+Output: `page_review.html` — the script is embedded inline so no separate `coreview.js` file is needed.
+
+### Specify a custom output path
+
+Use `-o` or `--output` to choose where the output file is saved:
+
+```bash
+npx scorm-review ./my-course.zip -o ./output/my-course_review.zip
+```
+
+The output directory is created automatically if it doesn't exist.
+
+### Show help
+
+```bash
+npx scorm-review --help
+```
+
+---
+
+## Output explained
+
+| Input | Output file | Notes |
+|---|---|---|
+| `my-course.zip` | `my-course_review.zip` | New zip with `coreview.js` added and `index.html` injected |
+| `my-course/` (folder) | `my-course_review.zip` | Folder re-zipped with `coreview.js` added and `index.html` injected |
+| `page.html` | `page_review.html` | Single file — script embedded inline |
+
+The output is always saved **next to the input file** unless you specify `-o`.
+
+---
+
+## What gets changed inside your package
+
+Only two things change inside the output zip compared to the original:
+
+1. **`coreview.js` is added** — placed in the same folder as `index.html`
+2. **One `<script>` tag is added to `index.html`** — injected just before `</body>`
+
+```html
+<!-- Added by scorm-review -->
+<script
+  src="./coreview.js"
+  data-project="scorm-review"
+  data-note="Please review all slides. Check layout, wording, and content."
+  data-start-open="false">
+</script>
+```
+
+Everything else — folder structure, file names, SCORM manifest, assets — is **untouched**.
+
+If a `coreview.js` script tag already exists in the HTML, it is replaced rather than duplicated.
+
+---
+
+## How to send to a reviewer
+
+1. Run `scorm-review` on your SCORM package
+2. Send the `_review.zip` to your reviewer (email, shared drive, etc.)
+3. Reviewer unzips it and opens `index.html` in any modern browser (Chrome, Edge, Firefox, Safari)
+4. The annotation panel appears automatically — they can leave comments on any slide
+5. They share their annotated session back to you (via the coreview export feature)
+
+No installs, no accounts, no browser extensions required on the reviewer's side.
+
+---
+
+## CLI reference
+
+```
+scorm-review <input> [options]
+
+Arguments:
+  <input>              Path to a .zip file, a folder, or a .html file
+
+Options:
+  -o, --output <path>  Custom output file path (default: <name>_review.zip next to input)
+  -h, --help           Show help message
+
+Supported input types:
+  .zip                 SCORM package zip file
+  folder/              Unzipped SCORM package directory
+  .html / .htm         Plain HTML file
+
+Exit codes:
+  0    Success
+  1    Error (path not found, unsupported file type, no HTML entry point found)
+```
+
+---
+
+## How it works internally
+
+### Entry point detection
+
+The tool looks for the HTML entry point in this priority order:
+
+1. `index.html` at the root of the zip/folder
+2. `Index.html` at the root (case-insensitive fallback)
+3. `<subfolder>/index.html` — one level deep (common in SCORM packages where content is inside `scorm_package/`)
+4. Any `.html` file anywhere in the package
+
+If no HTML file is found, the tool exits with an error.
+
+### Script injection
+
+The `<script>` tag is injected just before `</body>`. If the HTML has no `</body>` tag, the script is appended to the end of the file.
+
+Any existing `coreview.js` script tags are removed before injecting the new one — so re-running the tool on an already-injected package is safe and idempotent.
+
+### coreview.js bundling
+
+`coreview.js` is **baked into the CLI binary at build time** using esbuild. This means:
+
+- The CLI is a single file with no runtime file dependencies
+- The same version of the annotation tool ships with every release
+- No network access is needed at runtime — everything is self-contained
+
+---
+
+## Project structure
+
+```
+scorm-review-cli/
+├── src/
+│   ├── cli.ts               # Entry point — argument parsing, file I/O, orchestration
+│   ├── bundler.ts           # Core logic — zip handling, HTML injection, folder packing
+│   └── bundler-template.ts  # Template used during the build to embed coreview.js
+├── dist/                    # Compiled output (generated by build)
+│   └── cli.js               # Single-file compiled CLI (published to npm)
+├── build.mjs                # esbuild build script — compiles + inlines coreview.js
+├── tsconfig.json            # TypeScript configuration
+└── package.json
+```
+
+### Key files
+
+**`src/cli.ts`** — Handles all CLI concerns: argument parsing, input validation, calling the right bundler function, and writing the output file. Contains no bundling logic itself.
+
+**`src/bundler.ts`** — Contains three exported functions:
+- `bundleScormZip(zipBuffer, coreviewScript)` — processes a zip Buffer
+- `bundleScormFolder(folderPath, coreviewScript)` — processes a folder on disk
+- `bundlePlainHtml(htmlBuffer, coreviewScript)` — processes a standalone HTML file
+
+**`build.mjs`** — esbuild script that reads `coreview.js` from disk, base64-encodes it (or inlines it as a string), and substitutes the `__COREVIEW_SCRIPT__` constant at bundle time. The result is `dist/cli.js`, a single portable file with no external dependencies.
+
+---
+
+## Building from source
+
+```bash
+# Install dev dependencies
+npm install
+
+# Build dist/cli.js
+npm run build
+```
+
+The build script (`build.mjs`) uses esbuild to:
+1. Compile TypeScript to JavaScript
+2. Bundle all imports into a single file
+3. Inline `coreview.js` as a string constant at build time
+4. Output `dist/cli.js` with the Node.js shebang line
+
+To test the built binary locally:
+
+```bash
+node dist/cli.js ./samplefolder/sample3.zip
+```
+
+---
+
+## Troubleshooting
+
+**`npx: command not found`**
+
+Node.js is not installed or not on your PATH. Download from [nodejs.org](https://nodejs.org) and reinstall.
+
+---
+
+**`Error: Path not found: ...`**
+
+The file or folder you specified doesn't exist at that path. Check for typos, or use the full absolute path:
+
+```bash
+npx scorm-review "C:\Users\yourname\Desktop\my-course.zip"
+```
+
+---
+
+**`Error: No HTML entry point found`**
+
+The zip doesn't contain an `index.html`. Possible causes:
+- You pointed at a zip that isn't a SCORM package
+- The SCORM package has a non-standard entry point (e.g. `story.html` instead of `index.html`)
+- The `index.html` is nested more than one level deep
+
+Try unzipping manually and pointing the tool at the folder that contains `index.html`:
+
+```bash
+npx scorm-review ./unzipped-course/
+```
+
+---
+
+**`Error: Unsupported file type ".pptx"`**
+
+Only `.zip`, `.html`, `.htm`, and folders are accepted. Other file types are not supported.
+
+---
+
+**Output zip is much larger than the original**
+
+This is expected when the original zip used maximum compression. The tool re-compresses with level 6 (balanced), which may produce a slightly larger file compared to an original that was compressed at level 9. The content is identical.
+
+---
+
+**Running the tool again on a `_review.zip` adds a second injection**
+
+Re-running on an already-processed file is safe — the tool removes any existing `coreview.js` script tag before injecting a new one, so no duplication occurs.

package/dist/cli.js

@@ -9702,9 +9702,9 @@ var require_load = __commonJS({
 var require_lib3 = __commonJS({
   "node_modules/jszip/lib/index.js"(exports2, module2) {
     "use strict";
-    function JSZip3() {
-      if (!(this instanceof JSZip3)) {
-        return new JSZip3();
+    function JSZip2() {
+      if (!(this instanceof JSZip2)) {
+        return new JSZip2();
       }
       if (arguments.length) {
         throw new Error("The constructor with parameters has been removed in JSZip 3.0, please check the upgrade guide.");
@@ -9713,7 +9713,7 @@ var require_lib3 = __commonJS({
       this.comment = null;
       this.root = "";
       this.clone = function() {
-        var newObj = new JSZip3();
+        var newObj = new JSZip2();
         for (var i in this) {
           if (typeof this[i] !== "function") {
             newObj[i] = this[i];
@@ -9722,354 +9722,150 @@ var require_lib3 = __commonJS({
         return newObj;
       };
     }
-    JSZip3.prototype = require_object();
-    JSZip3.prototype.loadAsync = require_load();
-    JSZip3.support = require_support();
-    JSZip3.defaults = require_defaults();
-    JSZip3.version = "3.10.1";
-    JSZip3.loadAsync = function(content, options) {
-      return new JSZip3().loadAsync(content, options);
+    JSZip2.prototype = require_object();
+    JSZip2.prototype.loadAsync = require_load();
+    JSZip2.support = require_support();
+    JSZip2.defaults = require_defaults();
+    JSZip2.version = "3.10.1";
+    JSZip2.loadAsync = function(content, options) {
+      return new JSZip2().loadAsync(content, options);
     };
-    JSZip3.external = require_external();
-    module2.exports = JSZip3;
+    JSZip2.external = require_external();
+    module2.exports = JSZip2;
   }
 });
 
 // src/cli.ts
 var import_fs2 = __toESM(require("fs"));
 var import_path2 = __toESM(require("path"));
-var import_jszip2 = __toESM(require_lib3());
 
 // src/bundler.ts
 var import_jszip = __toESM(require_lib3());
 var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
-
-// src/bundler-template.ts
-var UNPACKER_SCRIPT = `
-document.addEventListener('DOMContentLoaded', async function() {
-  var loading = document.getElementById('__bundler_loading');
-  function setStatus(msg) { if (loading) loading.textContent = msg; }
-
-  window.addEventListener('error', function(e) {
-    var p = document.body || document.documentElement;
-    var d = document.getElementById('__bundler_err') || p.appendChild(document.createElement('div'));
-    d.id = '__bundler_err';
-    d.style.cssText = 'position:fixed;bottom:12px;left:12px;right:12px;font:12px/1.4 ui-monospace,monospace;background:#2a1215;color:#ff8a80;padding:10px 14px;border-radius:8px;border:1px solid #5c2b2e;z-index:99999;white-space:pre-wrap;max-height:40vh;overflow:auto';
-    d.textContent = (d.textContent ? d.textContent + '\\n' : '') +
-      '[bundle] ' + (e.message || e.type) +
-      (e.filename ? ' (' + e.filename.slice(0,60) + ':' + e.lineno + ')' : '');
-  }, true);
-
-  try {
-    var manifestEl = document.querySelector('script[type="__bundler/manifest"]');
-    var templateEl = document.querySelector('script[type="__bundler/template"]');
-    if (!manifestEl || !templateEl) {
-      setStatus('Error: missing bundle data');
-      return;
-    }
-
-    var manifest = JSON.parse(manifestEl.textContent);
-    var template = JSON.parse(templateEl.textContent);
-
-    var uuids = Object.keys(manifest);
-    setStatus('Unpacking ' + uuids.length + ' assets...');
-
-    var blobUrls = {};
-    await Promise.all(uuids.map(async function(uuid) {
-      var entry = manifest[uuid];
-      try {
-        var binaryStr = atob(entry.data);
-        var bytes = new Uint8Array(binaryStr.length);
-        for (var i = 0; i < binaryStr.length; i++) bytes[i] = binaryStr.charCodeAt(i);
-        var finalBytes = bytes;
-        if (entry.compressed && typeof DecompressionStream !== 'undefined') {
-          var ds = new DecompressionStream('gzip');
-          var writer = ds.writable.getWriter();
-          var reader = ds.readable.getReader();
-          writer.write(bytes); writer.close();
-          var chunks = [], totalLen = 0;
-          while (true) {
-            var res = await reader.read();
-            if (res.done) break;
-            chunks.push(res.value); totalLen += res.value.length;
-          }
-          finalBytes = new Uint8Array(totalLen);
-          var offset = 0;
-          for (var ci = 0; ci < chunks.length; ci++) { finalBytes.set(chunks[ci], offset); offset += chunks[ci].length; }
-        }
-        blobUrls[uuid] = URL.createObjectURL(new Blob([finalBytes], { type: entry.mime }));
-      } catch(err) {
-        console.error('Failed to decode asset ' + uuid + ':', err);
-        blobUrls[uuid] = URL.createObjectURL(new Blob([], { type: entry.mime }));
-      }
-    }));
-
-    setStatus('Rendering...');
-    for (var uuid of uuids) template = template.split(uuid).join(blobUrls[uuid]);
-
-    template = template.replace(/\\s+integrity="[^"]*"/gi, '').replace(/\\s+crossorigin="[^"]*"/gi, '');
-
-    var resourceScript = '<script>window.__resources = ' +
-      JSON.stringify({}).split('</' + 'script>').join('<\\\\/' + 'script>') +
-      ';</' + 'script>';
-
-    var headOpen = template.match(/<head[^>]*>/i);
-    if (headOpen) {
-      var hi = headOpen.index + headOpen[0].length;
-      template = template.slice(0, hi) + resourceScript + template.slice(hi);
-    }
-
-    var doc = new DOMParser().parseFromString(template, 'text/html');
-    document.documentElement.replaceWith(doc.documentElement);
-    var dead = Array.from(document.scripts);
-    for (var old of dead) {
-      var s = document.createElement('script');
-      for (var a of old.attributes) s.setAttribute(a.name, a.value);
-      s.textContent = old.textContent;
-      if ((s.type === 'text/babel' || s.type === 'text/jsx') && s.src) {
-        var r = await fetch(s.src);
-        s.textContent = await r.text();
-        s.removeAttribute('src');
-      }
-      var p = s.src ? new Promise(function(resolve) { s.onload = s.onerror = resolve; }) : null;
-      old.replaceWith(s);
-      if (p) await p;
-    }
-    if (window.Babel && typeof window.Babel.transformScriptTags === 'function') {
-      window.Babel.transformScriptTags();
-    }
-
-    // Inject annotate review tool
-    window.AnnotateConfig = {
-      project: document.title || 'scorm-review',
-      note: 'Please review all slides. Check layout, wording, and content.',
-      startOpen: false,
-      theme: 'auto'
-    };
-    await new Promise(function(resolve) {
-      var ann = document.createElement('script');
-      ann.id = '__annotate_inline';
-      ann.textContent = window.__ANNOTATE_SCRIPT__;
-      document.head.appendChild(ann);
-      resolve();
-    });
-
-  } catch(err) {
-    setStatus('Error unpacking: ' + err.message);
-    console.error('Bundle unpack error:', err);
+function findEntryHtml(files) {
+  const norm = files.map((f) => f.replace(/\\/g, "/"));
+  const rootCandidates = [
+    "index.html",
+    "Index.html",
+    "story.html",
+    "Story.html",
+    "index_lms.html",
+    "launch.html",
+    "default.html"
+  ];
+  for (const candidate of rootCandidates) {
+    const match = norm.find((f) => f.toLowerCase() === candidate.toLowerCase());
+    if (match) return match;
   }
-});
-`;
-var THUMBNAIL_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><rect width="100" height="100" fill="#6366f1"></rect><text x="50" y="58" font-size="32" font-family="Arial" font-weight="bold" text-anchor="middle" fill="#fff">\u25B6</text></svg>`;
-
-// src/bundler.ts
-var MIME_MAP = {
-  // Images
-  png: "image/png",
-  jpg: "image/jpeg",
-  jpeg: "image/jpeg",
-  gif: "image/gif",
-  webp: "image/webp",
-  svg: "image/svg+xml",
-  ico: "image/x-icon",
-  avif: "image/avif",
-  // Audio / Video
-  mp3: "audio/mpeg",
-  mp4: "video/mp4",
-  ogg: "audio/ogg",
-  ogv: "video/ogg",
-  wav: "audio/wav",
-  webm: "video/webm",
-  m4a: "audio/m4a",
-  // Fonts
-  woff: "font/woff",
-  woff2: "font/woff2",
-  ttf: "font/ttf",
-  otf: "font/otf",
-  eot: "application/vnd.ms-fontobject",
-  // Scripts / Styles
-  js: "application/javascript",
-  mjs: "application/javascript",
-  css: "text/css",
-  json: "application/json",
-  xml: "application/xml",
-  // Docs
-  pdf: "application/pdf"
-};
-function getMime(filename) {
-  const ext = filename.split(".").pop()?.toLowerCase() ?? "";
-  return MIME_MAP[ext] ?? "application/octet-stream";
-}
-function makeUUID() {
-  const hex = () => Math.floor(Math.random() * 4294967295).toString(16).padStart(8, "0");
-  return `${hex()}-${hex().slice(0, 4)}-4${hex().slice(0, 3)}-${hex().slice(0, 4)}-${hex()}${hex().slice(0, 4)}`;
+  const nestedCandidates = ["index.html", "story.html", "index_lms.html", "launch.html", "default.html"];
+  for (const candidate of nestedCandidates) {
+    const match = norm.find((f) => new RegExp(`^[^/]+/${candidate}$`, "i").test(f));
+    if (match) return match;
+  }
+  const rootHtml = norm.find((f) => /^[^/]+\.html?$/i.test(f));
+  if (rootHtml) return rootHtml;
+  const anyHtml = norm.find((f) => /\.html?$/i.test(f));
+  return anyHtml ?? null;
 }
-function escapeForJsonString(s) {
-  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+function injectCoreviewTag(html) {
+  const scriptTag = `<script src="./coreview.js" data-project="scorm-review" data-note="Please review all slides. Check layout, wording, and content." data-start-open="false"></script>`;
+  html = html.replace(/<script[^>]*src="[^"]*coreview\.js"[^>]*><\/script>\s*/gi, "");
+  const hasBody = /<\/body>/i.test(html);
+  const hasHtml = /<\/html>/i.test(html);
+  if (hasBody && hasHtml) {
+    const bodyIdx = html.search(/<\/body>/i);
+    const htmlIdx = html.search(/<\/html>/i);
+    const betweenBodyAndHtml = html.slice(bodyIdx + "</body>".length, htmlIdx).trim();
+    if (betweenBodyAndHtml.length > 0) {
+      return html.replace(/<\/html>/i, `${scriptTag}
+</html>`);
+    }
+    return html.replace(/<\/body>/i, `${scriptTag}
+</body>`);
+  }
+  if (hasBody) {
+    return html.replace(/<\/body>/i, `${scriptTag}
+</body>`);
+  }
+  if (hasHtml) {
+    return html.replace(/<\/html>/i, `${scriptTag}
+</html>`);
+  }
+  return html + "\n" + scriptTag;
 }
-async function bundleScormZip(zipBuffer, annotateScript) {
+async function bundleScormZip(zipBuffer, coreviewScript) {
   const zip = await import_jszip.default.loadAsync(zipBuffer);
-  const entryPath = findEntryHtml(zip);
+  const fileNames = Object.keys(zip.files).filter((f) => !zip.files[f].dir);
+  const entryPath = findEntryHtml(fileNames);
   if (!entryPath) throw new Error("No HTML entry point found in the zip file.");
-  const entryFile = zip.file(entryPath);
-  if (!entryFile) throw new Error(`Entry file "${entryPath}" could not be read.`);
-  const templateHtml = await entryFile.async("string");
   const entryDir = entryPath.includes("/") ? entryPath.slice(0, entryPath.lastIndexOf("/") + 1) : "";
-  const manifest = {};
-  const uuidMap = {};
-  const files = Object.values(zip.files).filter((f) => !f.dir);
-  for (const file of files) {
-    if (file.name === entryPath) continue;
-    if (file.name.endsWith("imsmanifest.xml")) continue;
-    if (file.name.endsWith(".bat")) continue;
-    const mime = getMime(file.name);
-    const data = await file.async("base64");
-    const uuid = makeUUID();
-    manifest[uuid] = { mime, data, compressed: false };
-    const relPath = entryDir && file.name.startsWith(entryDir) ? file.name.slice(entryDir.length) : file.name;
-    uuidMap[relPath] = uuid;
-    if (relPath !== file.name) uuidMap[file.name] = uuid;
-  }
-  let processedHtml = replaceAssetRefs(templateHtml, uuidMap);
-  processedHtml = stripExistingBundle(processedHtml);
-  return buildOutputHtml(processedHtml, manifest, annotateScript);
+  const entryFile = zip.file(entryPath);
+  if (!entryFile) throw new Error(`Could not read entry file: ${entryPath}`);
+  const originalHtml = await entryFile.async("string");
+  const modifiedHtml = injectCoreviewTag(originalHtml);
+  zip.file(entryPath, modifiedHtml);
+  zip.file(`${entryDir}coreview.js`, coreviewScript);
+  return zip.generateAsync({
+    type: "nodebuffer",
+    compression: "DEFLATE",
+    compressionOptions: { level: 6 }
+  });
 }
-async function bundleScormFolder(folderPath, annotateScript) {
-  function collectFiles(dir, baseDir) {
+async function bundleScormFolder(folderPath, coreviewScript) {
+  function collectFiles(dir) {
     const results = [];
     for (const entry of import_fs.default.readdirSync(dir)) {
       const fullPath = import_path.default.join(dir, entry);
       const stat = import_fs.default.statSync(fullPath);
       if (stat.isDirectory()) {
-        results.push(...collectFiles(fullPath, baseDir));
+        results.push(...collectFiles(fullPath));
       } else {
         results.push(fullPath);
       }
     }
     return results;
   }
-  const allFiles = collectFiles(folderPath, folderPath);
+  const allFiles = collectFiles(folderPath);
   const relFiles = allFiles.map((f) => import_path.default.relative(folderPath, f).replace(/\\/g, "/"));
-  function findEntryHtmlInFiles(files) {
-    if (files.includes("index.html")) return "index.html";
-    if (files.includes("Index.html")) return "Index.html";
-    const nested = files.find((f) => /^[^/]+\/index\.html$/i.test(f));
-    if (nested) return nested;
-    const anyHtml = files.find((f) => /\.html?$/i.test(f));
-    return anyHtml ?? null;
-  }
-  const entryRelPath = findEntryHtmlInFiles(relFiles);
+  const entryRelPath = findEntryHtml(relFiles);
   if (!entryRelPath) throw new Error("No HTML entry point found in the folder.");
-  const entryAbsPath = import_path.default.join(folderPath, entryRelPath);
-  const templateHtml = import_fs.default.readFileSync(entryAbsPath, "utf-8");
-  const entryDir = entryRelPath.includes("/") ? entryRelPath.slice(0, entryRelPath.lastIndexOf("/") + 1) : "";
-  const manifest = {};
-  const uuidMap = {};
+  const zip = new import_jszip.default();
   for (const relFile of relFiles) {
-    if (relFile === entryRelPath) continue;
-    if (relFile.endsWith("imsmanifest.xml")) continue;
-    if (relFile.endsWith(".bat")) continue;
     if (import_path.default.basename(relFile) === ".DS_Store") continue;
     const absPath = import_path.default.join(folderPath, relFile);
-    const mime = getMime(relFile);
-    const data = import_fs.default.readFileSync(absPath).toString("base64");
-    const uuid = makeUUID();
-    manifest[uuid] = { mime, data, compressed: false };
-    const normalizedRel = relFile.replace(/\\/g, "/");
-    const relPath = entryDir && normalizedRel.startsWith(entryDir) ? normalizedRel.slice(entryDir.length) : normalizedRel;
-    uuidMap[relPath] = uuid;
-    if (relPath !== normalizedRel) uuidMap[normalizedRel] = uuid;
-  }
-  let processedHtml = replaceAssetRefs(templateHtml, uuidMap);
-  processedHtml = stripExistingBundle(processedHtml);
-  return buildOutputHtml(processedHtml, manifest, annotateScript);
-}
-function bundlePlainHtml(htmlBuffer, annotateScript) {
-  let html = htmlBuffer.toString("utf-8");
-  html = stripExistingBundle(html);
-  return injectAnnotate(html, annotateScript);
-}
-function findEntryHtml(zip) {
-  const files = Object.keys(zip.files);
-  if (zip.files["index.html"]) return "index.html";
-  if (zip.files["Index.html"]) return "Index.html";
-  const nested = files.find((f) => /^[^/]+\/index\.html$/i.test(f));
-  if (nested) return nested;
-  const anyHtml = files.find((f) => /\.html?$/i.test(f) && !zip.files[f].dir);
-  return anyHtml ?? null;
-}
-function replaceAssetRefs(html, uuidMap) {
-  const paths = Object.keys(uuidMap).sort((a, b) => b.length - a.length);
-  for (const refPath of paths) {
-    const uuid = uuidMap[refPath];
-    const escaped = refPath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    html = html.replace(new RegExp(escaped, "g"), uuid);
+    if (relFile === entryRelPath) {
+      const originalHtml = import_fs.default.readFileSync(absPath, "utf-8");
+      const modifiedHtml = injectCoreviewTag(originalHtml);
+      zip.file(relFile, modifiedHtml);
+    } else {
+      zip.file(relFile, import_fs.default.readFileSync(absPath));
+    }
   }
-  return html;
-}
-function stripExistingBundle(html) {
-  html = html.replace(/<script[^>]*type="__bundler\/manifest"[^>]*>[\s\S]*?<\/script>/gi, "");
-  html = html.replace(/<script[^>]*type="__bundler\/template"[^>]*>[\s\S]*?<\/script>/gi, "");
-  html = html.replace(/<script[^>]*type="__bundler\/ext_resources"[^>]*>[\s\S]*?<\/script>/gi, "");
-  html = html.replace(/<div[^>]*id="__bundler_thumbnail"[^>]*>[\s\S]*?<\/div>/gi, "");
-  html = html.replace(/<div[^>]*id="__bundler_loading"[^>]*>[^<]*<\/div>/gi, "");
-  html = html.replace(/<script[^>]*id="__annotate_inline"[^>]*>[\s\S]*?<\/script>/gi, "");
-  return html;
+  const entryDir = entryRelPath.includes("/") ? entryRelPath.slice(0, entryRelPath.lastIndexOf("/") + 1) : "";
+  zip.file(`${entryDir}coreview.js`, coreviewScript);
+  return zip.generateAsync({
+    type: "nodebuffer",
+    compression: "DEFLATE",
+    compressionOptions: { level: 6 }
+  });
 }
-function injectAnnotate(html, annotateScript) {
-  const annotateTag = `
-<script id="__annotate_inline">
-window.AnnotateConfig = {
-  project: document.title || 'review',
-  note: 'Please review this document. Check layout, wording, and content.',
-  startOpen: false,
-  theme: 'auto'
-};
-${annotateScript}
+function bundlePlainHtml(htmlBuffer, coreviewScript) {
+  const html = htmlBuffer.toString("utf-8");
+  const scriptTag = `<script id="__coreview_inline">
+window.AnnotateConfig = { project: document.title || 'review', note: 'Please review this document.', startOpen: false, theme: 'auto' };
+${coreviewScript}
 </script>`;
-  if (/<\/body>/i.test(html)) {
-    return html.replace(/<\/body>/i, `${annotateTag}
+  const cleaned = html.replace(/<script[^>]*id="__coreview_inline"[^>]*>[\s\S]*?<\/script>\s*/gi, "");
+  if (/<\/body>/i.test(cleaned)) {
+    return cleaned.replace(/<\/body>/i, `${scriptTag}
 </body>`);
   }
-  return html + annotateTag;
-}
-function buildOutputHtml(templateHtml, manifest, annotateScript) {
-  const titleMatch = templateHtml.match(/<title[^>]*>([^<]*)<\/title>/i);
-  const title = titleMatch ? titleMatch[1].trim() : "SCORM Review";
-  const manifestJson = JSON.stringify(manifest);
-  const templateJson = JSON.stringify(templateHtml);
-  const annotateEscaped = escapeForJsonString(annotateScript);
-  return `<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8">
-  <title>${title}</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body { background: #faf9f5; display: flex; align-items: center; justify-content: center; min-height: 100vh; font-family: -apple-system, BlinkMacSystemFont, sans-serif; }
-    #__bundler_loading { position: fixed; bottom: 20px; right: 20px; font: 13px/1.4 -apple-system, BlinkMacSystemFont, sans-serif; color: #666; background: #fff; padding: 8px 14px; border-radius: 8px; box-shadow: 0 1px 4px rgba(0,0,0,0.12); z-index: 10000; }
-    #__bundler_thumbnail { position: fixed; inset: 0; width: 100%; height: 100%; display: flex; align-items: center; justify-content: center; background: #faf9f5; z-index: 9999; }
-    #__bundler_thumbnail svg { width: 120px; height: 120px; }
-  </style>
-</head>
-<body>
-  <div id="__bundler_thumbnail">
-    ${THUMBNAIL_SVG}
-  </div>
-  <div id="__bundler_loading">Unpacking...</div>
-
-  <script>window.__ANNOTATE_SCRIPT__ = "${annotateEscaped}";</script>
-  <script>${UNPACKER_SCRIPT}</script>
-
-  <script type="__bundler/manifest">${manifestJson}</script>
-  <script type="__bundler/template">${templateJson}</script>
-</body>
-</html>`;
+  return cleaned + "\n" + scriptTag;
 }
 
 // src/cli.ts
-var ANNOTATE_SCRIPT = `\uFEFF/* =============================================================================\r
+var COREVIEW_SCRIPT = `\uFEFF/* =============================================================================\r
  * coreview.js \u2014 a drop-in visual review & annotation layer for any website.\r
  * Open-source edition \xB7 local-only \xB7 zero backend.\r
  *\r
@@ -12888,39 +12684,33 @@ var ANNOTATE_SCRIPT = `\uFEFF/* ================================================
 `;
 function printHelp() {
   console.log(`
-scorm-review \u2014 Convert SCORM packages to self-contained review HTML files
+scorm-review \u2014 Inject the coreview review tool into SCORM packages
 
 Usage:
   scorm-review <input>              Convert a .zip, folder, or .html file
-  scorm-review <input> -o <output>  Specify output base name (no extension)
+  scorm-review <input> -o <output>  Specify output file path
   scorm-review --help               Show this help message
 
 Examples:
   scorm-review ./my-course.zip
   scorm-review ./my-course/
   scorm-review ./page.html
-  scorm-review ./my-course.zip -o ./output/my-course
+  scorm-review ./my-course.zip -o ./output/my-course_review.zip
 
-Output (zip or folder input):
-  <name>_review_file.html   Self-contained review HTML
-  <name>_review.zip         Zip file containing the HTML (for easy sharing)
+Output:
+  .zip or folder input  \u2192  <name>_review.zip   (SCORM package with coreview.js added)
+  .html input           \u2192  <name>_review.html  (HTML with coreview injected inline)
 `);
 }
-function resolveOutputBase(inputPath, outputFlag) {
+function resolveOutputPath(inputPath, isFolder, ext, outputFlag) {
   if (outputFlag) return import_path2.default.resolve(outputFlag);
-  const resolved = import_path2.default.resolve(inputPath);
+  const resolved = import_path2.default.resolve(inputPath.replace(/[\\/]+$/, ""));
   const dir = import_path2.default.dirname(resolved);
-  const base = import_path2.default.basename(resolved.replace(/[\\/]+$/, ""), import_path2.default.extname(resolved));
-  return import_path2.default.join(dir, base);
-}
-async function createReviewZip(htmlContent, htmlFilename) {
-  const zip = new import_jszip2.default();
-  zip.file(htmlFilename, htmlContent);
-  return zip.generateAsync({
-    type: "nodebuffer",
-    compression: "DEFLATE",
-    compressionOptions: { level: 6 }
-  });
+  const base = import_path2.default.basename(resolved, isFolder ? "" : ext);
+  if (ext === ".html" || ext === ".htm") {
+    return import_path2.default.join(dir, base + "_review.html");
+  }
+  return import_path2.default.join(dir, base + "_review.zip");
 }
 async function main() {
   const args = process.argv.slice(2);
@@ -12955,43 +12745,38 @@ async function main() {
     console.error(`Error: Unsupported file type "${ext}". Only .zip, .html, .htm, or a folder are supported.`);
     process.exit(1);
   }
-  const outputBase = resolveOutputBase(resolvedInput, outputFlag);
-  const htmlFilename = import_path2.default.basename(outputBase) + "_review_file.html";
-  const htmlOutputPath = outputBase + "_review_file.html";
-  const zipOutputPath = outputBase + "_review.zip";
-  console.log(`Converting: ${import_path2.default.basename(resolvedInput)}${isFolder ? "/" : ""}`);
-  console.log(`HTML:       ${htmlOutputPath}`);
-  if (!ext || ext === ".zip") {
-    console.log(`ZIP:        ${zipOutputPath}`);
-  }
+  const outputPath = resolveOutputPath(inputPath, isFolder, ext, outputFlag);
+  console.log(`Input:  ${import_path2.default.basename(resolvedInput)}${isFolder ? "/" : ""}`);
+  console.log(`Output: ${outputPath}`);
   console.log("");
-  import_fs2.default.mkdirSync(import_path2.default.dirname(outputBase), { recursive: true });
+  import_fs2.default.mkdirSync(import_path2.default.dirname(outputPath), { recursive: true });
   try {
-    let outputHtml;
     if (isFolder) {
       process.stdout.write("Processing SCORM folder...");
-      outputHtml = await bundleScormFolder(resolvedInput, ANNOTATE_SCRIPT);
+      const zipBuffer = await bundleScormFolder(resolvedInput, COREVIEW_SCRIPT);
+      console.log(" done.");
+      import_fs2.default.writeFileSync(outputPath, zipBuffer);
+      const sizeMb = (zipBuffer.length / 1024 / 1024).toFixed(1);
+      console.log(`
+\u2713 Created: ${outputPath} (${sizeMb} MB)`);
     } else if (ext === ".zip") {
       process.stdout.write("Processing SCORM zip...");
       const fileBuffer = import_fs2.default.readFileSync(resolvedInput);
-      outputHtml = await bundleScormZip(fileBuffer, ANNOTATE_SCRIPT);
+      const zipBuffer = await bundleScormZip(fileBuffer, COREVIEW_SCRIPT);
+      console.log(" done.");
+      import_fs2.default.writeFileSync(outputPath, zipBuffer);
+      const sizeMb = (zipBuffer.length / 1024 / 1024).toFixed(1);
+      console.log(`
+\u2713 Created: ${outputPath} (${sizeMb} MB)`);
     } else {
       process.stdout.write("Processing HTML file...");
       const fileBuffer = import_fs2.default.readFileSync(resolvedInput);
-      outputHtml = bundlePlainHtml(fileBuffer, ANNOTATE_SCRIPT);
-    }
-    console.log(" done.");
-    import_fs2.default.writeFileSync(htmlOutputPath, outputHtml, "utf-8");
-    const htmlSizeMb = (Buffer.byteLength(outputHtml, "utf-8") / 1024 / 1024).toFixed(1);
-    console.log(`
-\u2713 HTML: ${htmlOutputPath} (${htmlSizeMb} MB)`);
-    if (isFolder || ext === ".zip") {
-      process.stdout.write("Creating review zip...");
-      const zipBuffer = await createReviewZip(outputHtml, htmlFilename);
-      import_fs2.default.writeFileSync(zipOutputPath, zipBuffer);
-      const zipSizeMb = (zipBuffer.length / 1024 / 1024).toFixed(1);
-      console.log(` done.`);
-      console.log(`\u2713 ZIP:  ${zipOutputPath} (${zipSizeMb} MB)`);
+      const outputHtml = bundlePlainHtml(fileBuffer, COREVIEW_SCRIPT);
+      console.log(" done.");
+      import_fs2.default.writeFileSync(outputPath, outputHtml, "utf-8");
+      const sizeMb = (Buffer.byteLength(outputHtml, "utf-8") / 1024 / 1024).toFixed(1);
+      console.log(`
+\u2713 Created: ${outputPath} (${sizeMb} MB)`);
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scorm-review",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Convert SCORM zip packages into self-contained review HTML files",
   "main": "dist/cli.js",
   "bin": {