@nxgt/typespec 0.9.1 → 0.10.0

package/lib/scalars/color/rgba.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A CSS `rgba()` color in the comma syntax: `rgba(255, 0, 0, 0.5)`. As `rgb`
+ * plus an alpha: `0`, `1`, or a fraction with no trailing zero and a leading
+ * `0`.
+ *
+ * Specified by https://www.w3.org/TR/css-color-4/#rgb-functions.
+ */
+@friendlyName("RGBA")
+@format("rgba")
+@pattern("^rgba\\((?: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), (?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d), (?:0|1|0\\.\\d*[1-9])\\)$")
+@extension("x-nxgt-scalar", "RGBA")
+scalar rgba extends string;

package/lib/scalars/color.tsp

@@ -0,0 +1,6 @@
+// The color scalars, one file each under ./color/.
+import "./color/hex-color-code.tsp";
+import "./color/hsl.tsp";
+import "./color/hsla.tsp";
+import "./color/rgb.tsp";
+import "./color/rgba.tsp";

package/lib/scalars/date-time/date-time.tsp

@@ -0,0 +1,19 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An RFC 3339 date-time with its offset, `Z` or `±hh:mm`, kept as sent: `2024-03-10T12:00:00+02:00`.
+ * A time with no offset names no instant and is refused, and so is the offset `-00:00`:
+ * write `Z` or `+00:00`. An impossible day is refused. The range 0000 to 9999 in UTC is
+ * not in the pattern, nor is the leap second.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc3339.
+ */
+@friendlyName("DateTime")
+@format("date-time")
+@pattern("^(?:\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|02-(?:0[1-9]|1\\d|2[0-8]))|(?:\\d\\d(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00)-02-29)T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)(?:Z|\\+(?:[01]\\d|2[0-3]):[0-5]\\d|-(?!00:00)(?:[01]\\d|2[0-3]):[0-5]\\d)$")
+@extension("x-nxgt-scalar", "DateTime")
+scalar dateTime extends string;

package/lib/scalars/date-time/date.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A calendar date, `YYYY-MM-DD`, with no time and no time zone: `2024-02-29`. An impossible
+ * day, such as `2023-02-29`, is refused.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc3339#section-5.6.
+ */
+@friendlyName("Date")
+@format("date")
+@pattern("^(?:\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|02-(?:0[1-9]|1\\d|2[0-8]))|(?:\\d\\d(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00)-02-29)$")
+@extension("x-nxgt-scalar", "Date")
+scalar date extends string;

package/lib/scalars/date-time/iso-duration.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An ISO 8601 duration, kept as sent and not normalised: `P1DT2H`. Weeks are not mixed with
+ * other units, and there is no sign. Named `isoDuration` because `duration` is TypeSpec's own.
+ *
+ * Specified by https://www.iso.org/iso-8601-date-and-time-format.html.
+ */
+@friendlyName("Duration")
+@format("duration")
+@pattern("^P(?:\\d+W|(?!.*W)(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?=\\d)(?:\\d+H)?(?:\\d+M)?(?:\\d+(?:[.,]\\d+)?S)?)?)$")
+@extension("x-nxgt-scalar", "Duration")
+scalar isoDuration extends string;

package/lib/scalars/date-time/local-date-time.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A date and a time on the wall clock, with no offset, not even `Z`: `2024-03-10T10:15:30`.
+ * The seconds are optional. An impossible day is refused.
+ */
+@friendlyName("LocalDateTime")
+@format("local-date-time")
+@pattern("^(?:\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|02-(?:0[1-9]|1\\d|2[0-8]))|(?:\\d\\d(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00)-02-29)T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?$")
+@extension("x-nxgt-scalar", "LocalDateTime")
+scalar localDateTime extends string;

package/lib/scalars/date-time/local-time.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A time of day with no offset, `HH:MM`, `HH:MM:SS` or with a fraction: `10:15`. It names no
+ * instant until a date and a place are given; a `Z` or an offset is refused.
+ */
+@friendlyName("LocalTime")
+@format("local-time")
+@pattern("^(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?$")
+@extension("x-nxgt-scalar", "LocalTime")
+scalar localTime extends string;

