@cratis/fundamentals 7.22.3 → 7.22.5

package/for_TimeOnly/when_parsing_times_that_differ_below_a_millisecond.ts

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { TimeOnly } from '../TimeOnly';
+
+describe('when parsing times that differ below a millisecond', () => {
+    const first = TimeOnly.parse('10:11:12.1234567');
+    const second = TimeOnly.parse('10:11:12.1239999');
+
+    it('should not be equal', () => first.equals(second).should.be.false);
+    it('should render the full seven digit fraction', () => first.toString().should.equal('10:11:12.1234567'));
+    it('should render differently', () => first.toJSON().should.not.equal(second.toJSON()));
+    it('should be equal to the same time written with trailing zeros', () => TimeOnly.parse('10:11:12.1230000').equals(TimeOnly.parse('10:11:12.123')).should.be.true);
+});

package/for_TimeOnly/when_rendering_a_fraction.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.
+
+import { TimeOnly } from '../TimeOnly';
+
+describe('when rendering a fraction', () => {
+    it('should keep the three digit form when there is no part below the millisecond', () => TimeOnly.parse('10:11:12.1').toString().should.equal('10:11:12.100'));
+    it('should pad to seven digits when there is a part below the millisecond', () => TimeOnly.parse('10:11:12.1230100').toString().should.equal('10:11:12.1230100'));
+    it('should pad a short part below the millisecond', () => TimeOnly.parse('10:11:12.0000001').toString().should.equal('10:11:12.0000001'));
+    it('should render the time alone when there is no fraction', () => TimeOnly.parse('10:11:12').toString().should.equal('10:11:12'));
+});

package/for_TimeSpan/when_parsing_out_of_range_time.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.
+
+import { TimeSpan } from '../TimeSpan';
+
+describe('when parsing out of range time', () => {
+    it('should reject minutes above 59', () => (() => TimeSpan.parse('00:60:00')).should.throw('minutes 60 is out of range'));
+    it('should reject seconds above 59', () => (() => TimeSpan.parse('00:00:60')).should.throw('seconds 60 is out of range'));
+    it('should reject hours above 23', () => (() => TimeSpan.parse('1.24:00:00')).should.throw('hours 24 is out of range'));
+    it('should reject hours above 23 without days', () => (() => TimeSpan.parse('25:00:00')).should.throw('hours 25 is out of range'));
+});

package/for_TimeSpan/when_parsing_the_largest_in_range_time_span.ts

@@ -0,0 +1,10 @@
+// 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';
+
+describe('when parsing the largest in range time span', () => {
+    const parsed = TimeSpan.parse('1.23:59:59');
+
+    it('should render back to what it was parsed from', () => parsed.toString().should.equal('1.23:59:59'));
+});

package/for_TimeSpan/when_parsing_time_beyond_what_a_time_span_can_hold.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.
+
+import { TimeSpan } from '../TimeSpan';
+
+describe('when parsing time beyond what a time span can hold', () => {
+    it('should reject more days than the maximum', () => (() => TimeSpan.parse('10675200.00:00:00')).should.throw('days 10675200 is out of range'));
+    it('should reject the maximum days with a remainder above the maximum', () => (() => TimeSpan.parse('10675199.02:48:05.4775808')).should.throw('outside the range'));
+    it('should accept the maximum value', () => TimeSpan.parse('10675199.02:48:05.4775807').days.should.equal(10675199));
+    it('should accept the minimum value', () => TimeSpan.parse('-10675199.02:48:05.4775808').days.should.equal(-10675199));
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cratis/fundamentals",
-    "version": "7.22.3",
+    "version": "7.22.5",
     "description": "The shared building blocks beneath the Cratis stack — GUIDs, concepts, derived-type serialization, property-path proxies, and decorators for TypeScript",
     "keywords": [
         "cratis",

package/typeKey.ts

@@ -55,3 +55,12 @@ export const valueMapTypeKey = 'ValueMap';
 
 /** The key `Guid` declares. */
 export const guidTypeKey = 'Guid';
+
+/** The key `DateOnly` declares. */
+export const dateOnlyTypeKey = 'DateOnly';
+
+/** The key `TimeOnly` declares. */
+export const timeOnlyTypeKey = 'TimeOnly';
+
+/** The key `TimeSpan` declares. */
+export const timeSpanTypeKey = 'TimeSpan';