adaptive-extender 0.6.3 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,5 @@
-## 0.6.3 (19.10.2025)
-- Added module [archive]().
+## 0.7.1 (19.10.2025)
+- Added module [archive-manager]().
 
 ## 0.6.1 (27.09.2025)
 - Added modules [promise](), [engine](), [parent-node](), [element]().

package/dist/core/archivable.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Defines the interface for an archivable object's prototype.
+ * @template N The type of the notation returned by the export method.
+ */
+interface ArchivablePrototype<N = any> {
+    /**
+     * Creates a new instance of the archivable object.
+     */
+    new (...args: any): any;
+    /**
+     * Imports data from a source and returns a new instance.
+     * @throws {TypeError} If unable to import the source.
+     */
+    import(source: any): InstanceType<this>;
+    /**
+     * Imports data from a source with a given name and returns a new instance.
+     * @throws {TypeError} If unable to import the source.
+     */
+    import(source: any, name: string): InstanceType<this>;
+    /**
+     * Exports the state of an instance to a notation.
+     */
+    export(source: InstanceType<this>): N;
+}
+export { type ArchivablePrototype };

package/dist/core/archivable.js

@@ -0,0 +1,3 @@
+"use strict";
+export {};
+//# sourceMappingURL=archivable.js.map

package/dist/core/archivable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivable.js","sourceRoot":"","sources":["../../src/core/archivable.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AA2Bb,OAAO,EAA4B,CAAC"}

package/dist/core/index.d.ts

@@ -7,6 +7,7 @@ export * from "./date.js";
 export * from "./math.js";
 export * from "./array.js";
 export * from "./object.js";
+export * from "./archivable.js";
 export * from "./error.js";
 export * from "./promise.js";
 export * from "./random.js";

package/dist/core/index.js

@@ -8,6 +8,7 @@ export * from "./date.js";
 export * from "./math.js";
 export * from "./array.js";
 export * from "./object.js";
+export * from "./archivable.js";
 export * from "./error.js";
 export * from "./promise.js";
 export * from "./random.js";

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/web/archive-manager.d.ts

@@ -0,0 +1,27 @@
+import "../core/index.js";
+import { type ArchivablePrototype } from "../core/index.js";
+/**
+ * Manages the archiving of an object.
+ */
+declare class ArchiveManager<T extends ArchivablePrototype> {
+    #private;
+    /**
+     * @param key The key for the archive.
+     * @param prototype The prototype of the archivable object.
+     * @param args The arguments for the constructor of the archivable object.
+     */
+    constructor(key: string, prototype: T, args: ConstructorParameters<T>);
+    /**
+     * Reads content of the archive.
+     */
+    get content(): InstanceType<T>;
+    /**
+     * Writes content of the archive.
+     */
+    set content(value: InstanceType<T>);
+    /**
+     * Resets the content of the archive to a new instance.
+     */
+    reset(): void;
+}
+export { ArchiveManager };

package/dist/web/archive-manager.js

@@ -0,0 +1,51 @@
+"use strict";
+import "../core/index.js";
+import {} from "../core/index.js";
+import { Archive } from "./archive.js";
+//#region Archive manager
+/**
+ * Manages the archiving of an object.
+ */
+class ArchiveManager {
+    #prototype;
+    #args;
+    #archive;
+    /**
+     * @param key The key for the archive.
+     * @param prototype The prototype of the archivable object.
+     * @param args The arguments for the constructor of the archivable object.
+     */
+    constructor(key, prototype, args) {
+        this.#prototype = prototype;
+        this.#args = args;
+        this.#archive = ArchiveManager.#newArchive(key, prototype, args);
+    }
+    static #newInstance(prototype, args) {
+        return Reflect.construct(prototype, args);
+    }
+    static #newArchive(key, prototype, args) {
+        const instance = ArchiveManager.#newInstance(prototype, args);
+        return new Archive(key, prototype.export(instance));
+    }
+    /**
+     * Reads content of the archive.
+     */
+    get content() {
+        return this.#prototype.import(this.#archive.data);
+    }
+    /**
+     * Writes content of the archive.
+     */
+    set content(value) {
+        this.#archive.data = this.#prototype.export(value);
+    }
+    /**
+     * Resets the content of the archive to a new instance.
+     */
+    reset() {
+        this.content = ArchiveManager.#newInstance(this.#prototype, this.#args);
+    }
+}
+//#endregion
+export { ArchiveManager };
+//# sourceMappingURL=archive-manager.js.map

package/dist/web/archive-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-manager.js","sourceRoot":"","sources":["../../src/web/archive-manager.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAA4B,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,yBAAyB;AACzB;;GAEG;AACH,MAAM,cAAc;IACnB,UAAU,CAAI;IACd,KAAK,CAA2B;IAChC,QAAQ,CAAU;IAClB;;;;OAIG;IACH,YAAY,GAAW,EAAE,SAAY,EAAE,IAA8B;QACpE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,CAAC,YAAY,CAAgC,SAAY,EAAE,IAA8B;QAC9F,OAAO,OAAO,CAAC,SAAS,CAA4C,SAAS,EAAE,IAAI,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,CAAC,WAAW,CAAgC,GAAW,EAAE,SAAY,EAAE,IAA8B;QAC1G,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC9D,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IACD;;OAEG;IACH,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD;;OAEG;IACH,IAAI,OAAO,CAAC,KAAsB;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD;;OAEG;IACH,KAAK;QACJ,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC;CACD;AACD,YAAY;AAEZ,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/web/archive.d.ts

