adaptive-extender 0.10.5 → 0.11.1

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## 0.11.1 (21.06.2026)
+- Added `Array.Of(type)` portable adapter for typed arrays, alongside the existing `Array.import`/`Array.export`.
+- Added `Set.Of(type)` portable adapter for typed sets.
+- Added `Map.AsRecord(type)` and `Map.AsTuples(typeKey, typeValue)` portable adapters (moved from a separate module into [map](./src/core/map.ts)).
+- Added `Date.AsTimestamp` and `Date.AsUnixSeconds` portable adapters converting `Date` to millisecond and Unix-second numbers respectively.
+- Added `Number.prototype.snap(step)` — snaps a number to the nearest multiple of the given step.
+- **Breaking:** Removed `Reflect.mapNull`, `Reflect.mapUndefined`, and `Reflect.mapNullable`. Use `Nullable.map`, `Optional.map` from the portable module instead.
+- **Breaking:** Renamed `Archive`/`ArchiveManager`/`ArchiveRepository` to `Cell`/`PortableCell`/`BufferedCell`. Construction is now done via `Storage` factory methods (`localStorage.openCell`, `localStorage.openPortableCell`, `localStorage.openBufferedCell`) — the storage backend is no longer hardcoded to `localStorage`.
+- **Breaking:** `@Field` decorator no longer accepts a positional string as the second argument. Use `{ name: "..." }` options object: `@Field(String, { name: "fieldName" })`.
+- `PortableCell.save()` returns `Promise<boolean>` — resolves `true` when persisted, `false` if cancelled (superseded or aborted); rejects only on serialization failure.
+
 ## 0.10.5 (13.06.2026)
 - Bugfix at [portable](./src/core/portable.ts).
 
@@ -16,7 +27,7 @@
 ## 0.9.13 (06.04.2026)
 - Added `Version` class for semantic versioning with `parse()`, `tryParse()` support.
 - Added `BigInt` portable support via `BigInt.import()` and `BigInt.export()`.
-- `ArchiveRepository.save()` is now `async` and returns `Promise<void>`. The promise resolves when the save completes and rejects on failure. A pending save is cancelled (with an `AbortError`) when superseded by a new call.
+- `ArchiveRepository.save()` is now `async` and returns `Promise<boolean>`. The promise resolves `true` when the save completes, `false` if cancelled (superseded by a subsequent call or aborted via `abort()`), and rejects only on serialization failure.
 - `Promise.withSignal` now has a default type parameter `T = void`.
 - Renamed `EnumFrom` adapter to `EnumAs`.
 

package/README.md

@@ -412,10 +412,10 @@ const repository = new ArchiveRepository("settings", Settings, new Settings());
 const settings = repository.content;
 settings.volume = 0.5;
 
-// save() is async — resolves when the write completes, rejects on failure
-await repository.save(); // save immediately
+// save() resolves true when persisted, false if cancelled (superseded or aborted), rejects only on serialization failure
+const saved = await repository.save(); // save immediately
 await repository.save(3000); // debounced — save after 3 seconds
