Jadpo is experimental and not ready for production. These docs follow the compiler's main branch as of 5 Nov 2026. What's built · Install 0.3.0
jadpo
ReferenceStandard types

LanguageValues and types

Standard types

Every standard type Jadpo has, 259 of them, from A to Z. jadpo help <Type> prints the same page in your terminal. For why a type you want may not be on the list, see How standard types are named, and what is left out.

By group

About standard types

How standard types are named, and what is left out

A standard type's name says exactly what it is, and a type you might look for may be part of another or left for your app to define.

What every standard type can do

Every standard type comes with the same baseline of operations, so once you know how one type is built, read, sent, stored and shown, you know them all.

How a standard value is sent, stored and shown

A standard value keeps its currency, unit and precision wherever it goes into or out of your program.

Packages use the standard types

When you declare a type with the same shape as a standard type, the compiler reports the error type.standard_exists and points you at the standard type.

Changing a standard type's encoding

Upgrading Jadpo never makes your stored data unreadable.

A release that adds a standard type

When a Jadpo upgrade adds a standard type with a name your app already uses for a type of its own, your app never breaks silently.

A to Z

ABCDEFGHIJLMNOPQRSTUVWYZ

TypeWhat it isGroup
A
AbaRoutingNumberA US bank's routing number: nine digits with a check digit.Money and banking
AllergenOne of the 14 allergens a UK or EU food label must name: milk, celery and so on.Health
AltTextWhat an image shows, for someone who can't see it.Media and visual
AngleAn angle: 90deg or 1.5rad.Physical quantities
ApiKeyA key for an API: up to 512 characters with no spaces.Security
AreaAn area: 12sqm or 2ha.Physical quantities
AspectRatioWidth to height in whole numbers: 16:9.Media and visual
AudioCodecAn audio format as browsers name it: mp4a.40.2, opus.Media and visual
B
BankAccountA bank account to pay into or take from, in any country.Money and banking
BarcodeWhat a barcode encodes, and which kind of barcode it is.Commerce and logistics
BasisPointsA count of hundredths of a percent: 25 basis points is 0.25%.Money and banking
BearerTokenAn access token sent as Authorization: Bearer.Security
BearingA compass direction: degrees clockwise from true north, from 0 to 360.Geospatial
BicA bank's identifier code, also called a SWIFT code: 8 or 11 characters.Money and banking
BitrateData per second: 100Mbps.Maths and data
BloodGlucoseA blood sugar level, shown 5.5 mmol/L.Health
BloodPressureA blood pressure reading: 120/80 mmHg.Health
BloodTypeA person's blood group: O-, AB+ and so on.Health
BookingReferenceA booking's six-character reference: X7K9QZ.Travel
BoundingBoxA rectangle on a map, given by its four sides.Geospatial
C
CabinClassThe cabin a seat is sold in: economy, premium_economy, business or first.Travel
CalendarDateA day on the calendar, with no time or zone: 2026-10-25.Time and calendar
CalendarEventA calendar event, as a calendar app reads one: a title, and its days or its times.Time and calendar
CalendarPeriodAn amount of calendar time in years, months and days: P1Y2M10D.Time and calendar
CallingCodeA country's telephone code with its +: +44.Places
CardBinThe first 6 or 8 digits of a card number, which name its issuer.Money and banking
CardBrandA card scheme: visa, mastercard, american_express and so on.Money and banking
CardExpiryThe month a payment card runs to, written 2028-12.Money and banking
CarrierA shipping company by its two-to-four-letter code: UPSN, MAEU.Commerce and logistics
CefrLevelA language ability level, from A1 to C2.Other with a published standard
CertificateAn X.509 certificate, the kind that secures a website.Security
ChatMessageOne message in a conversation with an AI model: who wrote it and what it says.AI
ChatRoleWho wrote a message in a conversation with a model: system, user, assistant or tool.AI
CidrA range of IP addresses: 192.0.2.0/24.Web and network
CircleA centre and a distance around it.Geospatial
ClothingSizeA clothing size in its system, as the label writes it: UK 10, US M.Commerce and logistics
ClothingSizeSystemWhich system a clothing size is in: UK, EU or US.Commerce and logistics
ColourA colour, written #1e6fd9, or #1e6fd980 when it isn't fully opaque.Media and visual
ConcentrationA mass in a volume: 5mgL or 1gL.Physical quantities
ContainerImageA container image's whole name: docker.io/library/nginx:1.27.Software
ContainerNumberA shipping container's number, checked by its check digit: CSQU3054383.Commerce and logistics
ContentRatingAn age rating and the body that gave it: BBFC 12A.Media and visual
ContentRatingSchemeA body that rates films or games for age: BBFC, MPA, PEGI or ESRB.Media and visual
ContinentA continent, as the United Nations groups the world: europe, asia.Places
CookieA cookie as a server sets it: SID=31d4d96e; Path=/; Secure; HttpOnly.Web and network
CountryA country, written as its two-letter code: GB.Places
CountrySubdivisionA state, province or other part of a country, written as its code: GB-ENG, US-CA.Places
CrsA coordinate reference system, by its EPSG code: EPSG:27700.Geospatial
CurrencyA currency, by its three-letter code: GBP.Money and banking
CurrentAn electric current: 500mA.Physical quantities
CveA security vulnerability's id: CVE-2021-44228.Software
D
DataSizeAn amount of data: 5MB or 4KiB.Maths and data
DateRangeThe days from one date to another, both included: 2026-10-01/2026-10-31.Time and calendar
DigestA content digest, with its algorithm: sha256: and 64 hexadecimal digits.Software
DimensionsA box's length, width and height.Commerce and logistics
DiscountAn amount off a price, or a percentage off it.Money and banking
DoiA digital object identifier, naming a paper or a dataset: 10.1038/nphys1170.Software
DomainNameA domain name: example.com.Web and network
DosageInstructionHow to take a medicine: a dose, a route and how often.Health
DoseAn amount of a medicine: 500 mg or 5 ml.Health
DrivingLicenceNumberA driving licence's number, with the country that issued it.Tax and identity numbers
DurationAn exact length of time, to the millisecond: 90 minutes is PT1H30M.Time and calendar
E
Ean13The 13-digit barcode number on most products outside North America.Commerce and logistics
EastingNorthingMap coordinates on a projected grid: an easting, a northing and which grid.Geospatial
EmailAn email address, checked as one.People and contact
EmailWithNameAn email address with the name shown beside it: Mary Somerville <mary@example.com>.People and contact
EmbeddingA list of numbers with the AI model that made it.Maths and data
EmojiOne emoji: 😀, 👍🏽.Web and network
EncryptedValueA value sealed by crypto.encrypt.Security
EnergyAn amount of energy: 2kWh or 250kcal.Physical quantities
EpcRatingA UK energy certificate's band: A to G.Other with a published standard
ExchangeRateA rate between two currencies at a moment in time.Money and banking
ExifOrientationHow a stored photo must be turned to look upright, as a camera records it.Media and visual
F
FamilyNameA person's family name, one line as they write it.People and contact
FeatureA shape with your own data attached, in GeoJSON's form, as a map library takes one.Geospatial
FeatureCollectionA list of features, all with the same shape and properties types, as a map layer.Geospatial
FileNameA file's name that every common file system takes: report.pdf.Software
FilePathA portable file path: /var/lib/acme/uploads, reports/2026/october.csv.Software
FileTypeA file's media type: image/png, application/pdf and so on.Web and network
FlightNumberA flight's code: BA123.Travel
FractionAn exact fraction as written: 3/4.Maths and data
FrameRateFrames a second, as an exact fraction: 25/1, or 30000/1001 for 29.97.Media and visual
FrequencyHow often something happens per second: 50Hz or 2.4GHz.Physical quantities
G
GeohashA rectangle on Earth, as up to 12 letters and digits: gcpvj0duq.Geospatial
GeometryAny one of the six shapes: a point, a path, an area or a set of any of those.Geospatial
GitRefA git branch, tag, full ref or commit hash: main, refs/tags/v1.2.0.Software
GivenNameThe name a person goes by, one line as they write it.People and contact
H
H3CellA cell of Uber's H3 grid of hexagons, as 15 hexadecimal digits: 8928308280fffff.Geospatial
HashA SHA-256 digest: the 32 bytes hash.sha256 gives.Security
HeartRateA heart rate: 72bpm.Health
HmacAn HMAC-SHA-256 tag, such as a webhook's signature.Security
HostnameA host: a domain name or an IP address.Web and network
HsCodeA customs code for a kind of goods: six to ten digits, such as 090111 for coffee.Commerce and logistics
HtmlHTML that's always safe to put in a page or an email.Text formats
HttpHeaderNameAn HTTP header's name, in lower case: content-type.Web and network
HttpMethodAn HTTP method a route is written with: GET, POST, PUT, PATCH or DELETE.Web and network
HttpStatusAn HTTP response's status code, from 100 to 599.Web and network
I
IataAirlineAn airline's two-character code: BA, U2.Travel
IataAirportAn airport's three-letter code, as tickets print it: LHR.Travel
IbanAn international bank account number, with its check digits: GB29NWBK60161331926819.Money and banking
IcaoAirportAn airport's four-letter code, as air traffic control uses it: EGLL.Travel
Icd10CodeA diagnosis's ICD-10 code, with its dot: I21.9.Health
IdempotencyKeyA key a client sends so that a retried request isn't applied twice.Software
IdentityDocumentAn identity document: its kind, the country, its number and when it expires.Tax and identity numbers
IdentityDocumentKindWhat kind of identity document one is: passport, identity_card, driving_licence or residence_permit.Tax and identity numbers
IlluminanceHow much light falls on a surface: 500lx.Physical quantities
ImageDimensionsAn image's width and height in pixels: 1920x1080.Media and visual
ImeiA mobile device's 15-digit IMEI.Web and network
IncotermA rule saying who pays for what in international shipping: FOB, DDP and so on.Commerce and logistics
InsetsSpace inside each edge, written in CSS's order: 8 16 8 16.Media and visual
InstantOne moment in time, the same everywhere in the world: 2026-10-25T09:30:00Z.Time and calendar
InstantRangeThe moments from a start up to, but not including, an end.Time and calendar
InterestRateA yearly rate of interest, and the basis it is quoted on: 5.5% APR.Money and banking
InterestRateBasisWhat an interest rate is quoted as: aer, apr or flat.Money and banking
InvoiceNumberAn invoice's number: up to 200 characters, as your own system writes it.Money and banking
IpAddressAn IPv4 or IPv6 address: 192.0.2.1, 2001:db8::1.Web and network
IsbnA book's number, in its 13 digits with no hyphens.Commerce and logistics
IsinA securities identification number, naming a share or a bond: US0378331005.Money and banking
IsoWeekA numbered week of a year, as ISO 8601 counts them: 2026-W43.Time and calendar
J
JsonPointerA pointer into a JSON document: /foo/0.Web and network
JurisdictionWhere a law applies: a country, or a part of one such as England.Other with a published standard
JwkA public key that a token is checked against, as an identity provider publishes it.Security
JwtA signed token: three parts joined by ..Security
JwtClaimsWhat a checked token says: who issued it, who it is about and when it expires.Security
L
LanguageA language, written as its two-letter code: en.Places
LatitudeDegrees north of the equator, from -90 to 90: 51.5072.Geospatial
LawfulBasisYour lawful reason for using personal data, under GDPR: consent, legitimate_interests and so on.Other with a published standard
LeiA Legal Entity Identifier, the global ID of a company in financial reporting.Money and banking
LengthA length or distance: 5km, 45cm, 3inch or 2metre.Physical quantities
LineStringA path of two points or more, in order.Geospatial
LocalDateTimeA date and a clock time with no zone: 2026-10-25T09:30:00.Time and calendar
LocaleA language and region together, which decides how dates and numbers look: en-GB.Places
LocalisedTextThe same text in several languages: {"en-GB": "Rye loaf", "fr-FR": "Pain de seigle"}.Text formats
LocalTimeA time on the clock, with no date or zone: 09:30:00.Time and calendar
LogLevelHow severe a log record is: TRACE, DEBUG, INFO, WARN, ERROR or FATAL.Software
LongitudeDegrees east of the prime meridian, from -180 to 180: -0.1276.Geospatial
LotNumberA manufacturing batch: up to 20 characters, such as ABC123.Commerce and logistics
M
MacAddressA network card's hardware address: AC-DE-48-00-00-80.Web and network
MapTileOne square of a web map at one zoom level: 10/511/340.Geospatial
MarkdownText written in Markdown, the plain-text format for bold, headings and lists.Text formats
MaskedCardNumberWhat you may keep of a card once its number is gone: the brand and the last four digits.Money and banking
MassA mass or weight: 250g, 2.5kg or 500mcg.Physical quantities
ModelIdAn AI model by its provider and name: openai/gpt-4o.Other with a published standard
MoneyAn amount of money: a whole number of a currency's smallest units, and the currency.Money and banking
MonthA month of the year: january to december.Time and calendar
MpanA UK electricity supply's 13-digit number.Other with a published standard
MprnA UK gas supply's number: 6 to 10 digits.Other with a published standard
MultiLineStringSeveral paths, at least one, that belong together.Geospatial
MultiPointA set of points, at least one, that belong together.Geospatial
MultiPolygonSeveral areas, at least one, that belong together.Geospatial
N
NationalityA person's nationality, named by country code: GB.People and contact
NetworkPortA TCP or UDP port, from 1 to 65535.Web and network
NhsNumberAn NHS number, the patient identifier in England, Wales and the Isle of Man: ten digits.Tax and identity numbers
O
OAuthScopeOne permission an OAuth token grants: todos:read.Security
OidcClaimsWho an identity provider says signed in.Security
OneTimeCodeA code a person types from an app, a text or an email: six to eight digits.Security
OpeningHoursWhen a place is open each week, and the days that differ.Time and calendar
OrcidA researcher's ORCID iD: 0000-0002-1825-0097.Other with a published standard
P
PackageUrlA package's address, the same across package managers: pkg:npm/left-pad@1.3.0.Software
PaperSizeA paper size: A4, Letter and so on.Media and visual
PassportNumberA passport's number, with the country that issued it.Tax and identity numbers
PasswordA password as a person types it: 8 to 256 characters.Security
PasswordCheckWhat checking a password says: wrong, correct or correct_outdated.Security
PasswordHashA password's hash, ready to store.Security
PasswordPolicyThe rules a password must meet: how short, how long, and whether to check breached lists.Security
PaymentCardNumberA payment card's full number, checked by its check digit.Money and banking
PaymentReferenceThe reference a payer sees on a UK bank payment: up to 18 characters.Money and banking
PercentageA share of something, written 20%, where 20% is the same as 0.20.Maths and data
PersonNameA person's name: a given name and, if they have one, a family name.People and contact
PhoneExtensionAn internal extension dialled after a phone number: up to 20 digits.People and contact
PhoneNumberA phone number with its country code, written +447400123456.People and contact
PointA position on Earth: its latitude, its longitude and, if you know it, its height.Geospatial
PolygonAn area on a map, with any holes it has.Geospatial
PostalAddressA postal address in any country.People and contact
PostalCodeA postal code or ZIP code, such as SW1A 1AA.People and contact
PowerA rate of energy use: 3kW.Physical quantities
PressureA pressure: 1013hPa.Physical quantities
PriceAn amount, and whether it includes tax.Money and banking
ProblemDetailsAn HTTP API's error body, as other APIs often send one.Web and network
PublicKeyAn Ed25519 public key: 32 bytes as Base64url.Security
PushTokenThe address of a device for push notifications, from Apple's or Google's service.Web and network
Q
QuarterA quarter of a calendar year: 2026-Q4.Time and calendar
R
RangeThe values of one ordered type from a start up to, but not including, an end.Maths and data
RatingA rating on its own scale: 4.5/5.Commerce and logistics
RatioOne number to another, as written: 16:9.Maths and data
RectA rectangle by its top-left corner and its size, written like an SVG viewBox: 0 0 300 200.Media and visual
RecurrenceRuleWhen something repeats, in the calendar standard's own text.Time and calendar
RegularExpressionA pattern for matching text: [A-Z]{2}[0-9]{2}.Software
RelativeUrlAn address relative to another: ../images/logo.png, ?page=2.Web and network
RichTextA structured document: a list of paragraphs, headings, quotes and list items.Text formats
RichTextBlockOne block of a RichText: a paragraph, a heading, a quote or a list item.Text formats
RichTextMarkA mark on some text: strong, emphasis, code, underline or strike_through.Text formats
RichTextSpanA run of text in a block, with its marks and any link.Text formats
RouteOfAdministrationHow a medicine is taken: oral, intravenous and so on.Health
S
SecretTextAny other secret text, up to 8,192 characters.Security
SemanticVersionA software version: 1.2.3-alpha.1+build.5.Software
SerialNumberOne item's own serial number: up to 20 characters, such as SN-0042a.Commerce and logistics
ShoeSizeA shoe size in its system, as the box writes it: UK 7.5, EU 42.Commerce and logistics
ShoeSizeSystemWhich system a shoe size is in: UK, EU or US.Commerce and logistics
SkuA seller's own stock code: up to 64 characters with no spaces, such as AB-1234-XL.Commerce and logistics
SlugA URL-safe name: lower-case words joined by hyphens, autumn-sale.Web and network
SnomedConceptA SNOMED CT concept's number, the clinical term a health system records: 22298006.Health
SoundLevelHow loud something is: 60dB.Physical quantities
SpanIdOne step's id in a trace: 16 lower-case hexadecimal digits, not all zero.Software
SpdxLicenceA software licence as SPDX writes it: MIT OR Apache-2.0.Software
SpeedA speed: 30mph or 100kmh.Physical quantities
SsccThe 18-digit number on a pallet or shipping container's label.Commerce and logistics
SubtitleCueA timed caption: when it starts and ends, and its text.Media and visual
T
TaxIdA taxpayer's identification number, with the country that issued it.Tax and identity numbers
TaxRateA rate of tax, as a percentage that can't be below zero: 20%.Money and banking
TemperatureA temperature: 21degC, 70degF or 300kelvin.Physical quantities
TemperatureDifferenceThe gap between two temperatures, so 5 °C warmer isn't the same as 5 °C.Physical quantities
TenureHow land in England and Wales is held: freehold, leasehold or commonhold.Other with a published standard
TextDirectionWhich way text runs: ltr or rtl.Places
TimecodeAn address of one frame in a video: hours, minutes, seconds and frames.Media and visual
TokenCountHow many tokens a prompt or an answer holds, by its model's own count.AI
TokenUsageThe tokens one call to a model used: what it read, what it wrote and what its cache served.AI
TotpSecretThe shared secret behind an authenticator app.Security
TraceIdA whole trace's id: 32 lower-case hexadecimal digits, not all zero.Software
TraceParentA traceparent header's value, which links a request to its trace.Software
TrackingNumberA parcel's tracking number, with its carrier: UPSN 1Z999AA10123456784.Commerce and logistics
U
UkAccountNumberA UK bank account number: eight digits, with any leading zeros kept.Money and banking
UkCompanyNumberA UK company's number at Companies House: 00445790 or SC123456.Tax and identity numbers
UkNationalInsuranceNumberA UK National Insurance number: AB123456C.Tax and identity numbers
UkSortCodeA UK bank's sort code, as six digits: 089999.Money and banking
UkUtrA UK Unique Taxpayer Reference: ten digits.Tax and identity numbers
UlidA sortable unique identifier: 26 capital letters and digits.Software
UnitPriceA price per amount of something, such as £2.50 per kilo.Money and banking
UnitQuantityHow much of something: a count of items, or an amount by mass, volume, length or area.Commerce and logistics
UnLocodeA place in trade and transport: a country's code and three letters or digits, GBLON.Places
UnNumberA dangerous good's UN number: UN1203.Other with a published standard
UpcAThe 12-digit barcode number on products in the US and Canada.Commerce and logistics
UprnA Unique Property Reference Number, the identifier for a property in Great Britain.People and contact
UrlAn http:// or https:// address with a host.Web and network
UrlPathA URL's path, starting with /: /products/42.Web and network
UsEinA US Employer Identification Number, for a business: nine digits.Tax and identity numbers
UserAgentWhat an HTTP client says it is: curl/8.7.1.Web and network
UsernameA login handle: lower-case letters, digits, _, . and -, up to 64 of them.People and contact
UsSsnA US Social Security number: nine digits.Tax and identity numbers
UtcOffsetA fixed gap from UTC, in minutes: +05:30.Time and calendar
UtmParametersWhere a visit came from, as marketing links carry it: source, medium and campaign.Web and network
UuidA universally unique identifier, in lower case with hyphens.Software
V
VatNumberA VAT registration number, with its country's code at the front: GB980780684.Tax and identity numbers
VectorA list of numbers, as an AI model's embedding holds them.Maths and data
VehicleRegistrationA vehicle's registration mark with its country: GB AB12 CDE.Commerce and logistics
VersionRangeA range of versions: ^1.2.3, >=1.0.0 <2.0.0.Software
VideoCodecA video format as browsers name it: avc1.42001E, vp09.00.10.08.Media and visual
VideoResolutionA video's frame size in pixels: 1920x1080.Media and visual
VinA vehicle identification number: 17 characters with no I, O or Q.Commerce and logistics
VoltageAn electrical voltage: 230V.Physical quantities
VolumeA volume: 500ml or 2litre.Physical quantities
W
WebAuthnCredentialA passkey a person registered.Security
WebOriginA web origin: the scheme, the host and any port, https://example.com.Web and network
WeekdayA day of the week: monday to sunday.Time and calendar
WritingScriptA writing system, written as its four-letter code: Latn, Jpan.Places
Y
YearA calendar year: 2026.Time and calendar
YearMonthOne month of one year: 2026-10.Time and calendar
Z
ZoneA time zone, written as its name: Europe/London.Places
ZonedTimeA moment seen on the clock in one place: 2026-10-25T09:30:00+00:00[Europe/London].Time and calendar

Markdown for agents: /docs/types.md.Built from Jadpo main at aee2e8f.