@nxgt/typespec 0.9.1 → 0.10.0

package/lib/scalars/locale/locale.tsp

@@ -0,0 +1,20 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A well-formed BCP 47 language tag in canonical case, kept as sent, at most
+ * 255 characters: `fr`, `fr-FR`, `zh-Hant-TW`, `en-US-u-ca-buddhist`. The
+ * language is lowercase, a script Titlecase, a region uppercase, the rest
+ * lowercase. The order of extensions and of `-u-` keywords is not in the
+ * pattern, nor is the IANA registry.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc5646.
+ */
+@friendlyName("Locale")
+@format("locale")
+@pattern("^(?=.{1,255}$)[a-z]{2,3}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|\\d{3}))?(?:-(?:[a-z0-9]{5,8}|\\d[a-z0-9]{3}))*(?:-[0-9a-wyz](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?$")
+@extension("x-nxgt-scalar", "Locale")
+scalar locale extends string;

package/lib/scalars/locale.tsp

@@ -0,0 +1,3 @@
+// The locale scalars, one file each under ./locale/.
+import "./locale/country-code.tsp";
+import "./locale/locale.tsp";

package/lib/scalars/network/cidr-v4.tsp

@@ -0,0 +1,19 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An IPv4 block in CIDR notation: a dotted-quad address, `/` and a prefix
+ * length from 0 to 32, kept as sent: `10.0.0.0/8`. Each part of the address
+ * is 0 to 255 with no leading zero. The address need not be the first of the
+ * block.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc4632.
+ */
+@friendlyName("CIDRv4")
+@format("cidr-v4")
+@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)/(?:3[0-2]|[12]?\\d)$")
+@extension("x-nxgt-scalar", "CIDRv4")
+scalar cidrV4 extends string;

package/lib/scalars/network/cidr-v6.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An IPv6 block in CIDR notation: an IPv6 address, `/` and a prefix length
+ * from 0 to 128, kept as sent: `2001:db8::/32`. The address takes every RFC
+ * 4291 text form, in any case, with no zone, and is not normalised.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc4291.
+ */
+@friendlyName("CIDRv6")
+@format("cidr-v6")
+@pattern("^(?:(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?:(?::[0-9a-fA-F]{1,4}){1,7}|:)|(?:[0-9a-fA-F]{1,4}:){6}(?:(?: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)|::(?:[0-9a-fA-F]{1,4}:){0,5}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){1}:(?:[0-9a-fA-F]{1,4}:){0,4}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){2}:(?:[0-9a-fA-F]{1,4}:){0,3}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){3}:(?:[0-9a-fA-F]{1,4}:){0,2}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){4}:(?:[0-9a-fA-F]{1,4}:){0,1}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){5}:(?:[0-9a-fA-F]{1,4}:){0,0}(?:(?: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))/(?:12[0-8]|1[01]\\d|[1-9]?\\d)$")
+@extension("x-nxgt-scalar", "CIDRv6")
+scalar cidrV6 extends string;

package/lib/scalars/network/email-address.tsp

@@ -0,0 +1,20 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An e-mail address, in any case, kept as sent: `ada@example.com`. The local
+ * part is letters, digits, `_`, `'`, `+`, `-` and dots between them, with no
+ * quoted form; the domain is at least two labels, as `hostname` takes them,
+ * the last of letters or `xn--`. Only the shape is checked.
+ */
+@friendlyName("EmailAddress")
+@format("email")
+@pattern("^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+\\-]@(?=.{1,253}$)(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+(?:[A-Za-z]{2,63}|xn--[A-Za-z0-9-]{1,59})$")
+@extension("x-nxgt-scalar", "EmailAddress")
+scalar emailAddress extends string;
+
+/** `emailAddress`, under the name @nxgt/typespec gave it first. */
+alias email = emailAddress;

package/lib/scalars/network/hostname.tsp

@@ -0,0 +1,21 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A host name, kept as sent: `api.example.com`. Dot-separated labels of
+ * letters, digits and hyphens, none starting or ending with a hyphen, each
+ * up to 63 characters and 253 in all, with an optional trailing dot. The
+ * last label is not a number (all digits, or `0x` and hex digits), so an
+ * IPv4 address is not a host name. A single label (`localhost`) and punycode
+ * are; a Unicode label is not. Nothing is resolved.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc1123.
+ */
+@friendlyName("Hostname")
+@format("hostname")
+@pattern("^(?=.{1,253}\\.?$)(?!(?:[A-Za-z0-9-]+\\.)*(?:\\d+|0[xX][0-9a-fA-F]*)\\.?$)(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)*[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.?$")
+@extension("x-nxgt-scalar", "Hostname")
+scalar hostname extends string;

