adaptive-extender 0.8.6 → 0.9.0

package/CHANGELOG.md

@@ -1,4 +1,9 @@
-## 0.8.6 (09.12.2025)
+## 0.9.0 (18.01.2026)
+- Added automatic model porting using decorators in [portable](./src/core/portable.ts).
+- Built-in types now implement the `PortableConstructor` interface.
+- Improved `ArchiveManager` and `ArchiveRepository` classes for working with archives.
+
+## 0.8.7 (09.12.2025)
 - Added `Array.fromAsync` function.
 
 ## 0.8.5 (04.12.2025)

package/dist/core/array.d.ts

@@ -2,13 +2,17 @@ import "./global.js";
 declare global {
     export interface ArrayConstructor {
         /**
-         * Imports an array from a source.
-         * @param source The source to import from.
-         * @param name The name of the source.
-         * @returns The imported array.
+         * Validates that the source is an array and returns it.
+         * @param source The raw data to check.
+         * @param name The field name for error context.
          * @throws {TypeError} If the source is not an array.
          */
         import(source: any, name: string): any[];
+        /**
+         * Returns the array as-is for export purposes.
+         * @param source The array to export.
+         */
+        export(source: any[]): any[];
         /**
          * Creates an array of integers between the specified minimum and maximum values (exclusive).
          * @param min The minimum value of the range (inclusive).

package/dist/core/array.js

@@ -1,11 +1,15 @@
 "use strict";
 import "./global.js";
+import {} from "./promise.js";
 const { trunc } = Math;
 Array.import = function (source, name) {
     if (!Array.isArray(source))
         throw new TypeError(`Unable to import array from ${name} due its ${typename(source)} type`);
     return source;
 };
+Array.export = function (source) {
+    return source;
+};
 Array.range = function (min, max) {
     min = trunc(min);
     max = trunc(max);

package/dist/core/array.js.map

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

package/dist/core/boolean.d.ts

@@ -2,12 +2,16 @@ import "./global.js";
 declare global {
     export interface BooleanConstructor {
         /**
-         * Imports a boolean value from a source.
-         * @param source The source value to import.
-         * @param name The name of the source value.
-         * @returns The imported boolean value.
+         * Validates and imports a boolean value from a raw source.
+         * @param source The raw value to check.
+         * @param name The field name for error context.
          * @throws {TypeError} If the source is not a boolean.
          */
         import(source: any, name: string): boolean;
+        /**
+         * Returns the primitive boolean value for export.
+         * @param source The boolean to export.
+         */
+        export(source: boolean): boolean;
     }
 }

package/dist/core/boolean.js

@@ -5,4 +5,7 @@ Boolean.import = function (source, name) {
         throw new TypeError(`Unable to import boolean from ${name} due its ${typename(source)} type`);
     return source.valueOf();
 };
+Boolean.export = function (source) {
+    return source.valueOf();
+};
 //# sourceMappingURL=boolean.js.map

package/dist/core/boolean.js.map

