@cratis/fundamentals 7.15.0 → 7.15.2

package/json/for_PolygonJsonConverter/when_serializing_polygon_with_no_holes.ts

@@ -0,0 +1,33 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Point } from '../../geospatial/Point';
+import { LinearRing } from '../../geospatial/LinearRing';
+import { Polygon } from '../../geospatial/Polygon';
+import { JsonSerializer } from '../../JsonSerializer';
+
+describe('when serializing polygon with no holes', () => {
+    const shell = new LinearRing([
+        new Point(0, 0),
+        new Point(10, 0),
+        new Point(10, 10),
+        new Point(0, 10),
+        new Point(0, 0)
+    ]);
+    const polygon = new Polygon(shell, []);
+    const result = JsonSerializer.serialize(polygon);
+    const deserialized = JSON.parse(result);
+
+    it('should have type of Polygon', () => deserialized.type.should.equal('Polygon'));
+    it('should have coordinates array', () => deserialized.coordinates.should.be.an('array'));
+    it('should have one ring (shell only)', () => deserialized.coordinates.length.should.equal(1));
+    it('should have five points in shell', () => deserialized.coordinates[0].length.should.equal(5));
+    it('should have correct first point', () => {
+        deserialized.coordinates[0][0][0].should.equal(0);
+        deserialized.coordinates[0][0][1].should.equal(0);
+    });
+    it('should have correct last point (closed ring)', () => {
+        deserialized.coordinates[0][4][0].should.equal(0);
+        deserialized.coordinates[0][4][1].should.equal(0);
+    });
+});

package/json/for_PolygonJsonConverter/when_writing_polygon_with_polygon_converter.ts

@@ -0,0 +1,35 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Point } from '../../geospatial/Point';
+import { LinearRing } from '../../geospatial/LinearRing';
+import { Polygon } from '../../geospatial/Polygon';
+import { PolygonJsonConverter } from '../PolygonJsonConverter';
+
+describe('when writing polygon with polygon converter', () => {
+    const converter = new PolygonJsonConverter();
+    const polygon = new Polygon(
+        new LinearRing([
+            new Point(0, 0),
+            new Point(10, 0),
+            new Point(10, 10),
+            new Point(0, 10),
+            new Point(0, 0)
+        ]),
+        []
+    );
+    const result = converter.write(polygon);
+
+    it('should have type property', () => result.type.should.equal('Polygon'));
+    it('should have coordinates array', () => result.coordinates.should.be.instanceof(Array));
+    it('should have one ring', () => result.coordinates.length.should.equal(1));
+    it('should have five points in ring', () => result.coordinates[0].length.should.equal(5));
+    it('should have first point coordinates', () => {
+        result.coordinates[0][0][0].should.equal(0);
+        result.coordinates[0][0][1].should.equal(0);
+    });
+    it('should have closed ring', () => {
+        result.coordinates[0][0][0].should.equal(result.coordinates[0][4][0]);
+        result.coordinates[0][0][1].should.equal(result.coordinates[0][4][1]);
+    });
+});

package/json/for_TimeSpanJsonConverter/when_reading_timespan_with_timespan_converter.ts

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { TimeSpan } from '../../TimeSpan';
+import { TimeSpanJsonConverter } from '../TimeSpanJsonConverter';
+
+describe('when reading timespan with timespan converter', () => {
+    const converter = new TimeSpanJsonConverter();
+    const result = converter.read('1.02:30:45.678');
+
+    it('should return TimeSpan instance', () => result.should.be.instanceof(TimeSpan));
+    it('should have correct days', () => result.days.should.equal(1));
+    it('should have correct hours', () => result.hours.should.equal(2));
+    it('should have correct minutes', () => result.minutes.should.equal(30));
+    it('should have correct seconds', () => result.seconds.should.equal(45));
+});