package/lib/scalars/network/http-url.tsp

@@ -0,0 +1,21 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An absolute `http:` or `https:` URL, kept as sent:
+ * `https://example.com/a?b=c`. The scheme is lowercase; the host is a
+ * `hostname`, a canonical IPv4 address or a bracketed IPv6 address, with no
+ * user info; a port is digits with no leading zero. No white space, control
+ * or invisible format character anywhere. Other schemes (`javascript:`,
+ * `data:`) are refused. Named `httpUrl`, as `url` is a TypeSpec built-in.
+ *
+ * Specified by https://url.spec.whatwg.org/.
+ */
+@friendlyName("URL")
+@format("uri")
+@pattern("^https?://(?:(?=[A-Za-z0-9.-]{1,253}(?:[:/?#]|$))(?!(?:[A-Za-z0-9-]+\\.)*(?:\\d+|0[xX][0-9a-fA-F]*)\\.?(?:[:/?#]|$))(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)*[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.?|(?:(?: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)|\\[(?:(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?:(?::[0-9a-fA-F]{1,4}){1,7}|:)|(?:[0-9a-fA-F]{1,4}:){6}(?:(?: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)|::(?:[0-9a-fA-F]{1,4}:){0,5}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){1}:(?:[0-9a-fA-F]{1,4}:){0,4}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){2}:(?:[0-9a-fA-F]{1,4}:){0,3}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){3}:(?:[0-9a-fA-F]{1,4}:){0,2}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){4}:(?:[0-9a-fA-F]{1,4}:){0,1}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){5}:(?:[0-9a-fA-F]{1,4}:){0,0}(?:(?: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))\\])(?::(?:6553[0-5]|655[0-2]\\d|65[0-4]\\d{2}|6[0-4]\\d{3}|[1-5]\\d{4}|[1-9]\\d{0,3}|0))?(?:[/?#][^\\s\\u0000-\\u001f\\u007f-\\u009f\\u00ad\\u0600-\\u0605\\u200b-\\u200f\\u202a-\\u202e\\u2060-\\u2064\\u2066-\\u206f\\ufeff]*)?$")
+@extension("x-nxgt-scalar", "URL")
+scalar httpUrl extends string;

package/lib/scalars/network/ip-v4.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An IPv4 address in dotted-quad form: `192.168.0.1`. Each part is 0 to 255
+ * with no leading zero.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc791.
+ */
+@friendlyName("IPv4")
+@format("ipv4")
+@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)$")
+@extension("x-nxgt-scalar", "IPv4")
+scalar ipV4 extends string;

package/lib/scalars/network/ip-v6.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An IPv6 address in any RFC 4291 text form, in any case, kept as sent and
+ * never normalised: `2001:db8::1`, `::1`, `::ffff:192.0.2.1`. No zone
+ * (`%eth0`).
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc4291.
+ */
+@friendlyName("IPv6")
+@format("ipv6")
+@pattern("^(?:(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?:(?::[0-9a-fA-F]{1,4}){1,7}|:)|(?:[0-9a-fA-F]{1,4}:){6}(?:(?: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)|::(?:[0-9a-fA-F]{1,4}:){0,5}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){1}:(?:[0-9a-fA-F]{1,4}:){0,4}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){2}:(?:[0-9a-fA-F]{1,4}:){0,3}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){3}:(?:[0-9a-fA-F]{1,4}:){0,2}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){4}:(?:[0-9a-fA-F]{1,4}:){0,1}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){5}:(?:[0-9a-fA-F]{1,4}:){0,0}(?:(?: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))$")
+@extension("x-nxgt-scalar", "IPv6")
+scalar ipV6 extends string;