package/lib/scalars/date-time/time-zone.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An IANA time zone name in its exact case, kept as sent: `Europe/Paris`, `UTC`. Only the shape
+ * is checked, one to three words of letters, digits, `+`, `-` and `_`, each starting with a capital;
+ * the list of names is not in the pattern.
+ *
+ * Specified by https://www.iana.org/time-zones.
+ */
+@friendlyName("TimeZone")
+@format("time-zone")
+@pattern("^[A-Z][A-Za-z0-9+\\-_]*(?:/[A-Z][A-Za-z0-9+\\-_]*){0,2}$")
+@extension("x-nxgt-scalar", "TimeZone")
+scalar timeZone extends string;

package/lib/scalars/date-time/time.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An RFC 3339 `full-time`, kept as sent: seconds, an optional fraction, then `Z` or `±hh:mm`,
+ * such as `10:15:30+02:00`. A time with no offset is refused, and so is `-00:00`.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc3339#section-5.6.
+ */
+@friendlyName("Time")
+@format("time")
+@pattern("^(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d)(?:\\.\\d+)?(?:Z|\\+(?:[01]\\d|2[0-3]):[0-5]\\d|-(?!00:00)(?:[01]\\d|2[0-3]):[0-5]\\d)$")
+@extension("x-nxgt-scalar", "Time")
+scalar time extends string;

package/lib/scalars/date-time/timestamp.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An instant as an integer number of milliseconds since 1970-01-01T00:00:00Z, negative before
+ * 1970, within the range of a JavaScript `Date`, ±8640000000000000: `1710065730000`.
+ */
+@friendlyName("Timestamp")
+@minValue(-8640000000000000)
+@maxValue(8640000000000000)
+@extension("x-nxgt-scalar", "Timestamp")
+scalar timestamp extends safeint;

package/lib/scalars/date-time/utc-offset.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A fixed offset from UTC, `±hh:mm`, from `-12:00` to `+14:00`: `+05:30`. It is not a place and
+ * knows nothing of daylight saving. `-00:00` is refused: write `+00:00`.
+ */
+@friendlyName("UtcOffset")
+@format("utc-offset")
+@pattern("^(?:\\+(?:0\\d|1[0-3]):[0-5]\\d|\\+14:00|-(?!00:00)(?:0\\d|1[01]):[0-5]\\d|-12:00)$")
+@extension("x-nxgt-scalar", "UtcOffset")
+scalar utcOffset extends string;

package/lib/scalars/date-time.tsp

@@ -0,0 +1,10 @@
+// The date-time scalars, one file each under ./date-time/.
+import "./date-time/date.tsp";
+import "./date-time/date-time.tsp";
+import "./date-time/iso-duration.tsp";
+import "./date-time/local-date-time.tsp";
+import "./date-time/local-time.tsp";
+import "./date-time/time.tsp";
+import "./date-time/time-zone.tsp";
+import "./date-time/timestamp.tsp";
+import "./date-time/utc-offset.tsp";

package/lib/scalars/encoding/base64-url.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * URL-safe base64 (RFC 4648, section 5): `-` and `_`, no padding, in its one
+ * canonical spelling. The empty string is the encoding of no bytes.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc4648#section-5.
+ */
+@friendlyName("Base64URL")
+@format("base64-url")
+@pattern("^(?:[A-Za-z0-9_-]{4})*(?:[A-Za-z0-9_-][AQgw]|[A-Za-z0-9_-]{2}[AEIMQUYcgkosw048])?$")
+@extension("x-nxgt-scalar", "Base64URL")
+scalar base64Url extends string;

package/lib/scalars/encoding/base64.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * Standard base64 (RFC 4648, section 4) with its padding, in its one canonical
+ * spelling: `YR==` decodes to the same byte as `YQ==` and is not taken. The
+ * empty string is the encoding of no bytes.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc4648#section-4.
+ */
+@friendlyName("Base64")
+@format("byte")
+@pattern("^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/][AQgw]==|[A-Za-z0-9+/]{2}[AEIMQUYcgkosw048]=)?$")
+@extension("x-nxgt-scalar", "Base64")
+scalar base64 extends string;

package/lib/scalars/encoding/hexadecimal.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * One or more hexadecimal digits, in any case, kept as sent. An odd length is
+ * fine; no `0x` prefix.
+ */
+@friendlyName("Hexadecimal")
+@format("hexadecimal")
+@pattern("^[0-9a-fA-F]+$")
+@extension("x-nxgt-scalar", "Hexadecimal")
+scalar hexadecimal extends string;

package/lib/scalars/encoding/jwt.tsp

