@uk-open-data-connectors/uk-sources 0.1.0 → 0.1.1

package/dist/postcodeLookup.d.ts

@@ -0,0 +1,55 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * postcodes.io, a free keyless lookup over ONS and Ordnance Survey postcode
+ * data published under the Open Government Licence v3. The service itself is
+ * a third party, not a government API: the postcode data is OGL, the lookup
+ * and the geocoding around it are postcodes.io's own.
+ */
+export declare const POSTCODE_LOOKUP_SOURCE_ID = "postcode-lookup";
+/** Base URL for the postcodes.io single postcode lookup. */
+export declare const POSTCODES_IO_BASE_URL = "https://api.postcodes.io/postcodes/";
+/** The postcode the adapter looks up when the caller does not name one. */
+export declare const DEFAULT_POSTCODE_QUERY = "SW1A1AA";
+/** One postcode and the administrative areas it falls inside. */
+export interface PostcodeLookupRecord {
+    /** The postcode as the service formats it, letters and digits spaced. */
+    postcode: string;
+    country: string;
+    /** English region or devolved nation region, or null when unset. */
+    region: string | null;
+    adminDistrict: string | null;
+    adminWard: string | null;
+    parliamentaryConstituency: string | null;
+    latitude: number;
+    longitude: number;
+    /** The NHS area the postcode sits in, or null when unset. */
+    nhsHa: string | null;
+}
+/**
+ * Builds the postcodes.io lookup URL for one postcode.
+ *
+ * @param postcode - the postcode to look up, spaced or unspaced
+ * @returns the single postcode lookup URL
+ */
+export declare function buildPostcodeLookupUrl(postcode: string): string;
+/**
+ * Parses a postcodes.io single postcode payload.
+ *
+ * @param payload - the raw JSON body from the lookup endpoint
+ * @returns the postcode record the service returns
+ */
+export declare function parsePostcodeLookup(payload: unknown): PostcodeLookupRecord;
+/**
+ * Looks up one postcode. The service answers 404 for an unknown postcode,
+ * which becomes an API error like any other failed request.
+ *
+ * @param postcode - the postcode to look up, default SW1A 1AA
+ * @param options - an optional fetch implementation
+ * @returns the postcode record the service returns
+ */
+export declare function fetchPostcodeLookup(postcode?: string, options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<PostcodeLookupRecord>;
+/** postcodes.io single postcode lookup, keyless. */
+export declare const postcodeLookupAdapter: UkDataAdapter<PostcodeLookupRecord>;
+//# sourceMappingURL=postcodeLookup.d.ts.map

package/dist/postcodeLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcodeLookup.d.ts","sourceRoot":"","sources":["../src/postcodeLookup.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,wCAAwC,CAAC;AAE3E,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAmBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAiB1E;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,GAAE,MAA+B,EACzC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpD,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,oBAAoB,CAYrE,CAAC"}

package/dist/postcodeLookup.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * postcodes.io, a free keyless lookup over ONS and Ordnance Survey postcode
+ * data published under the Open Government Licence v3. The service itself is
+ * a third party, not a government API: the postcode data is OGL, the lookup
+ * and the geocoding around it are postcodes.io's own.
+ */
+export const POSTCODE_LOOKUP_SOURCE_ID = 'postcode-lookup';
+/** Base URL for the postcodes.io single postcode lookup. */
+export const POSTCODES_IO_BASE_URL = 'https://api.postcodes.io/postcodes/';
+/** The postcode the adapter looks up when the caller does not name one. */
+export const DEFAULT_POSTCODE_QUERY = 'SW1A1AA';
+const POSTCODE_RESULT_SCHEMA = z.object({
+    postcode: z.string(),
+    country: z.string(),
+    region: z.string().nullable().optional(),
+    admin_district: z.string().nullable().optional(),
+    admin_ward: z.string().nullable().optional(),
+    parliamentary_constituency: z.string().nullable().optional(),
+    latitude: z.number(),
+    longitude: z.number(),
+    nhs_ha: z.string().nullable().optional(),
+});
+const POSTCODE_LOOKUP_SCHEMA = z.object({
+    status: z.number(),
+    result: POSTCODE_RESULT_SCHEMA,
+});
+/**
+ * Builds the postcodes.io lookup URL for one postcode.
+ *
+ * @param postcode - the postcode to look up, spaced or unspaced
+ * @returns the single postcode lookup URL
+ */
+export function buildPostcodeLookupUrl(postcode) {
+    return `${POSTCODES_IO_BASE_URL}${encodeURIComponent(postcode)}`;
+}
+/**
+ * Parses a postcodes.io single postcode payload.
+ *
+ * @param payload - the raw JSON body from the lookup endpoint
+ * @returns the postcode record the service returns
+ */
+export function parsePostcodeLookup(payload) {
+    const parsed = POSTCODE_LOOKUP_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('postcode-lookup', parsed.error.message);
+    }
+    const result = parsed.data.result;
+    return {
+        postcode: result.postcode,
+        country: result.country,
+        region: result.region ?? null,
+        adminDistrict: result.admin_district ?? null,
+        adminWard: result.admin_ward ?? null,
+        parliamentaryConstituency: result.parliamentary_constituency ?? null,
+        latitude: result.latitude,
+        longitude: result.longitude,
+        nhsHa: result.nhs_ha ?? null,
+    };
+}
+/**
+ * Looks up one postcode. The service answers 404 for an unknown postcode,
+ * which becomes an API error like any other failed request.
+ *
+ * @param postcode - the postcode to look up, default SW1A 1AA
+ * @param options - an optional fetch implementation
+ * @returns the postcode record the service returns
+ */
+export async function fetchPostcodeLookup(postcode = DEFAULT_POSTCODE_QUERY, options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(buildPostcodeLookupUrl(postcode));
+    if (!response.ok) {
+        throw new UkSourceApiError('postcode-lookup', `HTTP ${response.status} looking up ${postcode}`);
+    }
+    return parsePostcodeLookup(await response.json());
+}
+/** postcodes.io single postcode lookup, keyless. */
+export const postcodeLookupAdapter = {
+    id: POSTCODE_LOOKUP_SOURCE_ID,
+    name: 'postcodes.io postcode lookup',
+    auth: 'none',
+    description: `One postcode's country, region, wards, and coordinates, default ${DEFAULT_POSTCODE_QUERY}.`,
+    fetchLive: (options) => fetchPostcodeLookup(DEFAULT_POSTCODE_QUERY, options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parsePostcodeLookup,
+    loadFixture: () => parsePostcodeLookup(readFixtureJson('postcode-lookup-2026-10-05.json')),
+};
+//# sourceMappingURL=postcodeLookup.js.map

package/dist/postcodeLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcodeLookup.js","sourceRoot":"","sources":["../src/postcodeLookup.ts"],"names":[],"mappings":"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"}

package/dist/publicHealthScotland.d.ts

@@ -0,0 +1,43 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Public Health Scotland's open data portal, served by CKAN. Keyless, and the
+ * datasets are published under the Open Government Licence v3.
+ */
+export declare const PUBLIC_HEALTH_SCOTLAND_SOURCE_ID = "public-health-scotland";
+/** The CKAN package_list call on the Public Health Scotland portal. */
+export declare const PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_URL = "https://www.opendata.nhs.scot/api/3/action/package_list";
+/** One dataset in the Public Health Scotland catalogue. */
+export interface PublicHealthScotlandDataset {
+    /** CKAN package name, the identifier used in every other CKAN call. */
+    name: string;
+}
+/** Rolled-up view of the Public Health Scotland catalogue. */
+export interface PublicHealthScotlandSummary {
+    packageCount: number;
+}
+/**
+ * Parses a Public Health Scotland package_list payload.
+ *
+ * @param payload - the raw JSON body from the CKAN package_list call
+ * @returns one entry per dataset in the catalogue
+ */
+export declare function parsePublicHealthScotlandDatasets(payload: unknown): PublicHealthScotlandDataset[];
+/**
+ * Counts the Public Health Scotland catalogue.
+ *
+ * @param datasets - dataset names from {@link parsePublicHealthScotlandDatasets}
+ * @returns the number of datasets listed
+ */
+export declare function summarizePublicHealthScotlandDatasets(datasets: PublicHealthScotlandDataset[]): PublicHealthScotlandSummary;
+/**
+ * Lists every dataset in the Public Health Scotland catalogue.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the package names the catalogue returns
+ */
+export declare function fetchPublicHealthScotlandDatasets(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<PublicHealthScotlandDataset[]>;
+/** Public Health Scotland open data catalogue, keyless. */
+export declare const publicHealthScotlandAdapter: UkDataAdapter<PublicHealthScotlandDataset[]>;
+//# sourceMappingURL=publicHealthScotland.d.ts.map

package/dist/publicHealthScotland.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicHealthScotland.d.ts","sourceRoot":"","sources":["../src/publicHealthScotland.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,gCAAgC,2BAA2B,CAAC;AAEzE,uEAAuE;AACvE,eAAO,MAAM,uCAAuC,4DACO,CAAC;AAE5D,2DAA2D;AAC3D,MAAM,WAAW,2BAA2B;IAC1C,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;CACtB;AAOD;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,2BAA2B,EAAE,CAMjG;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,2BAA2B,EAAE,GACtC,2BAA2B,CAE7B;AAED;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpD,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAUxC;AAED,2DAA2D;AAC3D,eAAO,MAAM,2BAA2B,EAAE,aAAa,CAAC,2BAA2B,EAAE,CAYpF,CAAC"}

package/dist/publicHealthScotland.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * Public Health Scotland's open data portal, served by CKAN. Keyless, and the
+ * datasets are published under the Open Government Licence v3.
+ */
+export const PUBLIC_HEALTH_SCOTLAND_SOURCE_ID = 'public-health-scotland';
+/** The CKAN package_list call on the Public Health Scotland portal. */
+export const PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_URL = 'https://www.opendata.nhs.scot/api/3/action/package_list';
+const PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_SCHEMA = z.object({
+    success: z.boolean(),
+    result: z.array(z.string()),
+});
+/**
+ * Parses a Public Health Scotland package_list payload.
+ *
+ * @param payload - the raw JSON body from the CKAN package_list call
+ * @returns one entry per dataset in the catalogue
+ */
+export function parsePublicHealthScotlandDatasets(payload) {
+    const parsed = PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('public-health-scotland', parsed.error.message);
+    }
+    return parsed.data.result.map((name) => ({ name }));
+}
+/**
+ * Counts the Public Health Scotland catalogue.
+ *
+ * @param datasets - dataset names from {@link parsePublicHealthScotlandDatasets}
+ * @returns the number of datasets listed
+ */
+export function summarizePublicHealthScotlandDatasets(datasets) {
+    return { packageCount: datasets.length };
+}
+/**
+ * Lists every dataset in the Public Health Scotland catalogue.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the package names the catalogue returns
+ */
+export async function fetchPublicHealthScotlandDatasets(options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_URL);
+    if (!response.ok) {
+        throw new UkSourceApiError('public-health-scotland', `HTTP ${response.status} listing packages`);
+    }
+    return parsePublicHealthScotlandDatasets(await response.json());
+}
+/** Public Health Scotland open data catalogue, keyless. */
+export const publicHealthScotlandAdapter = {
+    id: PUBLIC_HEALTH_SCOTLAND_SOURCE_ID,
+    name: 'Public Health Scotland open data catalogue',
+    auth: 'none',
+    description: 'Every dataset Public Health Scotland publishes on its open data portal.',
+    fetchLive: (options) => fetchPublicHealthScotlandDatasets(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parsePublicHealthScotlandDatasets,
+    loadFixture: () => parsePublicHealthScotlandDatasets(readFixtureJson('public-health-scotland-2026-10-05.json')),
+};
+//# sourceMappingURL=publicHealthScotland.js.map

package/dist/publicHealthScotland.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicHealthScotland.js","sourceRoot":"","sources":["../src/publicHealthScotland.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,wBAAwB,CAAC;AAEzE,uEAAuE;AACvE,MAAM,CAAC,MAAM,uCAAuC,GAClD,yDAAyD,CAAC;AAa5D,MAAM,0CAA0C,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAAgB;IAChE,MAAM,MAAM,GAAG,0CAA0C,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qCAAqC,CACnD,QAAuC;IAEvC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,UAAmD,EAAE;IAErD,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CACxB,wBAAwB,EACxB,QAAQ,QAAQ,CAAC,MAAM,mBAAmB,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,iCAAiC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAiD;IACvF,EAAE,EAAE,gCAAgC;IACpC,IAAI,EAAE,4CAA4C;IAClD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,yEAAyE;IACtF,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,iCAAiC,CAC/B,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACzE;IACH,KAAK,EAAE,iCAAiC;IACxC,WAAW,EAAE,GAAG,EAAE,CAChB,iCAAiC,CAAC,eAAe,CAAC,wCAAwC,CAAC,CAAC;CAC/F,CAAC"}

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,EAYnD,CAAC;AAEF,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAE3E;AAED,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAE,GACjE,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED,iFAAiF;AACjF,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAW3B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,EAuBnD,CAAC;AAEF,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAE3E;AAED,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAE,GACjE,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED,iFAAiF;AACjF,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAW3B"}

package/dist/registry.js

@@ -1,13 +1,24 @@
 import { ancientWoodlandAdapter } from './ancientWoodland.js';
 import { bankRateAdapter } from './bankRate.js';
 import { carbonIntensityAdapter } from './carbonIntensity.js';
+import { exploreEducationStatisticsAdapter } from './exploreEducationStatistics.js';
+import { findATenderAdapter } from './findATender.js';
+import { fingertipsIndicatorsAdapter } from './fingertipsIndicators.js';
 import { floodReadingsAdapter, floodStationsAdapter } from './floodMonitoring.js';
 import { foodHygieneAuthoritiesAdapter } from './foodHygiene.js';
+import { londonDatastoreAdapter } from './londonDatastore.js';
+import { nhsbsaCkanAdapter } from './nhsbsaCkan.js';
+import { nomisAdapter } from './nomis.js';
 import { onsDatasetsAdapter } from './onsDatasets.js';
 import { parliamentSeatsAdapter } from './parliamentSeats.js';
 import { planningDatasetsAdapter } from './planningDatasets.js';
 import { policeCrimesAdapter } from './policeCrimes.js';
+import { postcodeLookupAdapter } from './postcodeLookup.js';
+import { publicHealthScotlandAdapter } from './publicHealthScotland.js';
 import { tflBikePointsAdapter } from './tflBikePoints.js';
+import { tflLineStatusAdapter } from './tflLineStatus.js';
+import { tnaDiscoveryAdapter } from './tnaDiscovery.js';
+import { ukhsaDashboardAdapter } from './ukhsaDashboard.js';
 /** Every UK data source behind the uniform adapter interface. */
 export const UK_DATA_SOURCES = [
     floodStationsAdapter,
@@ -21,6 +32,17 @@ export const UK_DATA_SOURCES = [
     policeCrimesAdapter,
     carbonIntensityAdapter,
     parliamentSeatsAdapter,
+    postcodeLookupAdapter,
+    exploreEducationStatisticsAdapter,
+    londonDatastoreAdapter,
+    tnaDiscoveryAdapter,
+    ukhsaDashboardAdapter,
+    nomisAdapter,
+    fingertipsIndicatorsAdapter,
+    findATenderAdapter,
+    tflLineStatusAdapter,
+    publicHealthScotlandAdapter,
+    nhsbsaCkanAdapter,
 ];
 /** Looks up a source adapter by id. */
 export function getUkDataSource(id) {

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/tflLineStatus.d.ts

@@ -0,0 +1,59 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Transport for London's live Tube line status. Keyless: the endpoint answers
+ * without an app key, and TfL asks for one only above the free rate limit.
+ * Published as TfL Open Data.
+ */
+export declare const TFL_LINE_STATUS_SOURCE_ID = "tfl-line-status";
+/** The Tube line status endpoint, covering every Tube line at once. */
+export declare const TFL_LINE_STATUS_URL = "https://api.tfl.gov.uk/Line/Mode/tube/Status";
+/** TfL's severity code for a line running a good service. */
+export declare const TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY = 10;
+/** One Tube line and the service status TfL reports for it. */
+export interface TflLineStatus {
+    /** TfL's line id, such as "bakerloo". */
+    id: string;
+    name: string;
+    modeName: string;
+    /** TfL's numeric severity, 10 for a good service. */
+    statusSeverity: number;
+    /** TfL's own wording for the severity, such as "Minor Delays". */
+    statusSeverityDescription: string;
+    /** The operator's explanation, or "" when there is nothing to explain. */
+    reason: string;
+}
+/** Rolled-up view of the Tube line status list. */
+export interface TflLineStatusSummary {
+    lineCount: number;
+    /** Lines TfL reports at good-service severity. */
+    goodServiceCount: number;
+    /** The lines running below a good service, in TfL's order. */
+    disruptedLines: TflLineStatus[];
+}
+/**
+ * Parses a TfL line status payload into one record per line.
+ *
+ * @param payload - the raw JSON body from the line status endpoint
+ * @returns one record per Tube line, in TfL's order
+ */
+export declare function parseTflLineStatuses(payload: unknown): TflLineStatus[];
+/**
+ * Counts the lines and keeps the ones running below a good service.
+ *
+ * @param lines - lines from {@link parseTflLineStatuses}
+ * @returns line and good-service counts plus the disrupted lines
+ */
+export declare function summarizeTflLineStatuses(lines: TflLineStatus[]): TflLineStatusSummary;
+/**
+ * Reads the live status of every Tube line from TfL.
+ *
+ * @param options - an optional app key and fetch implementation
+ * @returns the line statuses the endpoint returns
+ */
+export declare function fetchTflLineStatuses(options?: {
+    apiKey?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<TflLineStatus[]>;
+/** Transport for London Tube line status, keyless. */
+export declare const tflLineStatusAdapter: UkDataAdapter<TflLineStatus[]>;
+//# sourceMappingURL=tflLineStatus.d.ts.map

package/dist/tflLineStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tflLineStatus.d.ts","sourceRoot":"","sources":["../src/tflLineStatus.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,iDAAiD,CAAC;AAElF,6DAA6D;AAC7D,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAExD,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,yBAAyB,EAAE,MAAM,CAAC;IAClC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAkBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAgBtE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,oBAAoB,CAUrF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACrE,OAAO,CAAC,aAAa,EAAE,CAAC,CAW1B;AAED,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,aAAa,EAAE,CAY/D,CAAC"}

package/dist/tflLineStatus.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * Transport for London's live Tube line status. Keyless: the endpoint answers
+ * without an app key, and TfL asks for one only above the free rate limit.
+ * Published as TfL Open Data.
+ */
+export const TFL_LINE_STATUS_SOURCE_ID = 'tfl-line-status';
+/** The Tube line status endpoint, covering every Tube line at once. */
+export const TFL_LINE_STATUS_URL = 'https://api.tfl.gov.uk/Line/Mode/tube/Status';
+/** TfL's severity code for a line running a good service. */
+export const TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY = 10;
+const TFL_LINE_STATUS_ENTRY_SCHEMA = z.object({
+    id: z.number(),
+    statusSeverity: z.number(),
+    statusSeverityDescription: z.string(),
+    reason: z.string().optional(),
+});
+const TFL_LINE_SCHEMA = z.object({
+    id: z.string(),
+    name: z.string(),
+    modeName: z.string(),
+    lineStatuses: z.array(TFL_LINE_STATUS_ENTRY_SCHEMA).min(1),
+});
+const TFL_LINES_SCHEMA = z.array(TFL_LINE_SCHEMA);
+/**
+ * Parses a TfL line status payload into one record per line.
+ *
+ * @param payload - the raw JSON body from the line status endpoint
+ * @returns one record per Tube line, in TfL's order
+ */
+export function parseTflLineStatuses(payload) {
+    const parsed = TFL_LINES_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('tfl-line-status', parsed.error.message);
+    }
+    return parsed.data.map((line) => {
+        const status = line.lineStatuses[0];
+        return {
+            id: line.id,
+            name: line.name,
+            modeName: line.modeName,
+            statusSeverity: status?.statusSeverity ?? 0,
+            statusSeverityDescription: status?.statusSeverityDescription ?? '',
+            reason: status?.reason ?? '',
+        };
+    });
+}
+/**
+ * Counts the lines and keeps the ones running below a good service.
+ *
+ * @param lines - lines from {@link parseTflLineStatuses}
+ * @returns line and good-service counts plus the disrupted lines
+ */
+export function summarizeTflLineStatuses(lines) {
+    return {
+        lineCount: lines.length,
+        goodServiceCount: lines.filter((line) => line.statusSeverity === TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY).length,
+        disruptedLines: lines.filter((line) => line.statusSeverity !== TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY),
+    };
+}
+/**
+ * Reads the live status of every Tube line from TfL.
+ *
+ * @param options - an optional app key and fetch implementation
+ * @returns the line statuses the endpoint returns
+ */
+export async function fetchTflLineStatuses(options = {}) {
+    const { apiKey, fetchImpl = globalThis.fetch } = options;
+    const url = apiKey === undefined
+        ? TFL_LINE_STATUS_URL
+        : `${TFL_LINE_STATUS_URL}?app_key=${encodeURIComponent(apiKey)}`;
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UkSourceApiError('tfl-line-status', `HTTP ${response.status} reading line status`);
+    }
+    return parseTflLineStatuses(await response.json());
+}
+/** Transport for London Tube line status, keyless. */
+export const tflLineStatusAdapter = {
+    id: TFL_LINE_STATUS_SOURCE_ID,
+    name: 'Transport for London Tube line status',
+    auth: 'none',
+    description: 'The live service status of every Tube line, with disruption reasons.',
+    fetchLive: (options) => fetchTflLineStatuses({
+        ...(options?.apiKey === undefined ? {} : { apiKey: options.apiKey }),
+        ...(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    }),
+    parse: parseTflLineStatuses,
+    loadFixture: () => parseTflLineStatuses(readFixtureJson('tfl-line-status-2026-10-05.json')),
+};
+//# sourceMappingURL=tflLineStatus.js.map

package/dist/tflLineStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tflLineStatus.js","sourceRoot":"","sources":["../src/tflLineStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;AAE3D,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,8CAA8C,CAAC;AAElF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AAyBxD,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3D,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,CAAC;YAC3C,yBAAyB,EAAE,MAAM,EAAE,yBAAyB,IAAI,EAAE;YAClE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE;SAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAsB;IAC7D,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,KAAK,qCAAqC,CACxE,CAAC,MAAM;QACR,cAAc,EAAE,KAAK,CAAC,MAAM,CAC1B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,KAAK,qCAAqC,CACxE;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAoE,EAAE;IAEtE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,GAAG,GACP,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,GAAG,mBAAmB,YAAY,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,QAAQ,QAAQ,CAAC,MAAM,sBAAsB,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAmC;IAClE,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,sEAAsE;IACnF,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,oBAAoB,CAAC;QACnB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;KAC9E,CAAC;IACJ,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,eAAe,CAAC,iCAAiC,CAAC,CAAC;CAC5F,CAAC"}

package/dist/tnaDiscovery.d.ts

@@ -0,0 +1,76 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Discovery, The National Archives' catalogue search API. Keyless, and the
+ * catalogue metadata is published under the Open Government Licence v3.
+ */
+export declare const TNA_DISCOVERY_SOURCE_ID = "tna-discovery";
+/** Base URL for the Discovery record search. */
+export declare const TNA_DISCOVERY_SEARCH_URL = "https://discovery.nationalarchives.gov.uk/API/search/records";
+/**
+ * The header Discovery expects for a JSON answer. On 2026-10-05 the endpoint
+ * also answered JSON without it, but the adapter sends it either way.
+ */
+export declare const TNA_DISCOVERY_ACCEPT_HEADER = "application/json";
+/** The search term the adapter asks for when the caller does not name one. */
+export declare const DEFAULT_TNA_DISCOVERY_QUERY = "test";
+/** One catalogue record Discovery returns for a search. */
+export interface TnaDiscoveryRecord {
+    id: string;
+    /** The archive's own reference, such as a catalogue piece number. */
+    reference: string;
+    title: string;
+    description: string;
+    /** The date range the record covers, as the archive writes it. */
+    coveringDates: string;
+    /** Depth in the catalogue hierarchy, or null when the record leaves it out. */
+    catalogueLevel: number | null;
+    /** The department code the record belongs to, or "" when unset. */
+    department: string;
+    /** Repositories holding the record. */
+    heldBy: string[];
+}
+/** One page of Discovery search results plus the total hit count. */
+export interface TnaDiscoverySearchResult {
+    /** Total records matching the query, not just this page. */
+    totalCount: number;
+    records: TnaDiscoveryRecord[];
+}
+/** Rolled-up view of one Discovery search page. */
+export interface TnaDiscoverySearchSummary {
+    recordCount: number;
+    totalCount: number;
+}
+/**
+ * Builds a Discovery record search URL for one query.
+ *
+ * @param query - the free-text search term
+ * @returns the record search URL
+ */
+export declare function buildTnaDiscoverySearchUrl(query: string): string;
+/**
+ * Parses a Discovery record search payload.
+ *
+ * @param payload - the raw JSON body from the record search endpoint
+ * @returns the page of catalogue records plus the total hit count
+ */
+export declare function parseTnaDiscoveryRecords(payload: unknown): TnaDiscoverySearchResult;
+/**
+ * Sums one Discovery search page.
+ *
+ * @param result - a page from {@link parseTnaDiscoveryRecords}
+ * @returns the page size and the total hit count
+ */
+export declare function summarizeTnaDiscoverySearch(result: TnaDiscoverySearchResult): TnaDiscoverySearchSummary;
+/**
+ * Searches the Discovery catalogue for one query.
+ *
+ * @param options - the search term and an optional fetch implementation
+ * @returns the page of records the search endpoint returns
+ */
+export declare function fetchTnaDiscoveryRecords(options?: {
+    query?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<TnaDiscoverySearchResult>;
+/** The National Archives Discovery catalogue search, keyless. */
+export declare const tnaDiscoveryAdapter: UkDataAdapter<TnaDiscoverySearchResult>;
+//# sourceMappingURL=tnaDiscovery.d.ts.map

package/dist/tnaDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tnaDiscovery.d.ts","sourceRoot":"","sources":["../src/tnaDiscovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,iEAC2B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,wBAAwB,CAkBnF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,wBAAwB,GAC/B,yBAAyB,CAE3B;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpE,OAAO,CAAC,wBAAwB,CAAC,CASnC;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,wBAAwB,CAWvE,CAAC"}