@@ -1,24 +1,34 @@
 import "../core/index.js";
+import type { ArchivablePrototype } from "../core/index.js";
 /**
- * Represents a data archive stored in the local storage.
+ * Manages the archiving of an object.
  */
-declare class Archive {
+declare class ArchiveManager<T extends ArchivablePrototype> {
     #private;
     /**
-     * @param key The key to use for the local storage.
-     * @param initial The initial value to set if the archive is empty.
+     * @param key The key for the archive.
+     * @param prototype The prototype of the archivable object.
+     * @param args The arguments for the constructor of the archivable object.
      */
-    constructor(key: string, initial: any);
+    constructor(key: string, prototype: T, ...args: ConstructorParameters<T>);
     /**
-     * The data stored in the archive.
+     * Key of the archive.
+     */
+    get key(): string;
+    /**
+     * Reads content of the archive.
      * @throws {ReferenceError} If the archive is missing from the local storage.
      * @throws {SyntaxError} If the archive is corrupted.
      */
-    get data(): any;
+    get content(): InstanceType<T>;
     /**
-     * The data stored in the archive.
+     * Writes content of the archive.
      * @throws {SyntaxError} If the value could not be processed.
      */
-    set data(value: any);
+    set content(value: InstanceType<T>);
+    /**
+     * Resets the content of the archive to a new instance.
+     */
+    reset(): void;
 }
-export { Archive };
+export { ArchiveManager };

package/dist/web/archive.js

@@ -35,6 +35,12 @@ class Archive {
             throw new SyntaxError(`Archive at key '${key}' is corrupted`);
         }
     }
+    /**
+     * The key used in the local storage.
+     */
+    get key() {
+        return this.#key;
+    }
     /**
      * The data stored in the archive.
      * @throws {ReferenceError} If the archive is missing from the local storage.
@@ -56,5 +62,66 @@ class Archive {
     }
 }
 //#endregion
-export { Archive };
+//#region Archive manager
+/**
+ * Manages the archiving of an object.
+ */
+class ArchiveManager {
+    #prototype;
+    #args;
+    #archive;
+    /**
+     * @param key The key for the archive.
+     * @param prototype The prototype of the archivable object.
+     * @param args The arguments for the constructor of the archivable object.
+     */
+    constructor(key, prototype, ...args) {
+        this.#prototype = prototype;
+        this.#args = args;
+        this.#archive = ArchiveManager.#newArchive(key, prototype, args);
+    }
+    static #newInstance(prototype, args) {
+        return Reflect.construct(prototype, args);
+    }
+    static #newArchive(key, prototype, args) {
+        const instance = ArchiveManager.#newInstance(prototype, args);
+        return new Archive(key, prototype.export(instance));
+    }
+    /**
+     * Key of the archive.
+     */
+    get key() {
+        return this.#archive.key;
+    }
+    /**
+     * Reads content of the archive.
+     * @throws {ReferenceError} If the archive is missing from the local storage.
+     * @throws {SyntaxError} If the archive is corrupted.
+     */
+    get content() {
+        try {
+            return this.#prototype.import(this.#archive.data);
+        }
+        catch (error) {
+            if (!(error instanceof TypeError))
+                throw error;
+            throw new SyntaxError(`Archive at key '${this.#archive.key}' is corrupted`);
+        }
+    }
+    /**
+     * Writes content of the archive.
+     * @throws {SyntaxError} If the value could not be processed.
+     */
+    set content(value) {
+        this.#archive.data = this.#prototype.export(value);
+    }
+    /**
+     * Resets the content of the archive to a new instance.
+     */
+    reset() {
+        this.content = ArchiveManager.#newInstance(this.#prototype, this.#args);
+    }
+}
+//#endregion
+export { ArchiveManager };
 //# sourceMappingURL=archive.js.map

package/dist/web/archive.js.map

@@ -1 +1 @@
-{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/web/archive.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,kBAAkB,CAAC;AAE1B,iBAAiB;AACjB;;GAEG;AACH,MAAM,OAAO;IACZ,IAAI,CAAS;IACb;;;OAGG;IACH,YAAY,GAAW,EAAE,OAAY;QACpC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,WAAW,CAAC,KAAU;QACrB,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO;QACrD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,SAAS,CAAC,GAAW,EAAE,KAAU;QACvC,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,IAAI,WAAW,CAAC,mBAAmB,GAAG,+BAA+B,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IACD,MAAM,CAAC,WAAW,CAAC,GAAW,EAAE,IAAY;QAC3C,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,IAAI,WAAW,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;QAC/D,CAAC;IACF,CAAC;IACD;;;;OAIG;IACH,IAAI,IAAI;QACP,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,IAAI,cAAc,CAAC,mBAAmB,IAAI,CAAC,IAAI,cAAc,CAAC,CAAC;QACxF,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD;;;OAGG;IACH,IAAI,IAAI,CAAC,KAAU;QAClB,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjD,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;CACD;AACD,YAAY;AAEZ,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/web/archive.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "adaptive-extender",
-	"version": "0.6.3",
+	"version": "0.7.1",
 	"description": "Adaptive library for JS/TS development environments",
 	"type": "module",
 	"main": "./dist/core/index.js",