@@ -0,0 +1,19 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A signed JSON Web Token in compact form: three base64url parts joined by `.`.
+ * Only the shape is in the pattern: that each part is in its one canonical
+ * spelling, that the header and the payload are JSON objects and that the
+ * header's `alg` is not `none` are left out, and the signature is not verified.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc7519.
+ */
+@friendlyName("JWT")
+@format("jwt")
+@pattern("^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$")
+@extension("x-nxgt-scalar", "JWT")
+scalar jwt extends string;

package/lib/scalars/encoding/sha256.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A SHA-256 digest: 64 hexadecimal digits, in any case, kept as sent.
+ *
+ * Specified by https://csrc.nist.gov/pubs/fips/180-4/upd1/final.
+ */
+@friendlyName("SHA256")
+@format("sha256")
+@pattern("^[0-9a-fA-F]{64}$")
+@extension("x-nxgt-scalar", "SHA256")
+scalar sha256 extends string;

package/lib/scalars/encoding/sha512.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A SHA-512 digest: 128 hexadecimal digits, in any case, kept as sent.
+ *
+ * Specified by https://csrc.nist.gov/pubs/fips/180-4/upd1/final.
+ */
+@friendlyName("SHA512")
+@format("sha512")
+@pattern("^[0-9a-fA-F]{128}$")
+@extension("x-nxgt-scalar", "SHA512")
+scalar sha512 extends string;

package/lib/scalars/encoding.tsp

@@ -0,0 +1,7 @@
+// The encoding scalars, one file each under ./encoding/.
+import "./encoding/base64.tsp";
+import "./encoding/base64-url.tsp";
+import "./encoding/hexadecimal.tsp";
+import "./encoding/jwt.tsp";
+import "./encoding/sha256.tsp";
+import "./encoding/sha512.tsp";

package/lib/scalars/finance/currency.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An ISO 4217 currency code, uppercase: `EUR`, `USD`. The list of codes in
+ * force is not in the pattern: only the shape is.
+ *
+ * Specified by https://www.iso.org/iso-4217-currency-codes.html.
+ */
+@friendlyName("Currency")
+@format("currency")
+@pattern("^[A-Z]{3}$")
+@extension("x-nxgt-scalar", "Currency")
+scalar currency extends string;

package/lib/scalars/finance/iban.tsp

@@ -0,0 +1,19 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An International Bank Account Number in its electronic form, uppercase, no
+ * spaces: `FR1420041010050500013M02606`. Two letters, two check digits, then
+ * 11 to 30 letters or digits. The checksum (ISO 13616, mod 97) and the
+ * country and its length are not in the pattern.
+ *
+ * Specified by https://www.iso.org/standard/81090.html.
+ */
+@friendlyName("IBAN")
+@format("iban")
+@pattern("^[A-Z]{2}\\d{2}[A-Z0-9]{11,30}$")
+@extension("x-nxgt-scalar", "IBAN")
+scalar iban extends string;

package/lib/scalars/finance.tsp

@@ -0,0 +1,3 @@
+// The finance scalars, one file each under ./finance/.
+import "./finance/currency.tsp";
+import "./finance/iban.tsp";

package/lib/scalars/geo/latitude.tsp

@@ -0,0 +1,14 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A latitude in decimal degrees, WGS 84, from -90 to 90: `48.8566`. A number, never a string.
+ */
+@friendlyName("Latitude")
+@minValue(-90)
+@maxValue(90)
+@extension("x-nxgt-scalar", "Latitude")
+scalar latitude extends float64;

package/lib/scalars/geo/longitude.tsp

@@ -0,0 +1,14 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A longitude in decimal degrees, WGS 84, from -180 to 180: `2.3522`. A number, never a string.
+ */
+@friendlyName("Longitude")
+@minValue(-180)
+@maxValue(180)
+@extension("x-nxgt-scalar", "Longitude")
+scalar longitude extends float64;

package/lib/scalars/geo.tsp

@@ -0,0 +1,3 @@
+// The geo scalars, one file each under ./geo/.
+import "./geo/latitude.tsp";
+import "./geo/longitude.tsp";

package/lib/scalars/identifier/cuid2.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A Cuid2: a lower-case letter, then lower-case letters and digits, 2 to 32
+ * characters in all (24 by default).
+ *
+ * Specified by https://github.com/paralleldrive/cuid2.
+ */
+@friendlyName("Cuid2")
+@format("cuid2")
+@pattern("^[a-z][a-z0-9]{1,31}$")
+@extension("x-nxgt-scalar", "Cuid2")
+scalar cuid2 extends string;

