@reidelsaltres/pureper 0.2.33 → 0.2.34

package/out/index.d.ts

@@ -7,14 +7,15 @@ export { default as UniHtml } from './foundation/component_api/UniHtml.js';
 export { default as Page } from './foundation/component_api/Page.js';
 export { default as Component } from './foundation/component_api/Component.js';
 export { default as Attribute } from './foundation/component_api/Attribute.js';
-export { default as Triplet, TripletStruct, AccessType, REGISTRY } from './foundation/Triplet.js';
+export { default as Triplet, TripletStruct, AccessType, REGISTRY, RegistryCapture } from './foundation/Triplet.js';
 export { ReComponent, RePage, ReImplementation } from './foundation/TripletDecorator.js';
 export { Implementation, ImplementationStruct, Placeholder } from './foundation/Injection.js';
-export { default as Module, ModuleStruct, ModuleManager, ModuleDownloadProgress } from './foundation/Module.js';
+export { default as Module, ModuleStruct, ModuleManager, SubModule, SubModuleStruct } from './foundation/Module.js';
+export { default as CacheManager, DownloadProgress } from './foundation/CacheManager.js';
 export { default as Fetcher } from './foundation/Fetcher.js';
 export * from './foundation/engine/TemplateEngine.js';
 export { Router } from './foundation/worker/Router.js';
-export { default as ServiceWorker, ServiceWorkerConfig, FetchActivityItem, PageSourceType, CacheStrategy, PrecacheMode } from './foundation/worker/ServiceWorker.js';
+export { default as ServiceWorker, ServiceWorkerConfig, FetchActivityItem, PageSourceType } from './foundation/worker/ServiceWorker.js';
 export * from './foundation/Hosting.js';
 export * from './foundation/Theme.js';
 //# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAE3D,cAAc,2CAA2C,CAAC;AAC1D,OAAO,EACN,OAAO,IAAI,UAAU,EACrB,SAAS,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAC3F,YAAY,EACZ,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAErK,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAE3D,cAAc,2CAA2C,CAAC;AAC1D,OAAO,EACN,OAAO,IAAI,UAAU,EACrB,SAAS,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAC3F,YAAY,EACZ,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACnH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpH,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAExI,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/out/index.js

@@ -5,10 +5,11 @@ export { default as UniHtml } from './foundation/component_api/UniHtml.js';
 export { default as Page } from './foundation/component_api/Page.js';
 export { default as Component } from './foundation/component_api/Component.js';
 export { default as Attribute } from './foundation/component_api/Attribute.js';
-export { default as Triplet, AccessType, REGISTRY } from './foundation/Triplet.js';
+export { default as Triplet, AccessType, REGISTRY, RegistryCapture } from './foundation/Triplet.js';
 export { ReComponent, RePage, ReImplementation } from './foundation/TripletDecorator.js';
 export { Implementation, Placeholder } from './foundation/Injection.js';
-export { default as Module, ModuleManager } from './foundation/Module.js';
+export { default as Module, ModuleManager, SubModule } from './foundation/Module.js';
+export { default as CacheManager } from './foundation/CacheManager.js';
 export { default as Fetcher } from './foundation/Fetcher.js';
 export * from './foundation/engine/TemplateEngine.js';
 export { Router } from './foundation/worker/Router.js';

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAE3D,cAAc,2CAA2C,CAAC;AAC1D,OAAO,EACN,OAAO,IAAI,UAAU,EAC+B,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAC3F,YAAY,EACZ,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAiB,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAwB,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,MAAM,EAAgB,aAAa,EAA0B,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAuF,MAAM,sCAAsC,CAAC;AAErK,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,qEAAqE;AACrE;;WAEQ;AAER,yEAAyE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAE3D,cAAc,2CAA2C,CAAC;AAC1D,OAAO,EACN,OAAO,IAAI,UAAU,EAC+B,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAC3F,YAAY,EACZ,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAiB,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACnH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAwB,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,MAAM,EAAgB,aAAa,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAC;AACpH,OAAO,EAAE,OAAO,IAAI,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAA0D,MAAM,sCAAsC,CAAC;AAExI,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,qEAAqE;AACrE;;WAEQ;AAER,yEAAyE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reidelsaltres/pureper",
-  "version": "0.2.33",
+  "version": "0.2.34",
   "description": "Minimal library extracted from the Pureper SPA foundation — utilities and base classes for components/pages.",
   "type": "module",
   "main": "out/src/index.js",

package/src/foundation/CacheManager.ts