@@ -1 +1 @@
-{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../src/core/boolean.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAgBrB,OAAO,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IACnD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjI,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC"}
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../src/core/boolean.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAoBrB,OAAO,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IACnD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjI,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF,OAAO,CAAC,MAAM,GAAG,UAAU,MAAe;IACzC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC"}

package/dist/core/controller.d.ts

@@ -1,9 +1,8 @@
 import "./error.js";
 /**
  * Represents a controller that can be launched and handle errors.
- * @abstract
  */
-export declare class Controller {
+export declare abstract class Controller {
     /**
      * @throws {TypeError} If the constructor is called on ectly.
      */

package/dist/core/controller.js

@@ -3,7 +3,6 @@ import "./error.js";
 //#region Controller
 /**
  * Represents a controller that can be launched and handle errors.
- * @abstract
  */
 export class Controller {
     /**

package/dist/core/controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/core/controller.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,YAAY,CAAC;AAEpB,oBAAoB;AACpB;;;GAGG;AACH,MAAM,OAAO,UAAU;IACtB;;OAEG;IACH;QACC,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IACzG,CAAC;IACD;;OAEG;IACH,KAAK,CAAC,GAAG;IACT,CAAC;IACD;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAY;IACxB,CAAC;IACD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM;QAClB,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC;YACJ,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YACjB,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/core/controller.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,YAAY,CAAC;AAEpB,oBAAoB;AACpB;;GAEG;AACH,MAAM,OAAgB,UAAU;IAC/B;;OAEG;IACH;QACC,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IACzG,CAAC;IACD;;OAEG;IACH,KAAK,CAAC,GAAG;IACT,CAAC;IACD;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAY;IACxB,CAAC;IACD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM;QAClB,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC;YACJ,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YACjB,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;CACD"}

package/dist/core/date.d.ts

@@ -1,14 +1,6 @@
 import "./global.js";
 declare global {
     export interface DateConstructor {
-        /**
-         * Imports a date from a source.
-         * @param source The source value to import.
-         * @param name The name of the source value.
-         * @returns The imported date value.
-         * @throws {TypeError} If the source is not a date.
-         */
-        import(source: any, name: string): Date;
         /**
          * Checks whether a given date is invalid.
          * @returns `true` if the value is a `Date` and is invalid; otherwise, `false`.

package/dist/core/date.js

@@ -1,10 +1,5 @@
 "use strict";
 import "./global.js";
-Date.import = function (source, name) {
-    if (!(source instanceof Date))
-        throw new TypeError(`Unable to import date from ${name} due its ${typename(source)} type`);
-    return source;
-};
 Date.isInvalid = function (date) {
     if (!(date instanceof Date))
         return false;

package/dist/core/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/core/date.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AA8BrB,IAAI,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IAChD,IAAI,CAAC,CAAC,MAAM,YAAY,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1H,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,IAAI,CAAC,SAAS,GAAG,UAAU,IAAa;IACvC,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,IAAI,CAAC,SAAS,CAAC,cAAc,GAAG,UAAa,KAAQ;IACpD,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/core/date.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAsBrB,IAAI,CAAC,SAAS,GAAG,UAAU,IAAa;IACvC,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,IAAI,CAAC,SAAS,CAAC,cAAc,GAAG,UAAa,KAAQ;IACpD,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}

package/dist/core/decorators.d.ts

@@ -0,0 +1,17 @@
+import { type Constructor, type PortableConstructor } from "./portable.js";
+export interface PortableField<T> extends Constructor {
+    import(source: unknown, name: string): T;
+    export(source: T): unknown;
+}
+export interface DeferredCallback<T> {
+    (): T;
+}
+export declare function Scheme<T>(type: PortableField<T>, name?: string): (target: void, context: ClassFieldDecoratorContext<PortableModel, unknown>) => void;
+export declare function PolymorphicBase<T extends typeof PortableModel>(resolver: DeferredCallback<PortableConstructor[]>): (target: T, context: ClassDecoratorContext) => T;
+export declare function ArrayOf<T>(type: PortableField<T>): PortableField<T[]>;
+export declare function Nullable<T>(type: PortableField<T>): PortableField<T | null>;
+export declare function Optional<T>(type: PortableField<T>): PortableField<T | undefined>;
+export declare abstract class PortableModel {
+    static import<T extends typeof PortableModel>(this: T, source: unknown, name: string): InstanceType<T>;
+    static export<T extends typeof PortableModel>(this: T, source: InstanceType<T>): unknown;
+}

package/dist/core/decorators.js

@@ -0,0 +1,174 @@
+"use strict";
+import {} from "./portable.js";
+//#region Field descriptor
+class FieldDescriptor {
+    #key;
+    #association;
+    #type;
+    constructor(key, association, type) {
+        this.#key = key;
+        this.#association = association;
+        this.#type = type;
+    }
+    get key() {
+        return this.#key;
+    }
+    get association() {
+        return this.#association;
+    }
+    get type() {
+        return this.#type;
+    }
+}
+class DeferredResolver {
+    #resolver;
+    constructor(resolver) {
+        this.#resolver = resolver;
+    }
+    get value() {
+        return this.#resolver.call(this);
+    }
+}
+//#endregion
+//#region Portability metadata
+class PortabilityMetadata {
+    static #registry = new Map();
+    #model;
+    #fields = [];
+    #callback = null;
+    constructor(model) {
+        this.#model = model;
+    }
+    static register(model) {
+        const registry = PortabilityMetadata.#registry;
+        if (registry.has(model.name))
+            return; /** @todo Throw error */
+        const metadata = new PortabilityMetadata(model);
+        registry.set(model.name, metadata);
+    }
+    static read(model) {
+        const registry = PortabilityMetadata.#registry;
+        const record = registry.get(model.name);
+        const metadata = ReferenceError.suppress(record, "asdasdadsa"); /** @todo Write error */
+        return metadata;
+    }
+    get model() {
+        return this.#model;
+    }
+    get fields() {
+        return this.#fields;
+    }
+    get callback() {
+        return this.#callback;
+    }
+    set callback(value) {
+        this.#callback = value;
+    }
+}
+//#endregion
+export function Scheme(type, name) {
+    return function (target, context) {
+        const key = context.name;
+        if (typeof key === "symbol")
+            throw new TypeError(""); /** @todo Write error */
+        const association = name ?? key;
+        context.addInitializer(function () {
+            const Type = constructor(this); /** @todo Fix constructor */
+            const { fields } = PortabilityMetadata.read(Type);
+            fields.push(new FieldDescriptor(key, association, type));
+        });
+    };
+}
+export function PolymorphicBase(resolver) {
+    return function (target) {
+        const metadata = PortabilityMetadata.read(target);
+        metadata.callback = resolver;
+        return target;
+    };
+}
+export function ArrayOf(type) {
+    return class {
+        static import(source, name) {
+            return Array.import(source, name).map((item, index) => type.import(item, `${name}[${index}]`));
+        }
+        static export(source) {
+            return source.map(item => type.export(item));
+        }
+    };
+}
+export function Nullable(type) {
+    return class {
+        static import(source, name) {
+            return Reflect.mapNull(source, source => type.import(source, name));
+        }
+        static export(source) {
+            return Reflect.mapNull(source, source => type.export(source));
+        }
+    };
+}
+export function Optional(type) {
+    return class {
+        static import(source, name) {
+            return Reflect.mapUndefined(source, source => type.import(source, name));
+        }
+        static export(source) {
+            return Reflect.mapUndefined(source, source => type.export(source));
+        }
+    };
+}
+export class PortableModel {
+    static {
+        PortabilityMetadata.register(this);
+    }
+    static import(source, name) {
+        const { callback, fields } = PortabilityMetadata.read(this);
+        if (callback !== null) {
+            const descendants = callback();
+            if (descendants.length > 1) {
+                const object = Object.import(source, name);
+                const typename = String.import(Reflect.get(object, "$type"), `${name}.$type`);
+                const subtype = descendants.find(subtype => subtype.name === typename);
+                if (subtype === undefined)
+                    throw new TypeError(`Unknown polymorphic type '${typename}' for '${this.name}'`);
+                return subtype.import(source, name);
+            }
+        }
+        const object = Object.import(source, name);
+        const instance = Reflect.construct(this, []);
+        let current = this;
+        while (current && current !== PortableModel) {
+            for (const { key, association, type } of fields) {
+                const rawValue = Reflect.get(object, association);
+                const importedValue = type.import(rawValue, `${name}.${association}`);
+                Reflect.set(instance, key, importedValue);
+            }
+            current = Object.getPrototypeOf(current);
+        }
+        return instance;
+    }
+    static export(source) {
+        const { callback, fields } = PortabilityMetadata.read(this);
+        if (callback !== null) {
+            const descendants = callback();
+            if (descendants.length > 1) {
+                const subtype = descendants.find(subtype => source instanceof subtype);
+                if (subtype === undefined)
+                    throw new TypeError(`Unknown polymorphic type '${typename}' for '${this.name}'`);
+                return subtype.export(source);
+            }
+        }
+        const result = Object();
+        Reflect.set(result, "$type", this.name);
+        let current = this;
+        while (current && current !== PortableModel) {
+            for (const { key, association, type } of fields) {
+                const value = Reflect.get(source, key);
+                const exportedValue = type.export(value);
+                Reflect.set(result, association, exportedValue);
+            }
+            current = Object.getPrototypeOf(current);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=decorators.js.map

package/dist/core/decorators.js.map

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

package/dist/core/global.d.ts

@@ -1,12 +1,4 @@
 declare global {
-    /**
-     * Exclude null from T
-     */
-    export type NonNull<T> = T & ({} | undefined);
-    /**
-     * Exclude undefined from T
-     */
-    export type NonUndefined<T> = T & ({} | null);
     /**
      * Returns the constructor of the given non-nullable value.
      */

package/dist/core/global.js.map

@@ -1 +1 @@
-{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/core/global.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAyBb,UAAU,CAAC,WAAW,GAAG,UAAa,KAAqB;IAC1D,OAAO,KAAK,CAAC,WAAW,CAAC;AAC1B,CAAC,CAAC;AAEF,UAAU,CAAC,QAAQ,GAAG,UAAU,KAAU;IACzC,QAAQ,KAAK,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC,CAAC,OAAO,WAAW,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC;QACzB,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;AACF,CAAC,CAAC"}
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/core/global.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAeb,UAAU,CAAC,WAAW,GAAG,UAAa,KAAqB;IAC1D,OAAO,KAAK,CAAC,WAAW,CAAC;AAC1B,CAAC,CAAC;AAEF,UAAU,CAAC,QAAQ,GAAG,UAAU,KAAU;IACzC,QAAQ,KAAK,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC,CAAC,OAAO,WAAW,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC;QACzB,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;AACF,CAAC,CAAC"}

package/dist/core/number.d.ts

@@ -2,13 +2,17 @@ import "./global.js";
 declare global {
     export interface NumberConstructor {
         /**
-         * Imports a number from a source.
-         * @param source The source value to import.
-         * @param name The name of the source value.
-         * @returns The imported number value.
+         * Validates and imports a number value from a raw source.
+         * @param source The raw value to check.
+         * @param name The field name for error context.
          * @throws {TypeError} If the source is not a number.
          */
         import(source: any, name: string): number;
+        /**
+         * Returns the primitive number value for export.
+         * @param source The number to export.
+         */
+        export(source: number): number;
     }
     export interface Number {
         /**

package/dist/core/number.js

@@ -5,6 +5,9 @@ Number.import = function (source, name) {
         throw new TypeError(`Unable to import number from ${name} due its ${typename(source)} type`);
     return source.valueOf();
 };
+Number.export = function (source) {
+    return source.valueOf();
+};
 Number.prototype.insteadNaN = function (value) {
     const current = this.valueOf();
     if (Number.isNaN(current))

package/dist/core/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/core/number.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAqCrB,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IAClD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/H,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,UAAU,GAAG,UAAa,KAAQ;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,eAAe,GAAG,UAAa,KAAQ;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,WAAW,GAAG,UAAa,KAAQ;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/core/number.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AAyCrB,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IAClD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/H,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,UAAU,MAAc;IACvC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,UAAU,GAAG,UAAa,KAAQ;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,eAAe,GAAG,UAAa,KAAQ;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,SAAS,CAAC,WAAW,GAAG,UAAa,KAAQ;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC"}

package/dist/core/object.d.ts

@@ -1,13 +1,17 @@
 declare global {
     export interface ObjectConstructor {
         /**
-         * Imports an object from a source.
-         * @param source The source to import from.
-         * @param name The name of the source.
-         * @returns The imported object.
-         * @throws {TypeError} If the source is not an object or null.
+         * Validates that the source is a non-null object.
+         * @param source The raw data to check.
+         * @param name The field name for error context.
+         * @throws {TypeError} If the source is not an object or is null.
          */
         import(source: any, name: string): object;
+        /**
+         * Returns the object as-is for export purposes.
+         * @param source The object to export.
+         */
+        export(source: object): object;
     }
 }
 export {};

package/dist/core/object.js

@@ -4,5 +4,8 @@ Object.import = function (source, name) {
         throw new TypeError(`Unable to import object from ${name} due its ${typename(source)} type`);
     return source;
 };
+Object.export = function (source) {
+    return source;
+};
 export {};
 //# sourceMappingURL=object.js.map

package/dist/core/object.js.map

@@ -1 +1 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/core/object.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAgBb,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IAClD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClJ,OAAO,MAAM,CAAC;AACf,CAAC,CAAC"}
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/core/object.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAoBb,MAAM,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IAClD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClJ,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,UAAU,MAAc;IACvC,OAAO,MAAM,CAAC;AACf,CAAC,CAAC"}

package/dist/core/portable.d.ts

@@ -1,35 +1,95 @@
+import "./number.js";
+import "./string.js";
+import "./boolean.js";
+import "./array.js";
+import "./object.js";
+import "./reflect.js";
 /**
  * Represents a generic class constructor.
  */
-export interface Constructor {
-    new (...args: any): any;
-}
+export type Constructor<T = any, P extends readonly any[] = []> = abstract new (...args: P) => T;
 /**
  * Represents a constructor that supports importing instances from a source.
  */
-export interface ImportableConstructor extends Constructor {
+export interface ImportableConstructor<M = any> extends Constructor<M> {
     /**
      * Imports an instance from a source.
      * @param source The source value to import.
      * @param name The name of the source value.
      * @throws {TypeError} If the source is not of the expected type.
      */
-    import(source: any, name: string): InstanceType<this>;
+    import(source: any, name: string): M;
 }
 /**
  * Represents a constructor that supports exporting instances to a scheme.
  * @template S The type of scheme.
  */
-export interface ExportableConstructor<S = any> extends Constructor {
+export interface ExportableConstructor<M = any, S = unknown> extends Constructor<M> {
     /**
      * Exports an instance to a source.
      * @param source The instance to export.
      */
-    export(source: InstanceType<this>): S;
+    export(source: M): S;
 }
 /**
  * Represents a constructor that supports facilitating the safe conversion between anonymous schemes and typed instances.
  * @template S The type of scheme.
  */
-export interface PortableConstructor<S = any> extends ImportableConstructor, ExportableConstructor<S>, Constructor {
+export interface PortableConstructor<M = any, S = unknown> extends ImportableConstructor<M>, ExportableConstructor<M, S> {
 }
+/**
+ * The abstract base class for all portable data models.
+ * Provides mechanism for type-safe import and export of data structures.
+ */
+export declare abstract class PortableModel {
+    /**
+     * Creates an instance of the model from a raw source.
+     * Handles polymorphic resolution and recursive field mapping.
+     * @param source The raw source object (e.g. from JSON).
+     * @param name The context path for error reporting.
+     * @throws {TypeError} If validation fails or types do not match.
+     */
+    static import<T extends typeof PortableModel, S = any>(this: T, source: any, name: string): InstanceType<T>;
+    /**
+     * Serializes the model instance to a raw object.
+     * Includes type discrimination for polymorphic models.
+     * @param source The model instance to export.
+     */
+    static export<T extends typeof PortableModel, S = any>(this: T, source: InstanceType<T>): S;
+}
+/**
+ * Decorator to register a class field as part of the portable schema.
+ * @param type The portable constructor to use for import/export.
+ */
+export declare function Field<M, S>(type: PortableConstructor<M, S>): (target: void, context: ClassFieldDecoratorContext<PortableModel, S>) => void;
+/**
+ * Decorator to register a class field as part of the portable schema.
+ * @param type The portable constructor to use for import/export.
+ * @param name Alias for the field in the external source.
+ */
+export declare function Field<M, S>(type: PortableConstructor<M, S>, name: string): (target: void, context: ClassFieldDecoratorContext<PortableModel, S>) => void;
+/**
+ * Creates a portable wrapper for array types.
+ * @param type The portable type of the array elements.
+ */
+export declare function ArrayOf<M, S>(type: PortableConstructor<M, S>): PortableConstructor<M[], S[]>;
+/**
+ * Creates a portable wrapper for nullable types.
+ * @param type The inner portable type.
+ */
+export declare function Nullable<M, S>(type: PortableConstructor<M, S>): PortableConstructor<M | null, S | null>;
+/**
+ * Creates a portable wrapper for optional types.
+ * @param type The inner portable type.
+ */
+export declare function Optional<M, S>(type: PortableConstructor<M, S>): PortableConstructor<M | undefined, S | undefined>;
+/**
+ * Creates a wrapper for circular or deferred type references.
+ * @param resolver Function that returns the actual type constructor.
+ */
+export declare function Deferred<M, S>(resolver: (_: void) => PortableConstructor<M, S>): PortableConstructor<M, S>;
+/**
+ * Decorator to register a descendant class in the base class's polymorphic registry.
+ * @param descendant The subclass constructor to register.
+ */
+export declare function Descendant<M extends typeof PortableModel>(descendant: PortableConstructor): (target: M, context: ClassDecoratorContext) => void;