package/lib/scalars/identifier/guid.tsp

@@ -0,0 +1,12 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/** Any 8-4-4-4-12 hexadecimal string, no version or variant check, in any case, kept as sent. */
+@friendlyName("GUID")
+@format("uuid")
+@pattern("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$")
+@extension("x-nxgt-scalar", "GUID")
+scalar guid extends string;

package/lib/scalars/identifier/isbn.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An ISBN-10 or an ISBN-13, digits only (no hyphen or space). An ISBN-10 may end
+ * in an uppercase `X`; an ISBN-13 starts with 978, or 979 followed by 1 to 9
+ * (979-0 is the ISMN). The check digit is not in the pattern.
+ *
+ * Specified by https://www.isbn-international.org/content/isbn-users-manual/29.
+ */
+@friendlyName("ISBN")
+@format("isbn")
+@pattern("^(?:\\d{9}[\\dX]|(?:978\\d|979[1-9])\\d{9})$")
+@extension("x-nxgt-scalar", "ISBN")
+scalar isbn extends string;

package/lib/scalars/identifier/ksuid.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A KSUID: 27 characters of base62, at most `aWgEPTl1tmebfsQzFP4bxwgy80V` (160
+ * bits). The alphabet is in ASCII order and the length fixed, so the pattern
+ * bounds the value digit by digit.
+ *
+ * Specified by https://github.com/segmentio/ksuid.
+ */
+@friendlyName("KSUID")
+@format("ksuid")
+@pattern("^(?:[0-9A-Z][0-9A-Za-z]{26}|a[0-9A-V][0-9A-Za-z]{25}|aW[0-9A-Za-f][0-9A-Za-z]{24}|aWg[0-9A-D][0-9A-Za-z]{23}|aWgE[0-9A-O][0-9A-Za-z]{22}|aWgEP[0-9A-S][0-9A-Za-z]{21}|aWgEPT[0-9A-Za-k][0-9A-Za-z]{20}|aWgEPTl[0][0-9A-Za-z]{19}|aWgEPTl1[0-9A-Za-s][0-9A-Za-z]{18}|aWgEPTl1t[0-9A-Za-l][0-9A-Za-z]{17}|aWgEPTl1tm[0-9A-Za-d][0-9A-Za-z]{16}|aWgEPTl1tme[0-9A-Za][0-9A-Za-z]{15}|aWgEPTl1tmeb[0-9A-Za-e][0-9A-Za-z]{14}|aWgEPTl1tmebf[0-9A-Za-r][0-9A-Za-z]{13}|aWgEPTl1tmebfs[0-9A-P][0-9A-Za-z]{12}|aWgEPTl1tmebfsQ[0-9A-Za-y][0-9A-Za-z]{11}|aWgEPTl1tmebfsQz[0-9A-E][0-9A-Za-z]{10}|aWgEPTl1tmebfsQzF[0-9A-O][0-9A-Za-z]{9}|aWgEPTl1tmebfsQzFP[0-3][0-9A-Za-z]{8}|aWgEPTl1tmebfsQzFP4[0-9A-Za][0-9A-Za-z]{7}|aWgEPTl1tmebfsQzFP4b[0-9A-Za-w][0-9A-Za-z]{6}|aWgEPTl1tmebfsQzFP4bx[0-9A-Za-v][0-9A-Za-z]{5}|aWgEPTl1tmebfsQzFP4bxw[0-9A-Za-f][0-9A-Za-z]{4}|aWgEPTl1tmebfsQzFP4bxwg[0-9A-Za-x][0-9A-Za-z]{3}|aWgEPTl1tmebfsQzFP4bxwgy[0-7][0-9A-Za-z]{2}|aWgEPTl1tmebfsQzFP4bxwgy80[0-9A-U]|aWgEPTl1tmebfsQzFP4bxwgy80V)$")
+@extension("x-nxgt-scalar", "KSUID")
+scalar ksuid extends string;

package/lib/scalars/identifier/nano-id.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A Nano ID of the default shape: 21 characters of `A-Za-z0-9_-`.
+ *
+ * Specified by https://github.com/ai/nanoid.
+ */
+@friendlyName("NanoID")
+@format("nano-id")
+@pattern("^[A-Za-z0-9_-]{21}$")
+@extension("x-nxgt-scalar", "NanoID")
+scalar nanoId extends string;

