Formats

src/format/date-time.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -30,19 +26,17 @@ THE SOFTWARE.
 
 import { FormatRegistry } from '../type/index'
 
-// ------------------------------------------------------------------
-// This code ported form the ajv-format project for compatibility. 
-// All credit goes to Evgeny Poberezkin and contributors.
-// ------------------------------------------------------------------
-
 import { IsDate } from './date'
 import { IsTime } from './time'
 
 const DateTimeSeperator = /t|\s/i
 
 /**
  * Returns true of this string is a date-time
- * @documentation https://datatracker.ietf.org/doc/html/rfc3339#section-5.6
+ * @spec https://datatracker.ietf.org/doc/html/rfc3339#section-5.6
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `2020-12-12T20:20:40+00:00`
  */
 export function IsDateTime(value: string, strictTimeZone?: boolean): boolean {

src/format/date.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -30,11 +26,6 @@ THE SOFTWARE.
 
 import { FormatRegistry } from '../type/index'
 
-// --------------------------------------------------------------------------
-// This code ported form the ajv-format project for compatibility. All credit
-// goes to Evgeny Poberezkin and contributors.
-// --------------------------------------------------------------------------
-
 const Days = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
 const Date = /^(\d\d\d\d)-(\d\d)-(\d\d)$/
 
@@ -43,7 +34,10 @@ function IsLeapYear(year: number): boolean {
 }
 /**
  * Returns true of this string is a date
- * @documentation https://datatracker.ietf.org/doc/html/rfc3339#section-5.6
+ * @spec https://datatracker.ietf.org/doc/html/rfc3339#section-5.6
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `2020-12-12`
  */
 export function IsDate(value: string): boolean {

src/format/duration.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -30,16 +26,14 @@ THE SOFTWARE.
 
 import { FormatRegistry } from '../type/index'
 
-// ------------------------------------------------------------------
-// This expression is borrowed the ajv-format project for compatibility. 
-// All credit goes to Evgeny Poberezkin and contributors.
-// ------------------------------------------------------------------
-
 const Duration = /^P(?!$)((\d+Y)?(\d+M)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+S)?)?|(\d+W)?)$/
 
 /**
- * `[Ajv-Formats]` Returns true if this string is a duration
- * @documentation https://datatracker.ietf.org/doc/html/rfc3339#appendix-A
+ * Returns true if this string is a duration
+ * @spec https://datatracker.ietf.org/doc/html/rfc3339#appendix-A
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `P3D`
  */
 export function IsDuration(value: string): boolean {

src/format/email.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -30,16 +26,14 @@ THE SOFTWARE.
 
 import { FormatRegistry } from '../type/index'
 
-// ------------------------------------------------------------------
-// This expression is borrowed the ajv-format project for compatibility. 
-// All credit goes to Evgeny Poberezkin and contributors.
-// ------------------------------------------------------------------
-
 const Email = /^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i
 
 /**
  * Returns true if this string is an email address.
- * @documentation https://datatracker.ietf.org/doc/html/rfc5321#section-4.1.2
+ * @spec https://datatracker.ietf.org/doc/html/rfc5321#section-4.1.2
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `[email protected]`
  */
 export function IsEmail(value: string): boolean {

src/format/hostname.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -30,16 +26,14 @@ THE SOFTWARE.
 
 import { FormatRegistry } from '../type/index'
 
-// ------------------------------------------------------------------
-// This expression is borrowed the ajv-format project for compatibility. 
-// All credit goes to Evgeny Poberezkin and contributors.
-// ------------------------------------------------------------------
-
 const Hostname = /^(?=.{1,253}\.?$)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[-0-9a-z]{0,61}[0-9a-z])?)*\.?$/i
 
 /**
  * Returns true if this string is a hostname
- * @documentation https://datatracker.ietf.org/doc/html/rfc1123#section-2.1
+ * @spec https://datatracker.ietf.org/doc/html/rfc1123#section-2.1
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `domain.com`
  */
 export function IsHostname(value: string): boolean {

src/format/idn-email.ts

@@ -4,8 +4,6 @@
 
 The MIT License (MIT)
 
-Copyright (c) 2017-2024 Haydn Paterson (sinclair) <[email protected]>
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights

src/format/idn-hostname.ts

@@ -4,8 +4,6 @@
 
 The MIT License (MIT)
 
-Copyright (c) 2017-2024 Haydn Paterson (sinclair) <[email protected]>
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights

src/format/ipv4.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -30,20 +26,18 @@ THE SOFTWARE.
 
 import { FormatRegistry } from '../type/index'
 
-// ------------------------------------------------------------------
-// This expression is borrowed the ajv-format project for compatibility. 
-// All credit goes to Evgeny Poberezkin and contributors.
-// ------------------------------------------------------------------
-
-const pattern = /^(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)$/
+const IpV4 = /^(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)$/
 
 /**
  * Returns true if this string is a ipv4 format.
- * @documentation https://datatracker.ietf.org/doc/html/rfc2673#section-3.2
+ * @spec https://datatracker.ietf.org/doc/html/rfc2673#section-3.2
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `127.0.0.1`
  * ```
  */
 export function IsIpv4(value: string): boolean {
-  return pattern.test(value)
+  return IpV4.test(value)
 }
 FormatRegistry.Set('ipv4', IsIpv4)

src/format/ipv6.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -31,18 +27,22 @@ THE SOFTWARE.
 import { FormatRegistry } from '../type/index'
 
 // ------------------------------------------------------------------
-// This expression is borrowed the ajv-format project for compatibility. 
+// This expression is borrowed the ajv-format project for compatibility.
 // All credit goes to Evgeny Poberezkin and contributors.
 // ------------------------------------------------------------------
 
-const pattern = /^((([0-9a-f]{1,4}:){7}([0-9a-f]{1,4}|:))|(([0-9a-f]{1,4}:){6}(:[0-9a-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){5}(((:[0-9a-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){4}(((:[0-9a-f]{1,4}){1,3})|((:[0-9a-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){3}(((:[0-9a-f]{1,4}){1,4})|((:[0-9a-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){2}(((:[0-9a-f]{1,4}){1,5})|((:[0-9a-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){1}(((:[0-9a-f]{1,4}){1,6})|((:[0-9a-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9a-f]{1,4}){1,7})|((:[0-9a-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))$/i
+const Ipv6 =
+  /^((([0-9a-f]{1,4}:){7}([0-9a-f]{1,4}|:))|(([0-9a-f]{1,4}:){6}(:[0-9a-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){5}(((:[0-9a-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9a-f]{1,4}:){4}(((:[0-9a-f]{1,4}){1,3})|((:[0-9a-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){3}(((:[0-9a-f]{1,4}){1,4})|((:[0-9a-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){2}(((:[0-9a-f]{1,4}){1,5})|((:[0-9a-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9a-f]{1,4}:){1}(((:[0-9a-f]{1,4}){1,6})|((:[0-9a-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9a-f]{1,4}){1,7})|((:[0-9a-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))$/i
 
 /**
  * Returns true if this string is a Ipv6 format.
- * @documentation https://datatracker.ietf.org/doc/html/rfc2373#section-2.2
+ * @spec https://datatracker.ietf.org/doc/html/rfc2373#section-2.2
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `::1`
  */
 export function IsIpv6(value: string): boolean {
-  return pattern.test(value)
+  return Ipv6.test(value)
 }
 FormatRegistry.Set('ipv6', IsIpv6)

src/format/iri-reference.ts

@@ -4,8 +4,6 @@
 
 The MIT License (MIT)
 
-Copyright (c) 2017-2024 Haydn Paterson (sinclair) <[email protected]>
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights

src/format/iri.ts

@@ -4,8 +4,6 @@
 
 The MIT License (MIT)
 
-Copyright (c) 2017-2024 Haydn Paterson (sinclair) <[email protected]>
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights

src/format/json-pointer.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -30,16 +26,14 @@ THE SOFTWARE.
 
 import { FormatRegistry } from '../type/index'
 
-// ------------------------------------------------------------------
-// This expression is borrowed the ajv-format project for compatibility. 
-// All credit goes to Evgeny Poberezkin and contributors.
-// ------------------------------------------------------------------
-
 const JsonPointer = /^(?:\/(?:[^~/]|~0|~1)*)*$/
 
 /**
  * Returns true if this string is a json-pointer
- * @documentation https://datatracker.ietf.org/doc/html/rfc6901
+ * @spec https://datatracker.ietf.org/doc/html/rfc6901
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `/values/0/value`
  */
 export function IsJsonPointer(value: string): boolean {

src/format/regex.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights

src/format/time.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -39,7 +35,10 @@ const TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i
 
 /**
  * Returns true of this string is a iso time.
- * @documentation https://datatracker.ietf.org/doc/html/rfc3339#section-5.6
+ * @spec https://datatracker.ietf.org/doc/html/rfc3339#section-5.6
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `20:20:39+00:00`
  */
 export function IsTime(value: string, strictTimeZone?: boolean): boolean {

src/format/uri-reference.ts

@@ -4,10 +4,6 @@
 
 The MIT License (MIT)
 
-2020 Evgeny Poberezkin
-2024 Haydn Paterson (sinclair) <[email protected]>
-
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -31,15 +27,18 @@ THE SOFTWARE.
 import { FormatRegistry } from '../type/index'
 
 // ------------------------------------------------------------------
-// This expression is borrowed the ajv-format project for compatibility. 
+// This expression is borrowed the ajv-format project for compatibility.
 // All credit goes to Evgeny Poberezkin and contributors.
 // ------------------------------------------------------------------
 
 const URI_REFERENCE = /^(?:(?:[a-z][a-z0-9+\-.]*:)?\/?\/)?(?:[^\\\s#][^\s#]*)?(?:#[^\\\s]*)?$/i
 
 /**
  * Returns true if this string is a uri-reference
- * @documentation https://datatracker.ietf.org/doc/html/rfc3986#section-4.1
+ * @spec https://datatracker.ietf.org/doc/html/rfc3986#section-4.1
+ * @see https://github.com/ajv-validator/ajv-formats
+ * @author Evgeny Poberezkin and contributors
+ * @license MIT
  * @example `/path/to/resource`
  */
 export function IsUriReference(value: string): boolean {