@reidelsaltres/pureper 0.2.33 → 0.2.34

package/out/foundation/CacheManager.d.ts

@@ -0,0 +1,20 @@
+import Observable from "./api/Observer.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;
+    static resolveUrl(url: string): string;
+    static download(urls: string[], progress?: Observable<DownloadProgress>): Promise<number>;
+    static delete(urls: string[]): Promise<void>;
+    static isCached(url: string): Promise<boolean>;
+    static getCachedSize(urls: string[]): Promise<number>;
+    static formatBytes(bytes: number): string;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/out/foundation/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/foundation/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAG3C,MAAM,MAAM,gBAAgB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAEtD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;WAIzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;WA8FlF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;WAQrC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAOvC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAc3D,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAO5C"}

package/out/foundation/CacheManager.js

@@ -0,0 +1,129 @@
+import Fetcher from "./Fetcher.js";
+export default class CacheManager {
+    static CACHE_NAME = 'purper-modules';
+    static resolveUrl(url) {
+        return Fetcher.resolveUrl(url);
+    }
+    static async download(urls, progress) {
+        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, active) => {
+            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 = [];
+        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 = [];
+                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) {
+        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) {
+        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) {
+        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) {
+        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];
+    }
+}
+//# sourceMappingURL=CacheManager.js.map

package/out/foundation/CacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../src/foundation/CacheManager.ts"],"names":[],"mappings":"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"}

package/out/foundation/Injection.d.ts

