@johnmorrisdotca/kuni 1.3.0 → 1.5.0

package/dist/subdivisions.d.ts

@@ -1,14 +1,42 @@
-import { S as Subdivision, d as Language } from './types-KWZz5xby.js';
-export { j as SUBDIVISION_TYPES, h as SubdivisionType } from './types-KWZz5xby.js';
+import { S as Subdivision, d as Language } from './types-C7CG02m1.js';
+export { e as SUBDIVISION_TYPES, f as SubdivisionType } from './types-C7CG02m1.js';
 
-/** A level of subdivision: 1 for a country's first division, 2 and 3 for those inside one, or "all". */
+/** A level of subdivision: 1 for a country's first division, 2 and 3 for those inside one, or "all".
+ *
+ * @example
+ * ```ts
+ * import type { Level } from "@johnmorrisdotca/kuni/subdivisions";
+ *
+ * const value: Level = "all";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type Level = 1 | 2 | 3 | "all";
-/** What `subdivisions()` may be asked. */
+/** What `subdivisions()` may be asked.
+ *
+ * @example
+ * ```ts
+ * import type { SubdivisionsOptions } from "@johnmorrisdotca/kuni/subdivisions";
+ *
+ * const value: SubdivisionsOptions = {level:1};
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface SubdivisionsOptions {
     /** 1 (the default) for the first division only; 2 or 3 for one deeper level; "all" for every level. */
     level?: Level;
 }
-/** What `subdivisionByName()` and `subdivisionsByName()` may be narrowed to. */
+/** What `subdivisionByName()` and `subdivisionsByName()` may be narrowed to.
+ *
+ * @example
+ * ```ts
+ * import type { SubdivisionByNameOptions } from "@johnmorrisdotca/kuni/subdivisions";
+ * import { country } from "@johnmorrisdotca/kuni";
+ *
+ * const value: SubdivisionByNameOptions = {country:"JP",level:1};
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface SubdivisionByNameOptions {
     /** Only this country's subdivisions (alpha-2, either case). */
     country?: string;