package/lib/scalars/network/ip.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An IPv4 or an IPv6 address, as `ipV4` and `ipV6` take them, kept as sent:
+ * `192.168.0.1`, `2001:db8::1`.
+ *
+ * Specified by https://www.rfc-editor.org/rfc/rfc4291.
+ */
+@friendlyName("IP")
+@format("ip")
+@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)|(?:(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?:(?::[0-9a-fA-F]{1,4}){1,7}|:)|(?:[0-9a-fA-F]{1,4}:){6}(?:(?: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)|::(?:[0-9a-fA-F]{1,4}:){0,5}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){1}:(?:[0-9a-fA-F]{1,4}:){0,4}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){2}:(?:[0-9a-fA-F]{1,4}:){0,3}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){3}:(?:[0-9a-fA-F]{1,4}:){0,2}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){4}:(?:[0-9a-fA-F]{1,4}:){0,1}(?:(?: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)|(?:[0-9a-fA-F]{1,4}:){5}:(?:[0-9a-fA-F]{1,4}:){0,0}(?:(?: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)))$")
+@extension("x-nxgt-scalar", "IP")
+scalar ip extends string;

package/lib/scalars/network/mac.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A 48-bit MAC address: six hex pairs separated by `:`, in any case, kept as
+ * sent: `00:1a:2b:3c:4d:5e`. The IEEE hyphen form and the dotted form are
+ * refused.
+ */
+@friendlyName("MAC")
+@format("mac")
+@pattern("^(?:[0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$")
+@extension("x-nxgt-scalar", "MAC")
+scalar mac extends string;

package/lib/scalars/network/phone-number.tsp

@@ -0,0 +1,18 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A phone number in E.164 form: `+`, a country code that does not start with
+ * 0, and 7 to 15 digits in all, with no space or separator: `+33612345678`.
+ * Only the shape is checked.
+ *
+ * Specified by https://www.itu.int/rec/T-REC-E.164.
+ */
+@friendlyName("PhoneNumber")
+@format("phone-number")
+@pattern("^\\+[1-9]\\d{6,14}$")
+@extension("x-nxgt-scalar", "PhoneNumber")
+scalar phoneNumber extends string;

package/lib/scalars/network.tsp

@@ -0,0 +1,11 @@
+// The network scalars, one file each under ./network/.
+import "./network/cidr-v4.tsp";
+import "./network/cidr-v6.tsp";
+import "./network/email-address.tsp";
+import "./network/hostname.tsp";
+import "./network/http-url.tsp";
+import "./network/ip.tsp";
+import "./network/ip-v4.tsp";
+import "./network/ip-v6.tsp";
+import "./network/mac.tsp";
+import "./network/phone-number.tsp";

package/lib/scalars/number/big-int.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An integer of any size, written as a canonical decimal string: no leading
+ * zero, no `+`, no `-0`, no spaces: `"123456789012345678901234567890"`.
+ */
+@friendlyName("BigInt")
+@format("big-int")
+@pattern("^(?:0|-?[1-9]\\d*)$")
+@extension("x-nxgt-scalar", "BigInt")
+scalar bigInt extends string;

package/lib/scalars/number/long.tsp

@@ -0,0 +1,17 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A signed 64-bit integer, -9223372036854775808 to 9223372036854775807, written
+ * as a canonical decimal string, since JSON numbers lose precision past 2^53:
+ * `"9223372036854775807"`. No leading zero, no `+`, no `-0`; the range is in
+ * the pattern.
+ */
+@friendlyName("Long")
+@format("int64")
+@pattern("^(?:0|[1-9]\\d{0,17}|[1-8]\\d{18}|9[0-1]\\d{17}|92[0-1]\\d{16}|922[0-2]\\d{15}|9223[0-2]\\d{14}|92233[0-6]\\d{13}|922337[0-1]\\d{12}|92233720[0-2]\\d{10}|922337203[0-5]\\d{9}|9223372036[0-7]\\d{8}|92233720368[0-4]\\d{7}|922337203685[0-3]\\d{6}|9223372036854[0-6]\\d{5}|92233720368547[0-6]\\d{4}|922337203685477[0-4]\\d{3}|9223372036854775[0-7]\\d{2}|922337203685477580[0-7]|-[1-9]\\d{0,17}|-(?:[1-8]\\d{18}|9[0-1]\\d{17}|92[0-1]\\d{16}|922[0-2]\\d{15}|9223[0-2]\\d{14}|92233[0-6]\\d{13}|922337[0-1]\\d{12}|92233720[0-2]\\d{10}|922337203[0-5]\\d{9}|9223372036[0-7]\\d{8}|92233720368[0-4]\\d{7}|922337203685[0-3]\\d{6}|9223372036854[0-6]\\d{5}|92233720368547[0-6]\\d{4}|922337203685477[0-4]\\d{3}|9223372036854775[0-7]\\d{2}|922337203685477580[0-8]))$")
+@extension("x-nxgt-scalar", "Long")
+scalar long extends string;