-// A pending save is cancelled (AbortError) when superseded by a new call
+// A pending save resolves false when superseded by a new call or cancelled by abort()
 repository.reset(); // abort pending save and revert to initial state
 ```
 

package/dist/core/array.d.ts

@@ -1,4 +1,5 @@
 import "./global.js";
+import { type PortableConstructor } from "./portable.js";
 declare global {
     export interface ArrayConstructor {
         /**
@@ -13,6 +14,11 @@ declare global {
          * @param source The array to export.
          */
         export(source: any[]): any[];
+        /**
+         * Creates a portable wrapper for array types.
+         * @param type The portable type of the array elements.
+         */
+        Of<I, S>(type: PortableConstructor<I, S>): PortableConstructor<I[], S[]>;
         /**
          * 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,6 +1,7 @@
 "use strict";
 import "./global.js";
 import {} from "./promise.js";
+import {} from "./portable.js";
 const { trunc } = Math;
 Array.import = function (source, name) {
     if (!Array.isArray(source))
@@ -10,6 +11,22 @@ Array.import = function (source, name) {
 Array.export = function (source) {
     return source;
 };
+Array.Of = function (type) {
+    return {
+        [Symbol.hasInstance](instance) {
+            return Array[Symbol.hasInstance](instance);
+        },
+        get name() {
+            return `${type.name}[]`;
+        },
+        import(source, name) {
+            return Array.import(source, name).map((item, index) => type.import(item, `${name}[${index}]`));
+        },
+        export(source) {
+            return source.map(item => type.export(item));
+        },
+    };
+};
 Array.range = function (min, max) {
     min = trunc(min);
     max = trunc(max);
@@ -67,3 +84,4 @@ Array.prototype.remove = function (value) {
     this.splice(index, 1);
     return true;
 };
+//# sourceMappingURL=array.js.map

package/dist/core/array.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/core/array.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,aAAa,CAAC;AACrB,OAAO,EAAmB,MAAM,cAAc,CAAC;AAE/C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;AAiEvB,KAAK,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxH,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,KAAK,CAAC,MAAM,GAAG,UAAU,MAAa;IACrC,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,KAAK,CAAC,KAAK,GAAG,UAAU,GAAW,EAAE,GAAW;IAC/C,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC,EAAsB,GAAG,SAA6C;IAC1F,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM;QAC/C,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAM,CAAC;IAChD,CAAC;AACF,CAAC,CAAC;AAEF,KAAK,CAAC,SAAS,GAAG,KAAK,WAAiB,QAAwC,EAAE,MAAiD,EAAE,OAAiB;IACrJ,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,KAAK,EAAE,CAAC;YACR,SAAS;QACV,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACzC,KAAK,EAAE,CAAC;YACR,SAAS;QACV,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,KAAK,EAAE,CAAC;IACT,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,UAAU,MAAc,EAAE,MAAc;IAC9D,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAC1B,CAAC,CAAC;AAEF,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,UAAwB,MAAc,EAAE,QAAW;IAC3E,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,UAAwB,KAAQ;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/core/array.ts"],"names":[],"mappings":"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"}

package/dist/core/bigint.js

@@ -8,3 +8,4 @@ BigInt.import = function (source, name) {
 BigInt.export = function (source) {
     return source.toString();
 };
+//# sourceMappingURL=bigint.js.map

package/dist/core/boolean.js

@@ -8,3 +8,4 @@ Boolean.import = function (source, name) {
 Boolean.export = function (source) {
     return source.valueOf();
 };
+//# sourceMappingURL=boolean.js.map

package/dist/core/color.js

@@ -518,3 +518,4 @@ export class Color {
         return this;
     }
 }
+//# sourceMappingURL=color.js.map

package/dist/core/controller.js

@@ -50,3 +50,4 @@ export class Controller {
         }
     }
 }
+//# sourceMappingURL=controller.js.map

package/dist/core/date.d.ts

@@ -1,8 +1,9 @@
 import "./global.js";
+import { type PortableConstructor } from "./portable.js";
 declare global {
     export interface DateConstructor {
         /**
-         * Validates and imports a date value from a raw source.
+         * Validates and imports a date value from a raw ISO string source.
          * @param source The raw value to check.
          * @param name The field name for error context.
          * @throws {TypeError} If the source is not a string.
@@ -18,6 +19,14 @@ declare global {
          * @returns `true` if the value is a `Date` and is invalid; otherwise, `false`.
          */
         isInvalid(date: unknown): boolean;
+        /**
+         * Portable adapter that converts between `Date` instances and millisecond timestamps.
+         */
+        AsTimestamp: PortableConstructor<Date, number>;
+        /**
+         * Portable adapter that converts between `Date` instances and Unix second timestamps.
+         */
+        AsUnixSeconds: PortableConstructor<Date, number>;
     }
     export interface Date {
         /**

package/dist/core/date.js

@@ -1,5 +1,6 @@
 "use strict";
 import "./global.js";
+import {} from "./portable.js";
 Date.import = function (source, name) {
     if (typeof (source) !== "string")
         throw new TypeError(`Unable to import date from ${name} due its ${typename(source)} type`);
@@ -13,8 +14,41 @@ Date.isInvalid = function (date) {
         return false;
     return Number.isNaN(date.getTime());
 };
+Date.AsTimestamp = {
+    [Symbol.hasInstance](instance) {
+        return Date[Symbol.hasInstance](instance);
+    },
+    get name() {
+        return "Timestamp";
+    },
+    import(source, name) {
+        if (typeof (source) !== "number")
+            throw new TypeError(`Unable to import date from ${name} due its ${typename(source)} type`);
+        return new Date(source);
+    },
+    export(source) {
+        return source.getTime();
+    },
+};
+Date.AsUnixSeconds = {
+    [Symbol.hasInstance](instance) {
+        return Date[Symbol.hasInstance](instance);
+    },
+    get name() {
+        return "UnixSeconds";
+    },
+    import(source, name) {
+        if (typeof (source) !== "number")
+            throw new TypeError(`Unable to import date from ${name} due its ${typename(source)} type`);
+        return new Date(source * 1000);
+    },
+    export(source) {
+        return Math.trunc(source.getTime() / 1000);
+    },
+};
 Date.prototype.insteadInvalid = function (value) {
     if (Date.isInvalid(this))
         return value;
     return this;
 };
+//# sourceMappingURL=date.js.map

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;AAkCrB,IAAI,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IAChD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7H,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,IAAI,CAAC,MAAM,GAAG,UAAU,MAAY;IACnC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAC7B,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;AACrB,OAAO,EAA4B,MAAM,eAAe,CAAC;AA0CzD,IAAI,CAAC,MAAM,GAAG,UAAU,MAAW,EAAE,IAAY;IAChD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7H,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,IAAI,CAAC,MAAM,GAAG,UAAU,MAAY;IACnC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAC7B,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,WAAW,GAAG;IAClB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAa;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI;QACP,OAAO,WAAW,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,MAAW,EAAE,IAAY;QAC/B,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7H,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,MAAY;QAClB,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACoC,CAAC;AAEvC,IAAI,CAAC,aAAa,GAAG;IACpB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAa;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI;QACP,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,MAAW,EAAE,IAAY;QAC/B,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,IAAI,YAAY,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7H,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,MAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;CACoC,CAAC;AAEvC,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/engine.js

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

package/dist/core/environment.js

@@ -22,3 +22,4 @@ export class EnvironmentProvider {
         }
     }
 }
+//# sourceMappingURL=environment.js.map

package/dist/core/error.js

@@ -29,3 +29,4 @@ export class ImplementationError extends Error {
         this.name = "ImplementationError";
     }
 }
+//# sourceMappingURL=error.js.map

package/dist/core/function.js

@@ -4,3 +4,4 @@ Object.defineProperty(Function, "empty", {
     writable: false,
 });
 export {};
+//# sourceMappingURL=function.js.map

package/dist/core/global.js

@@ -1,5 +1,4 @@
 "use strict";
-Reflect.set(Symbol, "metadata", Reflect.get(Symbol, "metadata") ?? Symbol.for("Symbol.metadata"));
 globalThis.constructor = function (value) {
     return value.constructor;
 };
@@ -11,3 +10,4 @@ globalThis.typename = function (value) {
     }
 };
 export {};
+//# sourceMappingURL=global.js.map

package/dist/core/index.js

@@ -27,3 +27,4 @@ export * from "./engine.js";
 export * from "./controller.js";
 export * from "./function.js";
 export * from "./environment.js";
+//# sourceMappingURL=index.js.map

package/dist/core/map.d.ts

@@ -1,4 +1,18 @@
+import { type PortableConstructor } from "./portable.js";
 declare global {
+    export interface MapConstructor {
+        /**
+         * Creates a portable wrapper for maps with string keys, converting them to and from plain objects.
+         * @param type The portable type of the map values.
+         */
+        AsRecord<I, S>(type: PortableConstructor<I, S>): PortableConstructor<Map<string, I>, Record<string, S>>;
+        /**
+         * Creates a portable wrapper for maps with arbitrary key and value types, converting them to and from arrays of `[key, value]` tuples.
+         * @param typeKey The portable type of the map keys.
+         * @param typeValue The portable type of the map values.
+         */
+        AsTuples<IK, SK, IV, SV>(typeKey: PortableConstructor<IK, SK>, typeValue: PortableConstructor<IV, SV>): PortableConstructor<Map<IK, IV>, [SK, SV][]>;
+    }
     export interface Map<K, V> {
         /**
          * Adds the key/value pair only if the key is not already present.
@@ -9,4 +23,3 @@ declare global {
         add(key: K, value: V): boolean;
     }
 }
-export {};

package/dist/core/map.js

@@ -1,8 +1,55 @@
 "use strict";
+import {} from "./portable.js";
+Map.AsRecord = function (type) {
+    return {
+        [Symbol.hasInstance](instance) {
+            return Map[Symbol.hasInstance](instance);
+        },
+        get name() {
+            return `Map<string, ${type.name}>`;
+        },
+        import(source, name) {
+            const record = Object.import(source, name);
+            const map = new Map();
+            for (const key of Object.keys(record)) {
+                map.set(key, type.import(Reflect.get(record, key), `${name}[${JSON.stringify(key)}]`));
+            }
+            return map;
+        },
+        export(source) {
+            const record = {};
+            for (const [key, value] of source) {
+                Reflect.set(record, key, type.export(value));
+            }
+            return record;
+        },
+    };
+};
+Map.AsTuples = function (typeKey, typeValue) {
+    return {
+        [Symbol.hasInstance](instance) {
+            return Map[Symbol.hasInstance](instance);
+        },
+        get name() {
+            return `Map<${typeKey.name}, ${typeValue.name}>`;
+        },
+        import(source, name) {
+            return new Map(Array.import(source, name).map((item, index) => {
+                const tuple = Array.import(item, `${name}[${index}]`);
+                const key = typeKey.import(tuple[0], `${name}[${index}][0]`);
+                const value = typeValue.import(tuple[1], `${name}[${index}][1]`);
+                return [key, value];
+            }));
+        },
+        export(source) {
+            return Array.from(source, ([key, value]) => [typeKey.export(key), typeValue.export(value)]);
+        },
+    };
+};
 Map.prototype.add = function (key, value) {
     if (this.has(key))
         return false;
     this.set(key, value);
     return true;
 };
-export {};
+//# sourceMappingURL=map.js.map

package/dist/core/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/core/map.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAcb,GAAG,CAAC,SAAS,CAAC,GAAG,GAAG,UAAiC,GAAM,EAAE,KAAQ;IACpE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF,OAAO,EAAG,CAAC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/core/map.ts"],"names":[],"mappings":"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"}

package/dist/core/math.d.ts

@@ -36,6 +36,11 @@ declare global {
          * @throws {RangeError} When the length is zero.
          */
         mod(start: number, length: number): number;
+        /**
+         * Snaps the number to the nearest multiple of the given step.
+         * @param step The step size to snap to.
+         */
+        snap(step: number): number;
     }
 }
 declare global {

package/dist/core/math.js

@@ -1,5 +1,5 @@
 "use strict";
-const { PI, trunc, pow } = Math;
+const { PI, trunc, pow, round } = Math;
 Number.prototype.clamp = function (min, max) {
     let result = this.valueOf();
     if (result < min)
@@ -8,6 +8,11 @@ Number.prototype.clamp = function (min, max) {
         return max;
     return result;
 };
+function normalize(value, min, max) {
+    if (min === max)
+        throw new Error("Minimum and maximum of the original range cant be equal");
+    return (value - min) / (max - min);
+}
 function lerp(value, min1, max1, min2, max2) {
     if (min1 === max1)
         throw new Error("Minimum and maximum of the original range cant be equal");
@@ -17,18 +22,24 @@ function lerp(value, min1, max1, min2, max2) {
 }
 Number.prototype.lerp = function (min1, max1, min2, max2) {
     if (min2 === undefined || max2 === undefined)
-        return lerp(this.valueOf(), min1, max1, 0, 1);
+        return normalize(this.valueOf(), min1, max1);
     return lerp(this.valueOf(), min1, max1, min2, max2);
 };
-function mod(value, start, length) {
+function repeat(value, length) {
     if (length === 0)
         throw new RangeError("Length must not be zero");
-    return ((value - start) % length + length) % length + start;
+    return (value % length + length) % length;
+}
+function wrap(value, start, length) {
+    return repeat(value - start, length) + start;
 }
 Number.prototype.mod = function (arg1, arg2) {
     if (arg2 === undefined)
-        return mod(this.valueOf(), 0, arg1);
-    return mod(this.valueOf(), arg1, arg2);
+        return repeat(this.valueOf(), arg1);
+    return wrap(this.valueOf(), arg1, arg2);
+};
+Number.prototype.snap = function (step) {
+    return round(this.valueOf() / step) * step;
 };
 Math.split = function (x) {
     const integer = trunc(x);
@@ -70,3 +81,4 @@ Math.meanHarmonic = function (...values) {
     return values.length / summary;
 };
 export {};
+//# sourceMappingURL=math.js.map

package/dist/core/math.js.map

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

package/dist/core/number.js

@@ -26,3 +26,4 @@ Number.prototype.insteadZero = function (value) {
         return value;
     return current;
 };
+//# sourceMappingURL=number.js.map

package/dist/core/object.js

@@ -8,3 +8,4 @@ Object.export = function (source) {
     return source;
 };
 export {};
+//# sourceMappingURL=object.js.map

package/dist/core/portable.d.ts

@@ -3,7 +3,9 @@ import "./string.js";
 import "./boolean.js";
 import "./array.js";
 import "./object.js";
+import "./map.js";
 import "./reflect.js";
+import "./error.js";
 import { type Constructor } from "./global.js";
 /**
  * Represents a constructor that supports facilitating the safe conversion between anonymous schemes and typed instances.
@@ -22,6 +24,19 @@ export interface PortableConstructor<I = any, S = unknown> extends Constructor<I
      */
     export(source: I): S;
 }
+/**
+ * Options for the {@link Field} decorator.
+ */
+export interface FieldOptions<I> {
+    /**
+     * Alias for the field key in the external source.
+     */
+    name: string;
+    /**
+     * Fallback value used when the source key is absent during import.
+     */
+    fallback: I;
+}
 /**
  * The abstract base class for all portable data models.
  * Provides mechanism for type-safe import and export of data structures.
@@ -48,9 +63,14 @@ export declare function Field<I, S>(type: PortableConstructor<I, S>): (target: v
 /**
  * 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.
+ * @param options Configuration for aliasing and migration defaults.
+ */
+export declare function Field<I, S>(type: PortableConstructor<I, S>, options: Partial<FieldOptions<I>>): (target: void, context: ClassFieldDecoratorContext<Model, I>) => void;
+/**
+ * Creates a wrapper for circular or deferred type references.
+ * @param resolver Function that returns the actual type constructor.
  */
-export declare function Field<I, S>(type: PortableConstructor<I, S>, name: string): (target: void, context: ClassFieldDecoratorContext<Model, I>) => void;
+export declare function Deferred<I, S>(resolver: (_: void) => PortableConstructor<I, S>): PortableConstructor<I, S>;
 /**
  * Decorator to register a descendant class in the base class's polymorphic registry.
  * @param descendant The subclass constructor to register.
@@ -68,55 +88,60 @@ export declare function Descendant<M extends typeof Model>(descendant: PortableC
  */
 export declare function DiscriminatorKey<M extends typeof Model>(key: string): (target: M, context: ClassDecoratorContext) => void;
 /**
- * Creates a wrapper for circular or deferred type references.
- * @param resolver Function that returns the actual type constructor.
- */
-export declare function Deferred<I, S>(resolver: (_: void) => PortableConstructor<I, S>): PortableConstructor<I, S>;
-/**
- * Creates a portable wrapper for optional types.
- * @param type The inner portable type.
+ * Portable adapter class for optional (possibly-undefined) types.
+ * Use `Optional.Of(type)` to wrap an adapter, and `Optional.map` for conditional mapping.
  */
-export declare function Optional<I, S>(type: PortableConstructor<I, S>): PortableConstructor<I | undefined, S | undefined>;
-/**
- * Creates a portable wrapper for nullable types.
- * @param type The inner portable type.
- */
-export declare function Nullable<I, S>(type: PortableConstructor<I, S>): PortableConstructor<I | null, S | null>;
-/**
- * Creates a portable wrapper for array types.
- * @param type The portable type of the array elements.
- */
-export declare function ArrayOf<I, S>(type: PortableConstructor<I, S>): PortableConstructor<I[], S[]>;
-/**
- * Creates a portable wrapper for set types.
- * @param type The portable type of the set elements.
- */
-export declare function SetOf<I, S>(type: PortableConstructor<I, S>): PortableConstructor<Set<I>, S[]>;
-/**
- * Creates a portable wrapper for maps with string keys, converting them to and from plain objects.
- * @param value The portable type of the map values.
- */
-export declare function RecordOf<I, S>(type: PortableConstructor<I, S>): PortableConstructor<Map<string, I>, Record<string, S>>;
-/**
- * Creates a portable wrapper for maps with arbitrary key and value types, converting them to and from arrays of `[key, value]` tuples.
- * @param key The portable type of the map keys.
- * @param value The portable type of the map values.
- */
-export declare function MapOf<IK, SK, IV, SV>(typeKey: PortableConstructor<IK, SK>, typeValue: PortableConstructor<IV, SV>): PortableConstructor<Map<IK, IV>, [SK, SV][]>;
-/**
- * Creates a portable wrapper for enum types, strictly operating only on enum values.
- * @param reference The enum object reference.
- */
-export declare function EnumAs<T extends Readonly<Record<string, unknown>>>(reference: T): PortableConstructor<T[keyof T], T[keyof T]>;
+export declare class Optional {
+    constructor();
+    /**
+     * Creates a portable wrapper for optional types.
+     * @param type The inner portable type.
+     */
+    static Of<I, S>(type: PortableConstructor<I, S>): PortableConstructor<I | undefined, S | undefined>;
+    /**
+     * Applies a callback to a non-undefined value, or passes through `undefined` unchanged.
+     * @param value The value to map.
+     * @param callback The function to apply if the value is not undefined.
+     */
+    static map<T, R>(value: T, callback: (value: Defined<T>) => R): R | UndefinedFrom<T>;
+}
 /**
- * A portable adapter that facilitates the conversion between `Date` instances and millisecond timestamps.
+ * Portable adapter class for nullable (possibly-null) types.
+ * Use `Nullable.Of(type)` to wrap an adapter, and `Nullable.map` for conditional mapping.
  */
-export declare const Timestamp: PortableConstructor<Date, number>;
+export declare class Nullable {
+    constructor();
+    /**
+     * Creates a portable wrapper for nullable types.
+     * @param type The inner portable type.
+     */
+    static Of<I, S>(type: PortableConstructor<I, S>): PortableConstructor<I | null, S | null>;
+    /**
+     * Applies a callback to a non-null value, or passes through `null` unchanged.
+     * @param value The value to map.
+     * @param callback The function to apply if the value is not null.
+     */
+    static map<T, R>(value: T, callback: (value: NotNull<T>) => R): R | NullFrom<T>;
+}
 /**
- * A portable adapter that facilitates the conversion between `Date` instances and Unix second timestamps.
+ * Portable adapter class for enum types.
+ * Use `Enum.Of(reference)` to create an adapter that validates against enum values.
  */
-export declare const UnixSeconds: PortableConstructor<Date, number>;
+export declare class Enum {
+    constructor();
+    /**
+     * Creates a portable wrapper for enum types, strictly operating only on enum values.
+     * @param reference The enum object reference.
+     */
+    static Of<T extends Readonly<Record<string, unknown>>>(reference: T): PortableConstructor<T[keyof T], T[keyof T]>;
+}
 /**
- * A portable adapter that allows any value to pass through without validation or transformation.
+ * Portable adapter class for unknown/any types.
+ * Pass `Any` directly to `@Field` to allow any value without validation or transformation.
  */
-export declare const Any: PortableConstructor<any, any>;
+export declare class Any {
+    constructor();
+    static [Symbol.hasInstance](instance: any): boolean;
+    static import(source: any, name: string): any;
+    static export(source: any): any;
+}