package/lib/scalars/identifier/object-id.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A MongoDB ObjectId as text: 24 hexadecimal digits, in any case, kept as sent.
+ *
+ * Specified by https://www.mongodb.com/docs/manual/reference/method/ObjectId/.
+ */
+@friendlyName("ObjectID")
+@format("object-id")
+@pattern("^[0-9a-fA-F]{24}$")
+@extension("x-nxgt-scalar", "ObjectID")
+scalar objectId extends string;

package/lib/scalars/identifier/sem-ver.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A Semantic Versioning 2.0.0 version, as semver.org's own regular expression
+ * reads it: `1.2.3`, `1.0.0-rc.1+build.5`. No `v` prefix.
+ *
+ * Specified by https://semver.org/spec/v2.0.0.html.
+ */
+@friendlyName("SemVer")
+@format("sem-ver")
+@pattern("^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-(?:(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+[0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*)?$")
+@extension("x-nxgt-scalar", "SemVer")
+scalar semVer extends string;

package/lib/scalars/identifier/ulid.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A ULID: 26 characters of Crockford base32, the first 0 to 7 (128 bits), in any
+ * case, kept as sent.
+ *
+ * Specified by https://github.com/ulid/spec.
+ */
+@friendlyName("ULID")
+@format("ulid")
+@pattern("^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$")
+@extension("x-nxgt-scalar", "ULID")
+scalar ulid extends string;

package/lib/scalars/identifier/uuid-v4.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A version 4 (random) UUID with the RFC variant, in any case, kept as sent.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc9562.
+ */
+@friendlyName("UUIDv4")
+@format("uuid")
+@pattern("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$")
+@extension("x-nxgt-scalar", "UUIDv4")
+scalar uuidV4 extends string;

package/lib/scalars/identifier/uuid-v7.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A version 7 (time-ordered) UUID with the RFC variant, in any case, kept as sent.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc9562.
+ */
+@friendlyName("UUIDv7")
+@format("uuid")
+@pattern("^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$")
+@extension("x-nxgt-scalar", "UUIDv7")
+scalar uuidV7 extends string;

package/lib/scalars/identifier/uuid.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+// The id @nxgt/drizzle's id() and actors() columns hold by default.
+/**
+ * An RFC 9562 UUID, any version 1 to 8 with the RFC variant, or the nil or
+ * the max UUID, in any case, kept as sent: `0b8e5c1e-2f4a-4c3b-9d6e-7f8a9b0c1d2e`.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc9562.
+ */
+@friendlyName("UUID")
+@format("uuid")
+@pattern("^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|0{8}-0{4}-0{4}-0{4}-0{12}|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$")
+@extension("x-nxgt-scalar", "UUID")
+scalar uuid extends string;

package/lib/scalars/identifier/xid.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An XID: 20 characters of lowercase base32hex (`0-9`, `a-v`). 12 bytes leave 4
+ * bits unused, so the last character is `0` or `g`.
+ *
+ * Specified by https://github.com/rs/xid.
+ */
+@friendlyName("XID")
+@format("xid")
+@pattern("^[0-9a-v]{19}[0g]$")
+@extension("x-nxgt-scalar", "XID")
+scalar xid extends string;

package/lib/scalars/identifier.tsp

@@ -0,0 +1,13 @@
+// The identifier scalars, one file each under ./identifier/.
+import "./identifier/cuid2.tsp";
+import "./identifier/guid.tsp";
+import "./identifier/isbn.tsp";
+import "./identifier/ksuid.tsp";
+import "./identifier/nano-id.tsp";
+import "./identifier/object-id.tsp";
+import "./identifier/sem-ver.tsp";
+import "./identifier/ulid.tsp";
+import "./identifier/uuid.tsp";
+import "./identifier/uuid-v4.tsp";
+import "./identifier/uuid-v7.tsp";
+import "./identifier/xid.tsp";

package/lib/scalars/locale/country-code.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An ISO 3166-1 alpha-2 country code, uppercase: `FR`, `US`. The list of
+ * assigned codes is not in the pattern: only the shape is.
+ *
+ * Specified by https://www.iso.org/iso-3166-country-codes.html.
+ */
+@friendlyName("CountryCode")
+@format("country-code")
+@pattern("^[A-Z]{2}$")
+@extension("x-nxgt-scalar", "CountryCode")
+scalar countryCode extends string;