package/lib/scalars/number/negative-float.tsp

@@ -0,0 +1,13 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A finite number below 0.
+ */
+@friendlyName("NegativeFloat")
+@maxValueExclusive(0)
+@extension("x-nxgt-scalar", "NegativeFloat")
+scalar negativeFloat extends float64;

package/lib/scalars/number/negative-int.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An integer, as GraphQL's `Int` writes it: no float, whole or not, and no
+ * `-0`, which JSON Schema cannot express. From -2147483648 to -1.
+ */
+@friendlyName("NegativeInt")
+@minValue(-2147483648)
+@maxValue(-1)
+@extension("x-nxgt-scalar", "NegativeInt")
+scalar negativeInt extends int32;

package/lib/scalars/number/non-negative-float.tsp

@@ -0,0 +1,13 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A finite number, 0 or above.
+ */
+@friendlyName("NonNegativeFloat")
+@minValue(0)
+@extension("x-nxgt-scalar", "NonNegativeFloat")
+scalar nonNegativeFloat extends float64;

package/lib/scalars/number/non-negative-int.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An integer, as GraphQL's `Int` writes it: no float, whole or not, and no
+ * `-0`, which JSON Schema cannot express. From 0 to 2147483647.
+ */
+@friendlyName("NonNegativeInt")
+@minValue(0)
+@maxValue(2147483647)
+@extension("x-nxgt-scalar", "NonNegativeInt")
+scalar nonNegativeInt extends int32;

package/lib/scalars/number/non-positive-float.tsp

@@ -0,0 +1,13 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A finite number, 0 or below.
+ */
+@friendlyName("NonPositiveFloat")
+@maxValue(0)
+@extension("x-nxgt-scalar", "NonPositiveFloat")
+scalar nonPositiveFloat extends float64;

package/lib/scalars/number/non-positive-int.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An integer, as GraphQL's `Int` writes it: no float, whole or not, and no
+ * `-0`, which JSON Schema cannot express. From -2147483648 to 0.
+ */
+@friendlyName("NonPositiveInt")
+@minValue(-2147483648)
+@maxValue(0)
+@extension("x-nxgt-scalar", "NonPositiveInt")
+scalar nonPositiveInt extends int32;

package/lib/scalars/number/port.tsp

@@ -0,0 +1,14 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A TCP or UDP port, an integer from 0 to 65535.
+ */
+@friendlyName("Port")
+@minValue(0)
+@maxValue(65535)
+@extension("x-nxgt-scalar", "Port")
+scalar port extends int32;

package/lib/scalars/number/positive-float.tsp

@@ -0,0 +1,13 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A finite number above 0.
+ */
+@friendlyName("PositiveFloat")
+@minValueExclusive(0)
+@extension("x-nxgt-scalar", "PositiveFloat")
+scalar positiveFloat extends float64;

package/lib/scalars/number/positive-int.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An integer, as GraphQL's `Int` writes it: no float, whole or not, and no
+ * `-0`, which JSON Schema cannot express. From 1 to 2147483647.
+ */
+@friendlyName("PositiveInt")
+@minValue(1)
+@maxValue(2147483647)
+@extension("x-nxgt-scalar", "PositiveInt")
+scalar positiveInt extends int32;

package/lib/scalars/number/safe-int.tsp

@@ -0,0 +1,16 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * An integer, as GraphQL's `Int` writes it: no float, whole or not, and no
+ * `-0`, which JSON Schema cannot express. From -9007199254740991 to
+ * 9007199254740991, the integers JavaScript holds exactly.
+ */
+@friendlyName("SafeInt")
+@minValue(-9007199254740991)
+@maxValue(9007199254740991)
+@extension("x-nxgt-scalar", "SafeInt")
+scalar safeInt extends safeint;

package/lib/scalars/number.tsp

@@ -0,0 +1,13 @@
+// The number scalars, one file each under ./number/.
+import "./number/big-int.tsp";
+import "./number/long.tsp";
+import "./number/negative-float.tsp";
+import "./number/negative-int.tsp";
+import "./number/non-negative-float.tsp";
+import "./number/non-negative-int.tsp";
+import "./number/non-positive-float.tsp";
+import "./number/non-positive-int.tsp";
+import "./number/port.tsp";
+import "./number/positive-float.tsp";
+import "./number/positive-int.tsp";
+import "./number/safe-int.tsp";

