@pagepocket/lib 0.12.0 → 0.14.5

package/dist/units/snapshot-unit.js

@@ -0,0 +1,58 @@
+import { applyReplaceElementsToFileTree } from "./apply-replace-elements-to-file-tree.js";
+import { FileTreeUnit } from "./file-tree-unit.js";
+/**
+ * Base class for units that produce the primary snapshot FileTree.
+ *
+ * `run()` delegates to `build()` and automatically:
+ * - Injects `snapshotType` into the returned patch.
+ * - Compiles all plugin-contributed element-replacement rules
+ *   (`rt.elements.compile()`) and applies them to every HTML file
+ *   in the returned FileTree.  Subclasses never need to call
+ *   `rt.elements.compile()` themselves.
+ *
+ * Subclasses implement `id`, `snapshotType`, and `build()`.
+ *
+ * ```ts
+ * export class MySnapshotUnit extends SnapshotUnit {
+ *   readonly id = "mySnapshot";
+ *   readonly snapshotType = "my-type";
+ *
+ *   async build(ctx, rt) {
+ *     return { files: buildFiles(), html: ctx.value.html };
+ *   }
+ * }
+ * ```
+ */
+export class SnapshotUnit extends FileTreeUnit {
+    async run(ctx, rt) {
+        const patch = await this.build(ctx, rt);
+        if (!patch) {
+            return;
+        }
+        const files = patch.files;
+        const replaceElements = await rt.elements.compile();
+        if (files && replaceElements.length > 0) {
+            const entryUrl = resolveEntryUrl(rt);
+            const updatedFiles = await applyReplaceElementsToFileTree({
+                files,
+                replaceElements,
+                entryUrl
+            });
+            return { ...patch, files: updatedFiles, snapshotType: this.snapshotType };
+        }
+        return { ...patch, snapshotType: this.snapshotType };
+    }
+}
+const resolveEntryUrl = (rt) => {
+    const entry = rt.entry;
+    if (entry.kind === "url") {
+        return entry.url;
+    }
+    if (entry.kind === "html-string" || entry.kind === "document") {
+        return entry.url ?? entry.baseUrl;
+    }
+    if (entry.kind === "puppeteer-page" || entry.kind === "cdp-tab") {
+        return entry.url ?? "";
+    }
+    return "";
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagepocket/lib",
-  "version": "0.12.0",
+  "version": "0.14.5",
   "description": "Library for rewriting HTML snapshots and inlining local resources.",
   "type": "module",
   "main": "dist/index.js",
@@ -20,9 +20,9 @@
   "dependencies": {
     "cheerio": "^1.0.0-rc.12",
     "domhandler": "^5.0.3",
-    "@pagepocket/contracts": "0.12.0",
-    "@pagepocket/uni-fs": "0.12.0",
-    "@pagepocket/shared": "0.12.0"
+    "@pagepocket/contracts": "0.14.5",
+    "@pagepocket/uni-fs": "0.14.5",
+    "@pagepocket/shared": "0.14.5"
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",