@@ -26,10 +54,10 @@ interface SubdivisionByNameOptions {
  * ```ts
  * import { subdivisions } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * subdivisions("JP")?.length;                    // 47
- * subdivisions("FR")?.length;                    // 26
- * subdivisions("FR", { level: "all" })?.length;  // 124
- * subdivisions("XX");                            // null
+ * console.log(subdivisions("JP")?.length);                    // 47
+ * console.log(subdivisions("FR")?.length);                    // 26
+ * console.log(subdivisions("FR", { level: "all" })?.length);  // 124
+ * console.log(subdivisions("XX"));                            // null
  * ```
  */
 declare const subdivisions: (countryCode: string, options?: SubdivisionsOptions) => readonly Subdivision[] | null;
@@ -41,7 +69,7 @@ declare const subdivisions: (countryCode: string, options?: SubdivisionsOptions)
  * ```ts
  * import { allSubdivisions } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * allSubdivisions().length;   // 5050
+ * console.log(allSubdivisions().length);   // 5050
  * ```
  */
 declare const allSubdivisions: () => readonly Subdivision[];
@@ -54,10 +82,10 @@ declare const allSubdivisions: () => readonly Subdivision[];
  * ```ts
  * import { subdivision } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * subdivision("JP-13")?.name.ja;   // "東京都"
- * subdivision("ca-on")?.name.en;   // "Ontario"
- * subdivision("FR-75C")?.parent;   // "FR-IDF"
- * subdivision("XX-99");            // null
+ * console.log(subdivision("JP-13")?.name.ja);   // "東京都"
+ * console.log(subdivision("ca-on")?.name.en);   // "Ontario"
+ * console.log(subdivision("FR-75C")?.parent);   // "FR-IDF"
+ * console.log(subdivision("XX-99"));            // null
  * ```
  */
 declare const subdivision: (code: string) => Subdivision | null;
@@ -71,8 +99,8 @@ declare const subdivision: (code: string) => Subdivision | null;
  * ```ts
  * import { subdivisionByShortCode } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * subdivisionByShortCode("CA", "ON")?.code;   // "CA-ON"
- * subdivisionByShortCode("JP", "99");         // null
+ * console.log(subdivisionByShortCode("CA", "ON")?.code);   // "CA-ON"
+ * console.log(subdivisionByShortCode("JP", "99"));         // null
  * ```
  */
 declare const subdivisionByShortCode: (countryCode: string, shortCode: string) => Subdivision | null;
@@ -88,9 +116,9 @@ declare const subdivisionByShortCode: (countryCode: string, shortCode: string) =
  * ```ts
  * import { subdivisionsByName } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * subdivisionsByName("Punjab").map((one) => one.code);   // ["IN-PB", "PK-PB"]
- * subdivisionsByName("とうきょうと").map((one) => one.code); // ["JP-13"]
- * subdivisionsByName("Narnia");                          // []
+ * console.log(subdivisionsByName("Punjab").map((one) => one.code));   // ["IN-PB", "PK-PB"]
+ * console.log(subdivisionsByName("とうきょうと").map((one) => one.code)); // ["JP-13"]
+ * console.log(subdivisionsByName("Narnia"));                          // []
  * ```
  */
 declare const subdivisionsByName: (text: string, options?: SubdivisionByNameOptions) => readonly Subdivision[];
@@ -106,9 +134,9 @@ declare const subdivisionsByName: (text: string, options?: SubdivisionByNameOpti
  * ```ts
  * import { subdivisionByName } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * subdivisionByName("オンタリオ州", { country: "CA" })?.code;   // "CA-ON"
- * subdivisionByName("Punjab");                                 // null
- * subdivisionByName("Punjab", { country: "PK" })?.code;        // "PK-PB"
+ * console.log(subdivisionByName("オンタリオ州", { country: "CA" })?.code);   // "CA-ON"
+ * console.log(subdivisionByName("Punjab"));                                 // null
+ * console.log(subdivisionByName("Punjab", { country: "PK" })?.code);        // "PK-PB"
  * ```
  */
 declare const subdivisionByName: (text: string, options?: SubdivisionByNameOptions) => Subdivision | null;
@@ -124,10 +152,10 @@ declare const subdivisionByName: (text: string, options?: SubdivisionByNameOptio
  * ```ts
  * import { subdivisionTypeLabel } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * subdivisionTypeLabel("JP-13");          // "metropolis"
- * subdivisionTypeLabel("JP-13", "ja");    // "都"
- * subdivisionTypeLabel("CA", "ja");       // "州"
- * subdivisionTypeLabel("XX");             // null
+ * console.log(subdivisionTypeLabel("JP-13"));          // "metropolis"
+ * console.log(subdivisionTypeLabel("JP-13", "ja"));    // "都"
+ * console.log(subdivisionTypeLabel("CA", "ja"));       // "州"
+ * console.log(subdivisionTypeLabel("XX"));             // null
  * ```
  */
 declare const subdivisionTypeLabel: (code: string, language?: Language) => string | null;

package/dist/{types-KWZz5xby.d.cts → types-C7CG02m1.d.cts}

@@ -5,8 +5,8 @@
  * ```ts
  * import { CONTINENTS, continentName } from "@johnmorrisdotca/kuni";
  *
- * CONTINENTS.length; // 7
- * CONTINENTS.map((one) => continentName(one, "ja"))[0]; // "アフリカ"
+ * console.log(CONTINENTS.length); // 7
+ * console.log(CONTINENTS.map((one) => continentName(one, "ja"))[0]); // "アフリカ"
  * ```
  */
 declare const CONTINENTS: readonly ["AF", "AN", "AS", "EU", "NA", "OC", "SA"];
@@ -18,7 +18,7 @@ declare const CONTINENTS: readonly ["AF", "AN", "AS", "EU", "NA", "OC", "SA"];
  * ```ts
  * import { SUBDIVISION_TYPES } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * SUBDIVISION_TYPES.includes("prefecture"); // true
+ * console.log(SUBDIVISION_TYPES.includes("prefecture")); // true
  * ```
  */
 declare const SUBDIVISION_TYPES: readonly ["atoll", "autonomous-community", "autonomous-region", "borough", "canton", "capital-district", "circuit", "city", "council-area", "country", "county", "department", "district", "division", "emirate", "governorate", "island", "krai", "metropolis", "municipality", "oblast", "parish", "prefecture", "principal-area", "province", "quarter", "region", "republic", "special-administrative-region", "state", "territory", "unitary-authority", "urban-prefecture", "voivodeship", "zone"];
@@ -29,17 +29,56 @@ declare const SUBDIVISION_TYPES: readonly ["atoll", "autonomous-community", "aut
  * ```ts
  * import { LANGUAGES } from "@johnmorrisdotca/kuni";
  *
- * LANGUAGES; // ["en", "ja"]
+ * console.log(LANGUAGES); // ["en", "ja"]
  * ```
  */
 declare const LANGUAGES: readonly ["en", "ja"];
-/** A continent's two letters: "AF", "AN", "AS", "EU", "NA", "OC" or "SA". */
+/** A continent's two letters: "AF", "AN", "AS", "EU", "NA", "OC" or "SA".
+ *
+ * @example
+ * ```ts
+ * import type { Continent } from "@johnmorrisdotca/kuni";
+ * import { CONTINENTS } from "@johnmorrisdotca/kuni";
+ *
+ * const value: Continent = CONTINENTS[0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type Continent = (typeof CONTINENTS)[number];
-/** A kind of subdivision, in kebab case: "prefecture", "state", "autonomous-community". */
+/** A kind of subdivision, in kebab case: "prefecture", "state", "autonomous-community".
+ *
+ * @example
+ * ```ts
+ * import type { SubdivisionType } from "@johnmorrisdotca/kuni/subdivisions";
+ * import { SUBDIVISION_TYPES } from "@johnmorrisdotca/kuni/subdivisions";
+ *
+ * const value: SubdivisionType = SUBDIVISION_TYPES[0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type SubdivisionType = (typeof SUBDIVISION_TYPES)[number];
-/** A language every name is kept in: "en" or "ja". */
+/** A language every name is kept in: "en" or "ja".
+ *
+ * @example
+ * ```ts
+ * import type { Language } from "@johnmorrisdotca/kuni";
+ *
+ * const value: Language = "ja";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type Language = (typeof LANGUAGES)[number];
-/** A country, or a territory with an ISO 3166-1 code of its own, as the lookups hand it out (frozen). */
+/** A country, or a territory with an ISO 3166-1 code of its own, as the lookups hand it out (frozen).
+ *
+ * @example
+ * ```ts
+ * import type { Country } from "@johnmorrisdotca/kuni";
+ * import { country } from "@johnmorrisdotca/kuni";
+ *
+ * const value: Country = country("JP")!;
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface Country {
     /** ISO 3166-1 alpha-2, "JP" */
     alpha2: string;
@@ -94,7 +133,17 @@ interface Country {
      */
     ioc?: string;
 }
-/** A subdivision of a country (a state, a province, a prefecture), with its ISO 3166-2 code, as the lookups hand it out (frozen). */
+/** A subdivision of a country (a state, a province, a prefecture), with its ISO 3166-2 code, as the lookups hand it out (frozen).
+ *
+ * @example
+ * ```ts
+ * import type { Subdivision } from "@johnmorrisdotca/kuni/subdivisions";
+ * import { subdivision } from "@johnmorrisdotca/kuni/subdivisions";
+ *
+ * const value: Subdivision = subdivision("JP-13")!;
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface Subdivision {
     /** ISO 3166-2, always in full: "JP-13", "CA-ON", "US-NY" */
     code: string;
@@ -116,24 +165,88 @@ interface Subdivision {
     /** The name in hiragana, for Japan's prefectures: "とうきょうと" */
     reading?: string;
 }
-/** The side of the road a country drives on. */
+/** The side of the road a country drives on.
+ *
+ * @example
+ * ```ts
+ * import type { DrivingSide } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: DrivingSide = "left";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type DrivingSide = "left" | "right";
-/** The first day of the week on a calendar there, as CLDR writes it. */
+/** The first day of the week on a calendar there, as CLDR writes it.
+ *
+ * @example
+ * ```ts
+ * import type { WeekStart } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: WeekStart = "mon";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type WeekStart = "mon" | "sun" | "sat" | "fri";
-/** The system of measurement in everyday use, as CLDR writes it: the United States' and Britain's are their own. */
+/** The system of measurement in everyday use, as CLDR writes it: the United States' and Britain's are their own.
+ *
+ * @example
+ * ```ts
+ * import type { MeasurementSystem } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: MeasurementSystem = "metric";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type MeasurementSystem = "metric" | "US" | "UK";
-/** The paper size in everyday use, as CLDR writes it. */
+/** The paper size in everyday use, as CLDR writes it.
+ *
+ * @example
+ * ```ts
+ * import type { PaperSize } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: PaperSize = "A4";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type PaperSize = "A4" | "US-Letter";
-/** The clock in everyday use, named as an hour cycle is in JavaScript: "h12" is 1 to 12 with AM and PM, "h23" is 0 to 23. */
+/** The clock in everyday use, named as an hour cycle is in JavaScript: "h12" is 1 to 12 with AM and PM, "h23" is 0 to 23.
+ *
+ * @example
+ * ```ts
+ * import type { HourCycle } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: HourCycle = "h23";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type HourCycle = "h12" | "h23";
-/** A point on the earth, in degrees: north and east are positive. */
+/** A point on the earth, in degrees: north and east are positive.
+ *
+ * @example
+ * ```ts
+ * import type { LatLon } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: LatLon = {lat:35.68,lon:139.76};
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface LatLon {
     /** Latitude in degrees, north positive: -90 to 90. */
     lat: number;
     /** Longitude in degrees, east positive: -180 to 180. */
     lon: number;
 }
-/** The facts about one country, from the /facts entry: plain numbers and codes, `null` where a source has none. */
+/** The facts about one country, from the /facts entry: plain numbers and codes, `null` where a source has none.
+ *
+ * @example
+ * ```ts
+ * import type { CountryFacts } from "@johnmorrisdotca/kuni/facts";
+ * import { facts } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: CountryFacts = facts("JP")!;
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface CountryFacts {
     /** ISO 3166-1 alpha-2, "JP" */
     alpha2: string;
@@ -164,7 +277,17 @@ interface CountryFacts {
     /** The clock CLDR prefers there: "h12" (1 to 12, with AM and PM) or "h23" (0 to 23). */
     hourCycle: HourCycle;
 }
-/** The facts about one subdivision, from the /subdivision-facts entry: `null` where Wikidata has none, or gives two. */
+/** The facts about one subdivision, from the /subdivision-facts entry: `null` where Wikidata has none, or gives two.
+ *
+ * @example
+ * ```ts
+ * import type { SubdivisionFacts } from "@johnmorrisdotca/kuni/subdivision-facts";
+ * import { loadSubdivisionFacts } from "@johnmorrisdotca/kuni/subdivision-facts";
+ *
+ * const value: SubdivisionFacts = (await loadSubdivisionFacts("JP"))![0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface SubdivisionFacts {
     /** ISO 3166-2, "JP-13" */
     code: string;
@@ -195,13 +318,32 @@ interface SubdivisionFacts {
  * ```ts
  * import { GROUPING_KINDS, groupings } from "@johnmorrisdotca/kuni/groupings";
  *
- * GROUPING_KINDS.map((kind) => groupings({ kind }).length)[0]; // 7
+ * console.log(GROUPING_KINDS.map((kind) => groupings({ kind }).length)[0]); // 7
  * ```
  */
 declare const GROUPING_KINDS: readonly ["continent", "m49", "membership", "informal", "subdivision"];
-/** What kind of grouping it is: "continent", "m49", "membership", "informal" or "subdivision". */
+/** What kind of grouping it is: "continent", "m49", "membership", "informal" or "subdivision".
+ *
+ * @example
+ * ```ts
+ * import type { GroupingKind } from "@johnmorrisdotca/kuni/groupings";
+ * import { GROUPING_KINDS } from "@johnmorrisdotca/kuni/groupings";
+ *
+ * const value: GroupingKind = GROUPING_KINDS[0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type GroupingKind = (typeof GROUPING_KINDS)[number];
-/** How a country stands with a body when it is not a member. */
+/** How a country stands with a body when it is not a member.
+ *
+ * @example
+ * ```ts
+ * import type { GroupingStatus } from "@johnmorrisdotca/kuni/groupings";
+ *
+ * const value: GroupingStatus = "observer";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type GroupingStatus = "candidate" | "associate" | "observer" | "suspended";
 
-export { type CountryFacts as C, type DrivingSide as D, type GroupingKind as G, type HourCycle as H, type LatLon as L, type MeasurementSystem as M, type PaperSize as P, type Subdivision as S, type WeekStart as W, type GroupingStatus as a, GROUPING_KINDS as b, type Continent as c, type Language as d, type Country as e, CONTINENTS as f, LANGUAGES as g, type SubdivisionType as h, type SubdivisionFacts as i, SUBDIVISION_TYPES as j };
+export { type CountryFacts as C, type DrivingSide as D, type GroupingKind as G, type HourCycle as H, type LatLon as L, type MeasurementSystem as M, type PaperSize as P, type Subdivision as S, type WeekStart as W, type GroupingStatus as a, GROUPING_KINDS as b, type SubdivisionFacts as c, type Language as d, SUBDIVISION_TYPES as e, type SubdivisionType as f, type Continent as g, type Country as h, CONTINENTS as i, LANGUAGES as j };

package/dist/{types-KWZz5xby.d.ts → types-C7CG02m1.d.ts}

@@ -5,8 +5,8 @@
  * ```ts
  * import { CONTINENTS, continentName } from "@johnmorrisdotca/kuni";
  *
- * CONTINENTS.length; // 7
- * CONTINENTS.map((one) => continentName(one, "ja"))[0]; // "アフリカ"
+ * console.log(CONTINENTS.length); // 7
+ * console.log(CONTINENTS.map((one) => continentName(one, "ja"))[0]); // "アフリカ"
  * ```
  */
 declare const CONTINENTS: readonly ["AF", "AN", "AS", "EU", "NA", "OC", "SA"];
@@ -18,7 +18,7 @@ declare const CONTINENTS: readonly ["AF", "AN", "AS", "EU", "NA", "OC", "SA"];
  * ```ts
  * import { SUBDIVISION_TYPES } from "@johnmorrisdotca/kuni/subdivisions";
  *
- * SUBDIVISION_TYPES.includes("prefecture"); // true
+ * console.log(SUBDIVISION_TYPES.includes("prefecture")); // true
  * ```
  */
 declare const SUBDIVISION_TYPES: readonly ["atoll", "autonomous-community", "autonomous-region", "borough", "canton", "capital-district", "circuit", "city", "council-area", "country", "county", "department", "district", "division", "emirate", "governorate", "island", "krai", "metropolis", "municipality", "oblast", "parish", "prefecture", "principal-area", "province", "quarter", "region", "republic", "special-administrative-region", "state", "territory", "unitary-authority", "urban-prefecture", "voivodeship", "zone"];
@@ -29,17 +29,56 @@ declare const SUBDIVISION_TYPES: readonly ["atoll", "autonomous-community", "aut
  * ```ts
  * import { LANGUAGES } from "@johnmorrisdotca/kuni";
  *
- * LANGUAGES; // ["en", "ja"]
+ * console.log(LANGUAGES); // ["en", "ja"]
  * ```
  */
 declare const LANGUAGES: readonly ["en", "ja"];
-/** A continent's two letters: "AF", "AN", "AS", "EU", "NA", "OC" or "SA". */
+/** A continent's two letters: "AF", "AN", "AS", "EU", "NA", "OC" or "SA".
+ *
+ * @example
+ * ```ts
+ * import type { Continent } from "@johnmorrisdotca/kuni";
+ * import { CONTINENTS } from "@johnmorrisdotca/kuni";
+ *
+ * const value: Continent = CONTINENTS[0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type Continent = (typeof CONTINENTS)[number];
-/** A kind of subdivision, in kebab case: "prefecture", "state", "autonomous-community". */
+/** A kind of subdivision, in kebab case: "prefecture", "state", "autonomous-community".
+ *
+ * @example
+ * ```ts
+ * import type { SubdivisionType } from "@johnmorrisdotca/kuni/subdivisions";
+ * import { SUBDIVISION_TYPES } from "@johnmorrisdotca/kuni/subdivisions";
+ *
+ * const value: SubdivisionType = SUBDIVISION_TYPES[0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type SubdivisionType = (typeof SUBDIVISION_TYPES)[number];
-/** A language every name is kept in: "en" or "ja". */
+/** A language every name is kept in: "en" or "ja".
+ *
+ * @example
+ * ```ts
+ * import type { Language } from "@johnmorrisdotca/kuni";
+ *
+ * const value: Language = "ja";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type Language = (typeof LANGUAGES)[number];
-/** A country, or a territory with an ISO 3166-1 code of its own, as the lookups hand it out (frozen). */
+/** A country, or a territory with an ISO 3166-1 code of its own, as the lookups hand it out (frozen).
+ *
+ * @example
+ * ```ts
+ * import type { Country } from "@johnmorrisdotca/kuni";
+ * import { country } from "@johnmorrisdotca/kuni";
+ *
+ * const value: Country = country("JP")!;
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface Country {
     /** ISO 3166-1 alpha-2, "JP" */
     alpha2: string;
@@ -94,7 +133,17 @@ interface Country {
      */
     ioc?: string;
 }
-/** A subdivision of a country (a state, a province, a prefecture), with its ISO 3166-2 code, as the lookups hand it out (frozen). */
+/** A subdivision of a country (a state, a province, a prefecture), with its ISO 3166-2 code, as the lookups hand it out (frozen).
+ *
+ * @example
+ * ```ts
+ * import type { Subdivision } from "@johnmorrisdotca/kuni/subdivisions";
+ * import { subdivision } from "@johnmorrisdotca/kuni/subdivisions";
+ *
+ * const value: Subdivision = subdivision("JP-13")!;
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface Subdivision {
     /** ISO 3166-2, always in full: "JP-13", "CA-ON", "US-NY" */
     code: string;
@@ -116,24 +165,88 @@ interface Subdivision {
     /** The name in hiragana, for Japan's prefectures: "とうきょうと" */
     reading?: string;
 }
-/** The side of the road a country drives on. */
+/** The side of the road a country drives on.
+ *
+ * @example
+ * ```ts
+ * import type { DrivingSide } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: DrivingSide = "left";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type DrivingSide = "left" | "right";
-/** The first day of the week on a calendar there, as CLDR writes it. */
+/** The first day of the week on a calendar there, as CLDR writes it.
+ *
+ * @example
+ * ```ts
+ * import type { WeekStart } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: WeekStart = "mon";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type WeekStart = "mon" | "sun" | "sat" | "fri";
-/** The system of measurement in everyday use, as CLDR writes it: the United States' and Britain's are their own. */
+/** The system of measurement in everyday use, as CLDR writes it: the United States' and Britain's are their own.
+ *
+ * @example
+ * ```ts
+ * import type { MeasurementSystem } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: MeasurementSystem = "metric";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type MeasurementSystem = "metric" | "US" | "UK";
-/** The paper size in everyday use, as CLDR writes it. */
+/** The paper size in everyday use, as CLDR writes it.
+ *
+ * @example
+ * ```ts
+ * import type { PaperSize } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: PaperSize = "A4";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type PaperSize = "A4" | "US-Letter";
-/** The clock in everyday use, named as an hour cycle is in JavaScript: "h12" is 1 to 12 with AM and PM, "h23" is 0 to 23. */
+/** The clock in everyday use, named as an hour cycle is in JavaScript: "h12" is 1 to 12 with AM and PM, "h23" is 0 to 23.
+ *
+ * @example
+ * ```ts
+ * import type { HourCycle } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: HourCycle = "h23";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type HourCycle = "h12" | "h23";
-/** A point on the earth, in degrees: north and east are positive. */
+/** A point on the earth, in degrees: north and east are positive.
+ *
+ * @example
+ * ```ts
+ * import type { LatLon } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: LatLon = {lat:35.68,lon:139.76};
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface LatLon {
     /** Latitude in degrees, north positive: -90 to 90. */
     lat: number;
     /** Longitude in degrees, east positive: -180 to 180. */
     lon: number;
 }
-/** The facts about one country, from the /facts entry: plain numbers and codes, `null` where a source has none. */
+/** The facts about one country, from the /facts entry: plain numbers and codes, `null` where a source has none.
+ *
+ * @example
+ * ```ts
+ * import type { CountryFacts } from "@johnmorrisdotca/kuni/facts";
+ * import { facts } from "@johnmorrisdotca/kuni/facts";
+ *
+ * const value: CountryFacts = facts("JP")!;
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface CountryFacts {
     /** ISO 3166-1 alpha-2, "JP" */
     alpha2: string;
@@ -164,7 +277,17 @@ interface CountryFacts {
     /** The clock CLDR prefers there: "h12" (1 to 12, with AM and PM) or "h23" (0 to 23). */
     hourCycle: HourCycle;
 }
-/** The facts about one subdivision, from the /subdivision-facts entry: `null` where Wikidata has none, or gives two. */
+/** The facts about one subdivision, from the /subdivision-facts entry: `null` where Wikidata has none, or gives two.
+ *
+ * @example
+ * ```ts
+ * import type { SubdivisionFacts } from "@johnmorrisdotca/kuni/subdivision-facts";
+ * import { loadSubdivisionFacts } from "@johnmorrisdotca/kuni/subdivision-facts";
+ *
+ * const value: SubdivisionFacts = (await loadSubdivisionFacts("JP"))![0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 interface SubdivisionFacts {
     /** ISO 3166-2, "JP-13" */
     code: string;
@@ -195,13 +318,32 @@ interface SubdivisionFacts {
  * ```ts
  * import { GROUPING_KINDS, groupings } from "@johnmorrisdotca/kuni/groupings";
  *
- * GROUPING_KINDS.map((kind) => groupings({ kind }).length)[0]; // 7
+ * console.log(GROUPING_KINDS.map((kind) => groupings({ kind }).length)[0]); // 7
  * ```
  */
 declare const GROUPING_KINDS: readonly ["continent", "m49", "membership", "informal", "subdivision"];
-/** What kind of grouping it is: "continent", "m49", "membership", "informal" or "subdivision". */
+/** What kind of grouping it is: "continent", "m49", "membership", "informal" or "subdivision".
+ *
+ * @example
+ * ```ts
+ * import type { GroupingKind } from "@johnmorrisdotca/kuni/groupings";
+ * import { GROUPING_KINDS } from "@johnmorrisdotca/kuni/groupings";
+ *
+ * const value: GroupingKind = GROUPING_KINDS[0];
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type GroupingKind = (typeof GROUPING_KINDS)[number];
-/** How a country stands with a body when it is not a member. */
+/** How a country stands with a body when it is not a member.
+ *
+ * @example
+ * ```ts
+ * import type { GroupingStatus } from "@johnmorrisdotca/kuni/groupings";
+ *
+ * const value: GroupingStatus = "observer";
+ * console.log(typeof value === "object" ? Object.keys(value).slice(0,6) : value);
+ * ```
+ */
 type GroupingStatus = "candidate" | "associate" | "observer" | "suspended";
 
-export { type CountryFacts as C, type DrivingSide as D, type GroupingKind as G, type HourCycle as H, type LatLon as L, type MeasurementSystem as M, type PaperSize as P, type Subdivision as S, type WeekStart as W, type GroupingStatus as a, GROUPING_KINDS as b, type Continent as c, type Language as d, type Country as e, CONTINENTS as f, LANGUAGES as g, type SubdivisionType as h, type SubdivisionFacts as i, SUBDIVISION_TYPES as j };
+export { type CountryFacts as C, type DrivingSide as D, type GroupingKind as G, type HourCycle as H, type LatLon as L, type MeasurementSystem as M, type PaperSize as P, type Subdivision as S, type WeekStart as W, type GroupingStatus as a, GROUPING_KINDS as b, type SubdivisionFacts as c, type Language as d, SUBDIVISION_TYPES as e, type SubdivisionType as f, type Continent as g, type Country as h, CONTINENTS as i, LANGUAGES as j };