package/lib/scalars/string/emoji.tsp

@@ -0,0 +1,21 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * One emoji: `😀`, `👍🏽`, `👨‍👩‍👧`, `🇫🇷`, `1️⃣`. A pictograph with an optional variation
+ * selector or skin tone, joined to others by zero-width joiners; a
+ * pair of regional indicators (a flag); or a keycap. The pattern is an
+ * approximation by Unicode properties, so it needs the `u` flag; it does not
+ * segment user-perceived characters, takes no tag sequence (the flags of England,
+ * Scotland and Wales) and has no 32 code points limit.
+ *
+ * Specified by https://www.unicode.org/reports/tr51/.
+ */
+@friendlyName("Emoji")
+@format("emoji")
+@pattern("^(?:\\p{Regional_Indicator}{2}|[#*0-9]\\uFE0F?\\u20E3|\\p{Extended_Pictographic}(?:\\uFE0F|\\p{Emoji_Modifier})?(?:\\u200D\\p{Extended_Pictographic}(?:\\uFE0F|\\p{Emoji_Modifier})?)*)$")
+@extension("x-nxgt-scalar", "Emoji")
+scalar emoji extends string;

package/lib/scalars/string/non-empty-string.tsp

@@ -0,0 +1,15 @@
+import "@typespec/openapi";
+
+using TypeSpec.OpenAPI;
+
+namespace Nxgt;
+
+/**
+ * A string with at least one non-white-space character, kept as sent, not
+ * trimmed. "White space" is ECMAScript's `\s`.
+ */
+@friendlyName("NonEmptyString")
+@format("non-empty-string")
+@pattern("^\\s*\\S[\\s\\S]*$")
+@extension("x-nxgt-scalar", "NonEmptyString")
+scalar nonEmptyString extends string;

package/lib/scalars/string.tsp

@@ -0,0 +1,3 @@
+// The string scalars, one file each under ./string/.
+import "./string/emoji.tsp";
+import "./string/non-empty-string.tsp";

package/lib/scalars/value.tsp

@@ -0,0 +1,2 @@
+// The value scalars: none is declared, TypeSpec writes `unknown`,
+// `Record<unknown>` and `void` (test/scalars/value.ts).

package/lib/scalars.tsp

@@ -1,12 +1,13 @@
-namespace Nxgt;
-
-// The id @nxgt/drizzle's id() and actors() columns hold by default.
-/** A UUID, such as `0b8e5c1e-2f4a-4c3b-9d6e-7f8a9b0c1d2e`. */
-@friendlyName("Uuid")
-@format("uuid")
-scalar uuid extends string;
-
-/** An e-mail address. */
-@friendlyName("Email")
-@format("email")
-scalar email extends string;
+// The scalars of @nxgt/graphql-scalars, one file per scalar under
+// scalars/<category>/, each category imported by its own index.
+import "./scalars/color.tsp";
+import "./scalars/date-time.tsp";
+import "./scalars/encoding.tsp";
+import "./scalars/finance.tsp";
+import "./scalars/geo.tsp";
+import "./scalars/identifier.tsp";
+import "./scalars/locale.tsp";
+import "./scalars/network.tsp";
+import "./scalars/number.tsp";
+import "./scalars/string.tsp";
+import "./scalars/value.tsp";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nxgt/typespec",
-	"version": "0.9.1",
+	"version": "0.10.0",
 	"license": "MIT",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -49,11 +49,11 @@
 		"@typespec/compiler": "^1.16.0",
 		"@typespec/http": "^1.16.0",
 		"@typespec/openapi": "^1.16.0",
-		"typescript": "^6.0.3"
+		"typescript": "^6.0.3 || ^7.0.0"
 	},
 	"devDependencies": {
-		"@nxgt/openapi-codegen": "^0.5.1",
-		"@nxgt/openapi-hono": "^0.3.0",
+		"@nxgt/openapi-codegen": "^0.8.0",
+		"@nxgt/openapi-hono": "^0.3.2",
 		"@types/bun": "^1.4.0",
 		"@typespec/compiler": "1.16.0",
 		"@typespec/http": "1.16.0",