@@ -0,0 +1,151 @@
+import Observable from "./api/Observer.js";
+import Fetcher from "./Fetcher.js";
+
+export type DownloadProgress = {
+    totalFiles: number;
+    completedFiles: number;
+    currentFile: string;
+    totalBytes: number;
+    downloadedBytes: number;
+    speed: number;
+    active: boolean;
+};
+
+export default class CacheManager {
+    private static readonly CACHE_NAME = 'purper-modules';
+
+    static resolveUrl(url: string): string {
+        return Fetcher.resolveUrl(url);
+    }
+
+    static async download(urls: string[], progress?: Observable<DownloadProgress>): Promise<number> {
+        if (urls.length === 0) return 0;
+
+        const totalFiles = urls.length;
+        let completedFiles = 0;
+        let downloadedBytes = 0;
+        let totalBytes = 0;
+        let lastTime = performance.now();
+        let lastBytes = 0;
+        let speed = 0;
+
+        const update = (currentFile: string, active: boolean) => {
+            progress?.setObject({ totalFiles, completedFiles, currentFile, totalBytes, downloadedBytes, speed, active });
+        };
+
+        // Estimate total size via HEAD
+        const sizes = await Promise.all(urls.map(async (url) => {
+            try {
+                const resp = await fetch(this.resolveUrl(url), { method: 'HEAD' });
+                const cl = resp.headers.get('content-length');
+                return cl ? parseInt(cl, 10) : 0;
+            } catch { return 0; }
+        }));
+        totalBytes = sizes.reduce((a, b) => a + b, 0);
+
+        update('', true);
+
+        const failedFiles: string[] = [];
+
+        for (const url of urls) {
+            const resolved = this.resolveUrl(url);
+            const fileName = url.split('/').pop() || url;
+            update(fileName, true);
+
+            try {
+                const response = await fetch(resolved);
+                if (!response.ok) {
+                    console.warn(`[CacheManager]: Failed to download ${url}: ${response.status}`);
+                    failedFiles.push(url);
+                    completedFiles++;
+                    continue;
+                }
+
+                const reader = response.body?.getReader();
+                const chunks: BlobPart[] = [];
+
+                if (reader) {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done) break;
+                        chunks.push(value);
+                        downloadedBytes += value.byteLength;
+
+                        const now = performance.now();
+                        const elapsed = (now - lastTime) / 1000;
+                        if (elapsed >= 0.5) {
+                            speed = (downloadedBytes - lastBytes) / elapsed;
+                            lastTime = now;
+                            lastBytes = downloadedBytes;
+                        }
+
+                        update(fileName, true);
+                    }
+                }
+
+                if ('caches' in window) {
+                    try {
+                        const cache = await caches.open(this.CACHE_NAME);
+                        const blob = new Blob(chunks);
+                        const cacheResponse = new Response(blob, { headers: response.headers });
+                        await cache.put(resolved, cacheResponse);
+                    } catch (e) {
+                        console.warn(`[CacheManager]: Failed to cache ${url}`, e);
+                    }
+                }
+
+                completedFiles++;
+            } catch (e) {
+                console.warn(`[CacheManager]: Error downloading ${url}`, e);
+                failedFiles.push(url);
+                completedFiles++;
+            }
+        }
+
+        speed = 0;
+        update('', false);
+
+        if (failedFiles.length > 0) {
+            throw new Error(`[CacheManager]: ${failedFiles.length} file(s) failed to download: ${failedFiles.join(', ')}`);
+        }
+
+        return downloadedBytes;
+    }
+
+    static async delete(urls: string[]): Promise<void> {
+        if (!('caches' in window) || urls.length === 0) return;
+        const cache = await caches.open(this.CACHE_NAME);
+        for (const url of urls) {
+            await cache.delete(this.resolveUrl(url));
+        }
+    }
+
+    static async isCached(url: string): Promise<boolean> {
+        if (!('caches' in window)) return false;
+        const cache = await caches.open(this.CACHE_NAME);
+        const match = await cache.match(this.resolveUrl(url));
+        return match !== undefined;
+    }
+
+    static async getCachedSize(urls: string[]): Promise<number> {
+        if (!('caches' in window) || urls.length === 0) return 0;
+        const cache = await caches.open(this.CACHE_NAME);
+        let total = 0;
+        for (const url of urls) {
+            const match = await cache.match(this.resolveUrl(url));
+            if (match) {
+                const blob = await match.blob();
+                total += blob.size;
+            }
+        }
+        return total;
+    }
+
+    static formatBytes(bytes: number): string {
+        if (bytes === 0) return '0 B';
+        const k = 1024;
+        const sizes = ['B', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return parseFloat((bytes / Math.pow(k, i)).toFixed(1)) + ' ' + sizes[i];
+    }
+}

package/src/foundation/Injection.ts

@@ -165,6 +165,30 @@ export class Placeholder {
         console.info(`[Placeholder:${placeholderName}]: Reloaded ${reloads.length} instance(s)`);
     }
 
+    /** Return all registered placeholder names. */
+    public static getAllNames(): string[] {
+        return Array.from(this._all.keys());
+    }
+
+    /** Deactivate a placeholder — hides all instances. */
+    public static deactivate(name: string): void {
+        const p = this._all.get(name);
+        if (!p) return;
+        p.activeImpl.setObject(null);
+        console.info(`[Placeholder:${name}]: Deactivated`);
+    }
+
+    /** Activate a placeholder — restores the default implementation. */
+    public static activate(name: string): void {
+        const p = this._all.get(name);
+        if (!p) return;
+        const first = p.implementations.values().next().value;
+        if (first && !p.activeImpl.getObject()) {
+            p.activeImpl.setObject(first);
+            console.info(`[Placeholder:${name}]: Activated with "${first.name}"`);
+        }
+    }
+
     /**
      * Switch a single instance to a different implementation and reload it.
      * Does NOT change the global active implementation.