package/json/for_TimeSpanJsonConverter/when_writing_timespan_with_timespan_converter.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { TimeSpan } from '../../TimeSpan';
+import { TimeSpanJsonConverter } from '../TimeSpanJsonConverter';
+
+describe('when writing timespan with timespan converter', () => {
+    const converter = new TimeSpanJsonConverter();
+    const timespan = TimeSpan.parse('1.02:30:45.678');
+    const result = converter.write(timespan);
+
+    it('should return timespan string', () => result.should.equal('1.02:30:45.678'));
+});

package/json/for_ValueMapJsonConverter/when_writing_valuemap_with_valuemap_converter.ts

@@ -0,0 +1,28 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Guid } from '../../Guid';
+import { ValueMap } from '../../ValueMap';
+import { JsonSerializer } from '../../JsonSerializer';
+
+class SimpleType {
+    id: Guid = Guid.empty;
+    name: string = '';
+}
+
+describe('when writing valuemap with valuemap converter', () => {
+    const valueMap = new ValueMap<string, SimpleType>();
+    
+    const item = new SimpleType();
+    item.id = Guid.parse('f47ac10b-58cc-4372-a567-0e02b2c3d479');
+    item.name = 'Test';
+    valueMap.set('key1', item);
+
+    const result = JsonSerializer.serialize(valueMap);
+    const parsed = JSON.parse(result);
+
+    it('should serialize to object', () => parsed.should.be.instanceof(Object));
+    it('should have key1 property', () => parsed.key1.should.not.be.undefined);
+    it('should serialize name property', () => parsed.key1.name.should.equal('Test'));
+    it('should serialize guid as string', () => parsed.key1.id.should.equal('f47ac10b-58cc-4372-a567-0e02b2c3d479'));
+});

package/json/index.ts

@@ -0,0 +1,11 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './JsonConverter';
+export * from './DateJsonConverter';
+export * from './GuidJsonConverter';
+export * from './TimeSpanJsonConverter';
+export * from './PointJsonConverter';
+export * from './LineStringJsonConverter';
+export * from './PolygonJsonConverter';
+export * from './ValueMapJsonConverter';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cratis/fundamentals",
-    "version": "7.15.0",
+    "version": "7.15.2",
     "description": "",
     "author": "Cratis",
     "license": "MIT",
@@ -24,6 +24,16 @@
             "types": "./dist/esm/index.d.ts",
             "require": "./dist/cjs/index.js",
             "import": "./dist/esm/index.js"