@@ -78,6 +78,12 @@ export declare class Placeholder {
      * All live instances of this placeholder will reload.
      */
     static switchTo(placeholderName: string, implName: string): Promise<void>;
+    /** Return all registered placeholder names. */
+    static getAllNames(): string[];
+    /** Deactivate a placeholder — hides all instances. */
+    static deactivate(name: string): void;
+    /** Activate a placeholder — restores the default implementation. */
+    static activate(name: string): void;
     /**
      * Switch a single instance to a different implementation and reload it.
      * Does NOT change the global active implementation.

package/out/foundation/Injection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Injection.d.ts","sourceRoot":"","sources":["../../src/foundation/Injection.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,OAAO,MAAM,4BAA4B,CAAC;AAEjD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACnC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAc;IACvB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,SAAgB,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,SAAgB,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;gBAEhC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB;CAiBhE;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW;IACpB,kEAAkE;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAEnE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IACzE,SAAgB,UAAU,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAwB;IAErF,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAEtD,OAAO;IAIP,2CAA2C;WAC7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAS5C,qCAAqC;WACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC,4EAA4E;IACrE,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAcpD,+CAA+C;IACxC,SAAS,IAAI,cAAc,GAAG,IAAI;IAIzC,wCAAwC;IACjC,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI7C,mCAAmC;IAC5B,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI/C,sCAAsC;IAC/B,YAAY,IAAI,GAAG,CAAC,OAAO,CAAC;IAInC;;;OAGG;WACiB,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBtF;;;OAGG;WACiB,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWlH"}
+{"version":3,"file":"Injection.d.ts","sourceRoot":"","sources":["../../src/foundation/Injection.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,OAAO,MAAM,4BAA4B,CAAC;AAEjD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACnC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAc;IACvB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,SAAgB,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,SAAgB,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;gBAEhC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB;CAiBhE;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW;IACpB,kEAAkE;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAEnE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IACzE,SAAgB,UAAU,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAwB;IAErF,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAEtD,OAAO;IAIP,2CAA2C;WAC7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAS5C,qCAAqC;WACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC,4EAA4E;IACrE,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAcpD,+CAA+C;IACxC,SAAS,IAAI,cAAc,GAAG,IAAI;IAIzC,wCAAwC;IACjC,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI7C,mCAAmC;IAC5B,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI/C,sCAAsC;IAC/B,YAAY,IAAI,GAAG,CAAC,OAAO,CAAC;IAInC;;;OAGG;WACiB,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBtF,+CAA+C;WACjC,WAAW,IAAI,MAAM,EAAE;IAIrC,sDAAsD;WACxC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO5C,oEAAoE;WACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU1C;;;OAGG;WACiB,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWlH"}

package/out/foundation/Injection.js

@@ -130,6 +130,29 @@ export class Placeholder {
         await Promise.all(reloads);
         console.info(`[Placeholder:${placeholderName}]: Reloaded ${reloads.length} instance(s)`);
     }
+    /** Return all registered placeholder names. */
+    static getAllNames() {
+        return Array.from(this._all.keys());
+    }
+    /** Deactivate a placeholder — hides all instances. */
+    static deactivate(name) {
+        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. */
+    static activate(name) {
+        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.

package/out/foundation/Injection.js.map

@@ -1 +1 @@
-{"version":3,"file":"Injection.js","sourceRoot":"","sources":["../../src/foundation/Injection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Injection.js","sourceRoot":"","sources":["../../src/foundation/Injection.ts"],"names":[],"mappings":"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"}

package/out/foundation/Module.d.ts

@@ -1,4 +1,11 @@
 import Observable from "./api/Observer.js";
+import { DownloadProgress } from "./CacheManager.js";
+export type SubModuleStruct = {
+    name: string;
+    description?: string;
+    inbuilt?: boolean;
+    resources?: string[];
+};
 export type ModuleStruct = {
     name: string;
     description?: string;
@@ -6,34 +13,24 @@ export type ModuleStruct = {
     core?: boolean;
     enabled?: boolean;
     resources?: string[];
+    subModules?: SubModuleStruct[];
 };
-export type ModuleDownloadProgress = {
-    /** Total number of resources */
-    totalFiles: number;
-    /** Number of resources downloaded so far */
-    downloadedFiles: number;
-    /** Current file being downloaded */
-    currentFile: string;
-    /** Total bytes across all resources (estimated) */
-    totalBytes: number;
-    /** Bytes downloaded so far */
-    downloadedBytes: number;
-    /** Download speed in bytes/sec */
-    speed: number;
-    /** Whether download is in progress */
-    active: boolean;
-};
-export default class Module {
+export default class Module extends Observable<boolean> {
     readonly name: string;
     readonly description?: string;
     readonly icon?: string;
     readonly core: boolean;
-    readonly enabled: Observable<boolean>;
     readonly downloaded: Observable<boolean>;
     readonly resources: string[];
     readonly totalSize: Observable<number>;
-    readonly downloadProgress: Observable<ModuleDownloadProgress>;
+    readonly downloadProgress: Observable<DownloadProgress>;
+    readonly downloadError: Observable<string>;
     private _registrations;
+    private _placeholderNames;
+    private _initialized;
+    private _subModules;
+    private static _claimedPlaceholders;
+    get enabled(): Observable<boolean>;
     constructor(struct: ModuleStruct);
     addRegistration(fn: () => Promise<void>): void;
     getRegistrations(): ReadonlyArray<() => Promise<void>>;
@@ -45,21 +42,39 @@ export default class Module {
      * that all their REGISTRY entries have been pushed.
      */
     captureRegistrations(registry: (() => Promise<void>)[]): void;
-    enable(): void;
+    addPlaceholder(name: string): void;
+    getPlaceholderNames(): ReadonlyArray<string>;
+    markInitialized(): void;
+    enable(): Promise<void>;
     disable(): void;
     isActive(): boolean;
     /** True if enabled but not downloaded — works only in the current session. */
     get ephemeral(): boolean;
-    /**
-     * Download all module resources with progress tracking.
-     * Uses fetch to download each resource and tracks progress.
-     */
     download(): Promise<void>;
     formatBytes(bytes: number): string;
     undownload(): Promise<void>;
+    addSubModule(struct: SubModuleStruct): SubModule;
+    getSubModules(): ReadonlyArray<SubModule>;
+}
+export declare class SubModule {
+    readonly name: string;
+    readonly description?: string;
+    readonly inbuilt: boolean;
+    readonly resources: string[];
+    readonly downloaded: Observable<boolean>;
+    readonly parent: Module;
+    readonly totalSize: Observable<number>;
+    readonly downloadProgress: Observable<DownloadProgress>;
+    readonly downloadError: Observable<string>;
+    constructor(struct: SubModuleStruct, parent: Module);
+    private assertParentActive;
+    private assertParentDownloaded;
+    download(): Promise<void>;
+    undownload(): Promise<void>;
 }
 export declare class ModuleManager {
     private static _modules;
+    private static _userEphemeralCores;
     private static readonly STORAGE_KEY;
     private static readonly SESSION_KEY;
     static register(struct: ModuleStruct): Module;
@@ -74,7 +89,9 @@ export declare class ModuleManager {
      * 4. Returns all promises
      */
     static initialize(): Promise<void>[];
+    private static autoDownload;
     static persistState(): void;
+    static clearEphemeralCore(name: string): void;
     static restoreState(): void;
 }
 //# sourceMappingURL=Module.d.ts.map

package/out/foundation/Module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../../src/foundation/Module.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAG3C,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACjC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,IAAI,EAAE,OAAO,CAAC;IAC9B,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7C,SAAgB,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAChD,SAAgB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpC,SAAgB,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9C,SAAgB,gBAAgB,EAAE,UAAU,CAAC,sBAAsB,CAAC,CAAC;IAErE,OAAO,CAAC,cAAc,CAA+B;gBAElC,MAAM,EAAE,YAAY;IAehC,eAAe,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI9C,gBAAgB,IAAI,aAAa,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAI7D;;;;;;OAMG;IACI,oBAAoB,CAAC,QAAQ,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,IAAI;IAM7D,MAAM,IAAI,IAAI;IAMd,OAAO,IAAI,IAAI;IASf,QAAQ,IAAI,OAAO;IAI1B,8EAA8E;IAC9E,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA0H/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQ5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CA4B3C;AAED,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAoB;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA4B;IAE/D,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAU7C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE;IAIzB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKtC;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE;IA4BpC,MAAM,CAAC,YAAY,IAAI,IAAI;IAuB3B,MAAM,CAAC,YAAY,IAAI,IAAI;CA4C9B"}
+{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../../src/foundation/Module.ts"],"names":[],"mappings":"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"}