+        },
+        "./geospatial": {
+            "types": "./dist/esm/geospatial/index.d.ts",
+            "import": "./dist/esm/geospatial/index.js",
+            "require": "./dist/cjs/geospatial/index.js"
+        },
+        "./json": {
+            "types": "./dist/esm/json/index.d.ts",
+            "import": "./dist/esm/json/index.js",
+            "require": "./dist/cjs/json/index.js"
         }
     },
     "scripts": {

package/Coordinate.ts

@@ -1,38 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { field } from './fieldDecorator';
-
-/**
- * Represents a geographic coordinate with longitude and latitude.
- */
-export class Coordinate {
-    @field(Number)
-    longitude!: number;
-
-    @field(Number)
-    latitude!: number;
-
-    /**
-     * Creates a new Coordinate instance.
-     * @param {number} longitude - The longitude of the coordinate.
-     * @param {number} latitude - The latitude of the coordinate.
-     */
-    constructor(longitude?: number, latitude?: number) {
-        if (longitude !== undefined && latitude !== undefined) {
-            this.longitude = longitude;
-            this.latitude = latitude;
-        }
-    }
-
-    /**
-     * Converts the Coordinate to a JSON representation.
-     * @returns {object} JSON representation with longitude and latitude.
-     */
-    toJSON(): object {
-        return {
-            longitude: this.longitude,
-            latitude: this.latitude
-        };
-    }
-}

package/dist/Coordinate.d.ts

@@ -1,7 +0,0 @@
-export declare class Coordinate {
-    longitude: number;
-    latitude: number;
-    constructor(longitude?: number, latitude?: number);
-    toJSON(): object;
-}
-//# sourceMappingURL=Coordinate.d.ts.map

package/dist/Coordinate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Coordinate.d.ts","sourceRoot":"","sources":["../Coordinate.ts"],"names":[],"mappings":"AAQA,qBAAa,UAAU;IAEnB,SAAS,EAAG,MAAM,CAAC;IAGnB,QAAQ,EAAG,MAAM,CAAC;gBAON,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAWjD,MAAM,IAAI,MAAM;CAMnB"}

package/dist/Coordinate.js

@@ -1,27 +0,0 @@
-import { __decorate, __metadata } from "tslib";
-import { field } from './fieldDecorator';
-export class Coordinate {
-    longitude;
-    latitude;
-    constructor(longitude, latitude) {
-        if (longitude !== undefined && latitude !== undefined) {
-            this.longitude = longitude;
-            this.latitude = latitude;
-        }
-    }
-    toJSON() {
-        return {
-            longitude: this.longitude,
-            latitude: this.latitude
-        };
-    }
-}
-__decorate([
-    field(Number),
-    __metadata("design:type", Number)
-], Coordinate.prototype, "longitude", void 0);
-__decorate([
-    field(Number),
-    __metadata("design:type", Number)
-], Coordinate.prototype, "latitude", void 0);
-//# sourceMappingURL=Coordinate.js.map

package/dist/Coordinate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Coordinate.js","sourceRoot":"","sources":["../Coordinate.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAKzC,MAAM,OAAO,UAAU;IAEnB,SAAS,CAAU;IAGnB,QAAQ,CAAU;IAOlB,YAAY,SAAkB,EAAE,QAAiB;QAC7C,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACpD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC7B,CAAC;IACL,CAAC;IAMD,MAAM;QACF,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SAC1B,CAAC;IACN,CAAC;CACJ;AA3BG;IADC,KAAK,CAAC,MAAM,CAAC;;6CACK;AAGnB;IADC,KAAK,CAAC,MAAM,CAAC;;4CACI"}

package/dist/cjs/Coordinate.d.ts

@@ -1,7 +0,0 @@
-export declare class Coordinate {
-    longitude: number;
-    latitude: number;
-    constructor(longitude?: number, latitude?: number);
-    toJSON(): object;
-}
-//# sourceMappingURL=Coordinate.d.ts.map

package/dist/cjs/Coordinate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Coordinate.d.ts","sourceRoot":"","sources":["../../Coordinate.ts"],"names":[],"mappings":"AAQA,qBAAa,UAAU;IAEnB,SAAS,EAAG,MAAM,CAAC;IAGnB,QAAQ,EAAG,MAAM,CAAC;gBAON,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAWjD,MAAM,IAAI,MAAM;CAMnB"}

package/dist/cjs/Coordinate.js

@@ -1,32 +0,0 @@
-'use strict';
-
-var _tslib = require('./_virtual/_tslib.js');
-var fieldDecorator = require('./fieldDecorator.js');
-
-class Coordinate {
-    longitude;
-    latitude;
-    constructor(longitude, latitude) {
-        if (longitude !== undefined && latitude !== undefined) {
-            this.longitude = longitude;
-            this.latitude = latitude;
-        }
-    }
-    toJSON() {
-        return {
-            longitude: this.longitude,
-            latitude: this.latitude
-        };
-    }
-}
-_tslib.__decorate([
-    fieldDecorator.field(Number),
-    _tslib.__metadata("design:type", Number)
-], Coordinate.prototype, "longitude", void 0);
-_tslib.__decorate([
-    fieldDecorator.field(Number),
-    _tslib.__metadata("design:type", Number)
-], Coordinate.prototype, "latitude", void 0);
-
-exports.Coordinate = Coordinate;
-//# sourceMappingURL=Coordinate.js.map

package/dist/cjs/Coordinate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Coordinate.js","sources":["../../Coordinate.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { field } from './fieldDecorator';\n\n/**\n * Represents a geographic coordinate with longitude and latitude.\n */\nexport class Coordinate {\n    @field(Number)\n    longitude!: number;\n\n    @field(Number)\n    latitude!: number;\n\n    /**\n     * Creates a new Coordinate instance.\n     * @param {number} longitude - The longitude of the coordinate.\n     * @param {number} latitude - The latitude of the coordinate.\n     */\n    constructor(longitude?: number, latitude?: number) {\n        if (longitude !== undefined && latitude !== undefined) {\n            this.longitude = longitude;\n            this.latitude = latitude;\n        }\n    }\n\n    /**\n     * Converts the Coordinate to a JSON representation.\n     * @returns {object} JSON representation with longitude and latitude.\n     */\n    toJSON(): object {\n        return {\n            longitude: this.longitude,\n            latitude: this.latitude\n        };\n    }\n}\n"],"names":["__decorate","field"],"mappings":";;;;;MAQa,UAAU,CAAA;AAEnB,IAAA,SAAS;AAGT,IAAA,QAAQ;IAOR,WAAA,CAAY,SAAkB,EAAE,QAAiB,EAAA;QAC7C,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE;AACnD,YAAA,IAAI,CAAC,SAAS,GAAG,SAAS;AAC1B,YAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;QAC5B;IACJ;IAMA,MAAM,GAAA;QACF,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC;SAClB;IACL;AACH;AA3BGA,iBAAA,CAAA;IADCC,oBAAK,CAAC,MAAM,CAAC;;AACK,CAAA,EAAA,UAAA,CAAA,SAAA,EAAA,WAAA,EAAA,MAAA,CAAA;AAGnBD,iBAAA,CAAA;IADCC,oBAAK,CAAC,MAAM,CAAC;;AACI,CAAA,EAAA,UAAA,CAAA,SAAA,EAAA,UAAA,EAAA,MAAA,CAAA;;;;"}

package/dist/esm/Coordinate.d.ts

@@ -1,7 +0,0 @@
-export declare class Coordinate {
-    longitude: number;
-    latitude: number;
-    constructor(longitude?: number, latitude?: number);
-    toJSON(): object;
-}
-//# sourceMappingURL=Coordinate.d.ts.map

package/dist/esm/Coordinate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Coordinate.d.ts","sourceRoot":"","sources":["../../Coordinate.ts"],"names":[],"mappings":"AAQA,qBAAa,UAAU;IAEnB,SAAS,EAAG,MAAM,CAAC;IAGnB,QAAQ,EAAG,MAAM,CAAC;gBAON,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAWjD,MAAM,IAAI,MAAM;CAMnB"}

package/dist/esm/Coordinate.js

@@ -1,30 +0,0 @@
-import { __decorate, __metadata } from './_virtual/_tslib.js';
-import { field } from './fieldDecorator.js';
-
-class Coordinate {
-    longitude;
-    latitude;
-    constructor(longitude, latitude) {
-        if (longitude !== undefined && latitude !== undefined) {
-            this.longitude = longitude;
-            this.latitude = latitude;
-        }
-    }
-    toJSON() {
-        return {
-            longitude: this.longitude,
-            latitude: this.latitude
-        };
-    }
-}
-__decorate([
-    field(Number),
-    __metadata("design:type", Number)
-], Coordinate.prototype, "longitude", void 0);
-__decorate([
-    field(Number),
-    __metadata("design:type", Number)
-], Coordinate.prototype, "latitude", void 0);
-
-export { Coordinate };
-//# sourceMappingURL=Coordinate.js.map

package/dist/esm/Coordinate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Coordinate.js","sources":["../../Coordinate.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { field } from './fieldDecorator';\n\n/**\n * Represents a geographic coordinate with longitude and latitude.\n */\nexport class Coordinate {\n    @field(Number)\n    longitude!: number;\n\n    @field(Number)\n    latitude!: number;\n\n    /**\n     * Creates a new Coordinate instance.\n     * @param {number} longitude - The longitude of the coordinate.\n     * @param {number} latitude - The latitude of the coordinate.\n     */\n    constructor(longitude?: number, latitude?: number) {\n        if (longitude !== undefined && latitude !== undefined) {\n            this.longitude = longitude;\n            this.latitude = latitude;\n        }\n    }\n\n    /**\n     * Converts the Coordinate to a JSON representation.\n     * @returns {object} JSON representation with longitude and latitude.\n     */\n    toJSON(): object {\n        return {\n            longitude: this.longitude,\n            latitude: this.latitude\n        };\n    }\n}\n"],"names":[],"mappings":";;;MAQa,UAAU,CAAA;AAEnB,IAAA,SAAS;AAGT,IAAA,QAAQ;IAOR,WAAA,CAAY,SAAkB,EAAE,QAAiB,EAAA;QAC7C,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE;AACnD,YAAA,IAAI,CAAC,SAAS,GAAG,SAAS;AAC1B,YAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;QAC5B;IACJ;IAMA,MAAM,GAAA;QACF,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC;SAClB;IACL;AACH;AA3BG,UAAA,CAAA;IADC,KAAK,CAAC,MAAM,CAAC;;AACK,CAAA,EAAA,UAAA,CAAA,SAAA,EAAA,WAAA,EAAA,MAAA,CAAA;AAGnB,UAAA,CAAA;IADC,KAAK,CAAC,MAAM,CAAC;;AACI,CAAA,EAAA,UAAA,CAAA,SAAA,EAAA,UAAA,EAAA,MAAA,CAAA;;;;"}

package/for_Coordinate/when_creating_coordinate.ts

@@ -1,11 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { Coordinate } from '../Coordinate';
-
-describe('when creating coordinate', () => {
-    const coordinate = new Coordinate(10.5, 20.3);
-
-    it('should have correct longitude', () => coordinate.longitude.should.equal(10.5));
-    it('should have correct latitude', () => coordinate.latitude.should.equal(20.3));
-});

package/for_Coordinate/when_deserializing_coordinate.ts

@@ -1,14 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { Coordinate } from '../Coordinate';
-import { JsonSerializer } from '../JsonSerializer';
-
-describe('when deserializing coordinate', () => {
-    const json = '{"longitude":10.5,"latitude":20.3}';
-    const result = JsonSerializer.deserialize(Coordinate, json);
-
-    it('should be a coordinate', () => result.should.be.instanceof(Coordinate));
-    it('should have correct longitude', () => result.longitude.should.equal(10.5));
-    it('should have correct latitude', () => result.latitude.should.equal(20.3));
-});

package/for_Coordinate/when_deserializing_coordinate_with_missing_properties.ts

@@ -1,13 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { Coordinate } from '../Coordinate';
-import { JsonSerializer } from '../JsonSerializer';
-
-describe('when deserializing coordinate with missing properties', () => {
-    const json = '{"longitude":10.5}';
-
-    it('should throw an error', () => {
-        (() => JsonSerializer.deserialize(Coordinate, json)).should.throw('Cannot deserialize Coordinate: longitude and latitude are required');
-    });
-});

package/for_Coordinate/when_serializing_coordinate.ts

@@ -1,14 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { Coordinate } from '../Coordinate';
-import { JsonSerializer } from '../JsonSerializer';
-
-describe('when serializing coordinate', () => {
-    const coordinate = new Coordinate(10.5, 20.3);
-    const result = JsonSerializer.serialize(coordinate);
-    const deserialized = JSON.parse(result);
-
-    it('should have correct longitude', () => deserialized.longitude.should.equal(10.5));
-    it('should have correct latitude', () => deserialized.latitude.should.equal(20.3));
-});