@usa-open-data-connectors/usa-sources 0.1.0

package/dist/cpscProductRecalls.js

@@ -0,0 +1,298 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Base URL for the SaferProducts.gov recall service. */
+export const CPSC_RECALL_API_BASE = 'https://www.saferproducts.gov/RestWebServices/Recall';
+/**
+ * First calendar year the adapter reads.
+ *
+ * The service holds recalls from the 1970s, but a story that leans on recent
+ * years does not need a fifty-year fetch: every request costs a year of
+ * data, and the counts before 2014 are thin enough that the year-to-year
+ * shape is noise.
+ */
+export const CPSC_RECALL_FIRST_YEAR = 2014;
+/**
+ * Recall id the service uses for an error row.
+ *
+ * A failed query does not answer with an HTTP error. It answers 200 with a
+ * single row whose id is 0 and whose title begins "Error retrieving Recalls",
+ * which is why the parser checks the row rather than the status code.
+ */
+export const CPSC_ERROR_RECALL_ID = 0;
+/** Start of the first row the agency sends in the error case. */
+const CPSC_ERROR_TITLE_PREFIX = 'Error retrieving Recalls';
+/** Committed snapshot, so a build works when the SaferProducts host is unreachable. */
+const CPSC_RECALL_FIXTURE_FILENAME = 'cpsc-product-recalls-2026-10-02.json';
+/** Shape of the agency's recall date, e.g. "2025-12-18T00:00:00". */
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}/;
+// Every field arrives as PascalCase. A row the agency could not complete
+// arrives with the field null, and the nested arrays arrive as [].
+const CPSC_ROW_SCHEMA = z.object({
+    RecallID: z.number().optional(),
+    RecallNumber: z.string().nullable().optional(),
+    RecallDate: z.string().nullable().optional(),
+    Title: z.string().nullable().optional(),
+    Products: z
+        .array(z.object({ Name: z.string().nullable().optional() }))
+        .nullable()
+        .optional(),
+    RemedyOptions: z
+        .array(z.object({ Option: z.string().nullable().optional() }))
+        .nullable()
+        .optional(),
+    ManufacturerCountries: z
+        .array(z.object({ Country: z.string().nullable().optional() }))
+        .nullable()
+        .optional(),
+});
+const CPSC_PAYLOAD_SCHEMA = z.array(CPSC_ROW_SCHEMA);
+// The committed snapshot holds the folded counts rather than the year of raw
+// rows they came from, because the raw years run to roughly a megabyte each
+// and a build only needs the counts.
+const CPSC_SNAPSHOT_SCHEMA = z.object({
+    exportedAt: z.string(),
+    firstYear: z.number(),
+    newestYear: z.number(),
+    newestRecallDate: z.string(),
+    totalRecalls: z.number(),
+    years: z.array(z.object({ year: z.number(), recallCount: z.number() })).min(1),
+    remedyOptions: z.array(z.object({ option: z.string(), recallCount: z.number() })),
+    manufacturerCountries: z.array(z.object({ country: z.string(), recallCount: z.number() })),
+});
+/** Pulls one named field out of a nested list, dropping blank entries. */
+function valuesFrom(rows, key) {
+    return (rows ?? []).flatMap((row) => {
+        const value = row[key];
+        return value === null || value === undefined ? [] : [value];
+    });
+}
+/**
+ * Builds the request URL for one calendar year of recalls.
+ *
+ * The service refuses a range wider than a year with a body reading
+ * "The underlying provider failed on Open", so a caller reads one year per
+ * request. The endpoint is keyless.
+ *
+ * @param year - the calendar year to read
+ * @returns the full request URL
+ */
+export function buildCpscRecallUrl(year) {
+    const params = new URLSearchParams({
+        format: 'json',
+        RecallDateStart: `${year}-01-01`,
+        RecallDateEnd: `${year}-12-31`,
+    });
+    return `${CPSC_RECALL_API_BASE}?${params.toString()}`;
+}
+/**
+ * Parses one year's response into the recalls dated inside that year.
+ *
+ * A failed query answers 200 with a single error row, which stops the parse
+ * rather than counting as a recall. A row dated outside the year asked for is
+ * dropped, so a response that ignored the date filter cannot widen the year.
+ * A row with no recall number or no readable date is a changed shape and also
+ * stops the parse.
+ *
+ * @param payload - the JSON body from the recall service
+ * @param year - the calendar year the request asked for
+ * @returns the recalls dated inside that year, in the order the agency sent them
+ */
+export function parseCpscRecallPayload(payload, year) {
+    const parsed = CPSC_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError('cpsc-product-recalls', parsed.error.message);
+    }
+    const yearPrefix = `${year}-`;
+    const recalls = [];
+    for (const row of parsed.data) {
+        if (row.RecallID === CPSC_ERROR_RECALL_ID ||
+            (row.Title?.startsWith(CPSC_ERROR_TITLE_PREFIX) ?? false)) {
+            throw new UsSourceApiError('cpsc-product-recalls', row.Title ?? 'The recall service returned an error row');
+        }
+        if (row.RecallDate === null || row.RecallDate === undefined) {
+            continue;
+        }
+        if (!ISO_DATE_PATTERN.test(row.RecallDate)) {
+            throw new UsSourceParseError('cpsc-product-recalls', `Unreadable recall date: ${row.RecallDate}`);
+        }
+        if (!row.RecallDate.startsWith(yearPrefix)) {
+            continue;
+        }
+        if (row.RecallNumber === null ||
+            row.RecallNumber === undefined ||
+            row.RecallNumber.trim() === '') {
+            throw new UsSourceParseError('cpsc-product-recalls', `Recall dated ${row.RecallDate} carries no number`);
+        }
+        recalls.push({
+            recallNumber: row.RecallNumber,
+            recallDate: row.RecallDate.slice(0, 10),
+            title: row.Title ?? '',
+            productNames: valuesFrom(row.Products, 'Name'),
+            remedyOptions: valuesFrom(row.RemedyOptions, 'Option'),
+            manufacturerCountries: valuesFrom(row.ManufacturerCountries, 'Country'),
+        });
+    }
+    return recalls;
+}
+/** Counts how often each value appears, in the order the values were seen. */
+function countValues(values) {
+    const counts = new Map();
+    for (const value of values) {
+        counts.set(value, (counts.get(value) ?? 0) + 1);
+    }
+    return counts;
+}
+/** Turns a counted map into a list, most first, ties broken by name. */
+function sortCounts(counts, build) {
+    return [...counts.entries()]
+        .sort(([leftName, leftCount], [rightName, rightCount]) => leftCount === rightCount ? leftName.localeCompare(rightName) : rightCount - leftCount)
+        .map(([name, count]) => build(name, count));
+}
+/** Picks the year with the most, or fewest, recalls. Ties go to the earlier year. */
+function extremeYear(years, direction) {
+    const first = years[0];
+    if (first === undefined) {
+        throw new UsSourceParseError('cpsc-product-recalls', 'No years to summarise');
+    }
+    return years.reduce((best, year) => {
+        if (direction === 'most') {
+            return year.recallCount > best.recallCount ? year : best;
+        }
+        return year.recallCount < best.recallCount ? year : best;
+    }, first);
+}
+/** Folds year rows and counted fields into the series a story reads. */
+function assembleCpscRecallSeries(input) {
+    const yearTotal = input.years.reduce((sum, year) => sum + year.recallCount, 0);
+    if (yearTotal !== input.totalRecalls) {
+        throw new UsSourceParseError('cpsc-product-recalls', `Year counts add to ${yearTotal}, not the file total of ${input.totalRecalls}`);
+    }
+    const completeYears = input.years.filter((year) => year.year !== input.newestYear);
+    if (completeYears.length === 0) {
+        throw new UsSourceParseError('cpsc-product-recalls', 'No complete year to compare against');
+    }
+    const first = input.years[0];
+    const newest = input.years[input.years.length - 1];
+    if (first === undefined || newest === undefined || first.year !== input.firstYear) {
+        throw new UsSourceParseError('cpsc-product-recalls', 'The year rows do not cover the window asked for');
+    }
+    return {
+        firstYear: input.firstYear,
+        newestYear: input.newestYear,
+        newestRecallDate: input.newestRecallDate,
+        totalRecalls: input.totalRecalls,
+        years: input.years,
+        completeYearCount: completeYears.length,
+        busiestCompleteYear: extremeYear(completeYears, 'most'),
+        quietestCompleteYear: extremeYear(completeYears, 'fewest'),
+        remedyOptions: input.remedyOptions,
+        manufacturerCountries: input.manufacturerCountries,
+    };
+}
+/**
+ * Folds one window of recalls into the counts, the busiest and quietest
+ * complete years, and the remedy and country tallies.
+ *
+ * The newest year in the window is the year the agency is still filling, so
+ * the busiest and quietest years are picked from the years before it.
+ *
+ * @param recalls - the recalls read across the window
+ * @param window - the first and newest year the fetch covered
+ * @returns the counts and the named years
+ */
+export function buildCpscProductRecallSeries(recalls, window) {
+    if (window.newestYear <= window.firstYear) {
+        throw new UsSourceParseError('cpsc-product-recalls', 'The window needs at least two years');
+    }
+    if (recalls.length === 0) {
+        throw new UsSourceParseError('cpsc-product-recalls', 'No recalls to summarise');
+    }
+    const years = [];
+    for (let year = window.firstYear; year <= window.newestYear; year += 1) {
+        years.push({ year, recallCount: 0 });
+    }
+    for (const recall of recalls) {
+        const row = years.find((candidate) => candidate.year === Number(recall.recallDate.slice(0, 4)));
+        if (row === undefined) {
+            throw new UsSourceParseError('cpsc-product-recalls', `Recall dated ${recall.recallDate} falls outside the window`);
+        }
+        row.recallCount += 1;
+    }
+    const dates = recalls.map((recall) => recall.recallDate).sort();
+    const newestRecallDate = dates[dates.length - 1];
+    if (newestRecallDate === undefined) {
+        throw new UsSourceParseError('cpsc-product-recalls', 'No recall date to summarise');
+    }
+    return assembleCpscRecallSeries({
+        firstYear: window.firstYear,
+        newestYear: window.newestYear,
+        newestRecallDate,
+        totalRecalls: recalls.length,
+        years,
+        remedyOptions: sortCounts(countValues(recalls.flatMap((recall) => recall.remedyOptions)), (option, recallCount) => ({ option, recallCount })),
+        manufacturerCountries: sortCounts(countValues(recalls.flatMap((recall) => recall.manufacturerCountries)), (country, recallCount) => ({ country, recallCount })),
+    });
+}
+/**
+ * Parses the folded counts a snapshot holds into the story shape.
+ *
+ * A snapshot is written by the daily loop and keeps the counts, not the year
+ * of raw rows they came from. The year counts must add to the file total, so
+ * a snapshot from a half-finished fetch cannot be read as a smaller file.
+ *
+ * @param payload - the JSON body of a committed snapshot
+ * @returns the counts and the named years
+ */
+export function parseCpscRecallSnapshot(payload) {
+    const parsed = CPSC_SNAPSHOT_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError('cpsc-product-recalls', parsed.error.message);
+    }
+    return assembleCpscRecallSeries({
+        firstYear: parsed.data.firstYear,
+        newestYear: parsed.data.newestYear,
+        newestRecallDate: parsed.data.newestRecallDate,
+        totalRecalls: parsed.data.totalRecalls,
+        years: parsed.data.years,
+        remedyOptions: parsed.data.remedyOptions,
+        manufacturerCountries: parsed.data.manufacturerCountries,
+    });
+}
+/**
+ * Reads the recall file one calendar year at a time.
+ *
+ * The window runs from 2014 to the current year, so a build makes one
+ * request per year and reads about thirteen. Each request carries a whole
+ * year as JSON: 2025 is 420 rows in about 1.3 MB. A failed query answers
+ * 200 with an error row, which the parser turns into a thrown error.
+ *
+ * @param options - an optional window and fetch stub
+ * @returns the counts and the named years
+ */
+export async function fetchCpscProductRecalls(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const firstYear = options?.firstYear ?? CPSC_RECALL_FIRST_YEAR;
+    const newestYear = options?.newestYear ?? new Date().getFullYear();
+    const recalls = [];
+    for (let year = firstYear; year <= newestYear; year += 1) {
+        const url = buildCpscRecallUrl(year);
+        const response = await fetchImpl(url);
+        if (!response.ok) {
+            throw new UsSourceApiError('cpsc-product-recalls', `HTTP ${response.status} reading the ${year} recall file`);
+        }
+        recalls.push(...parseCpscRecallPayload(await response.json(), year));
+    }
+    return buildCpscProductRecallSeries(recalls, { firstYear, newestYear });
+}
+/** US Consumer Product Safety Commission product recalls, keyless. */
+export const cpscProductRecallsAdapter = {
+    id: 'cpsc-product-recalls',
+    name: 'CPSC product recalls',
+    auth: 'none',
+    description: 'Every consumer product recall the Consumer Product Safety Commission has published, one row per recall, with the remedy offered and the countries that made the product.',
+    fetchLive: async (options) => fetchCpscProductRecalls(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseCpscRecallSnapshot(payload),
+    loadFixture: () => parseCpscRecallSnapshot(readFixtureJson(CPSC_RECALL_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=cpscProductRecalls.js.map

package/dist/cpscProductRecalls.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+/** Base error for any US data source client in this package. */
+export declare class UsSourceError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** The remote API rejected the request (HTTP error or bad payload). */
+export declare class UsSourceApiError extends UsSourceError {
+    readonly source: string;
+    constructor(source: string, message: string, options?: ErrorOptions);
+}
+/** The remote payload did not match the expected shape. */
+export declare class UsSourceParseError extends UsSourceError {
+    readonly source: string;
+    constructor(source: string, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,aAAa;aAE/B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,aAAa;aAEjC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB"}

package/dist/errors.js

@@ -0,0 +1,26 @@
+/** Base error for any US data source client in this package. */
+export class UsSourceError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'UsSourceError';
+    }
+}
+/** The remote API rejected the request (HTTP error or bad payload). */
+export class UsSourceApiError extends UsSourceError {
+    source;
+    constructor(source, message, options) {
+        super(`${source}: ${message}`, options);
+        this.source = source;
+        this.name = 'UsSourceApiError';
+    }
+}
+/** The remote payload did not match the expected shape. */
+export class UsSourceParseError extends UsSourceError {
+    source;
+    constructor(source, message, options) {
+        super(`${source}: ${message}`, options);
+        this.source = source;
+        this.name = 'UsSourceParseError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAE/B;IADlB,YACkB,MAAc,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAJxB,WAAM,GAAN,MAAM,CAAQ;QAK9B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAEjC;IADlB,YACkB,MAAc,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAJxB,WAAM,GAAN,MAAM,CAAQ;QAK9B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/femaDisasterDeclarations.d.ts

@@ -0,0 +1,123 @@
+import type { UsDataAdapter } from './types.js';
+/** One disaster declaration in the OpenFEMA file. */
+export interface FemaDeclaration {
+    /** The agency's own identifier for the declaration, e.g. 5672. */
+    disasterNumber: number;
+    /** The date the declaration was signed, e.g. "2026-09-15T00:00:00.000Z". */
+    declarationDate: string;
+    /** Calendar year the declaration is dated to. */
+    year: number;
+    /**
+     * The program the declaration was made under: Major Disaster, Emergency,
+     * Fire Management, or Fire Suppression.
+     */
+    declarationType: string;
+    /** The hazard behind the declaration, e.g. "Fire" or "Severe Storm". */
+    incidentType: string;
+    /** Two-letter state or territory code the declaration names. */
+    stateCode: string;
+    /** State or territory name that goes with the code. */
+    stateName: string;
+}
+/** One calendar year of declarations, with the fire share split out. */
+export interface FemaDeclarationYear {
+    year: number;
+    total: number;
+    fire: number;
+}
+/** One value of a counted field, with how many declarations carry it. */
+export interface FemaDeclarationCount {
+    name: string;
+    count: number;
+}
+/** The whole declaration file, folded into the shape a story reads. */
+export interface FemaDeclarationCatalogue {
+    /** Every declaration in the file, oldest first. */
+    declarations: FemaDeclaration[];
+    declarationCount: number;
+    firstYear: number;
+    newestYear: number;
+    /** One entry per calendar year in the file, oldest first. */
+    years: FemaDeclarationYear[];
+    busiestYear: FemaDeclarationYear;
+    /** Declarations whose incident type is fire. */
+    fireCount: number;
+    firstFireYear: number;
+    /** Incident types, most declarations first. */
+    incidentTypes: FemaDeclarationCount[];
+    /** Declaration programs, most declarations first. */
+    declarationTypes: FemaDeclarationCount[];
+    /** States and territories, most declarations first. */
+    topStates: FemaDeclarationCount[];
+}
+/** Base URL for the OpenFEMA API. */
+export declare const FEMA_OPEN_DATA_API_BASE = "https://www.fema.gov/api/open/v1";
+/** Dataset path for the web disaster declarations file. */
+export declare const FEMA_DECLARATION_PATH = "/FemaWebDisasterDeclarations";
+/**
+ * Row cap for one request.
+ *
+ * The file carries a little over five thousand declarations from 1953 on,
+ * so one request covers it and the adapter never pages. A file that outgrows
+ * the cap is caught by the parser rather than silently truncated.
+ */
+export declare const FEMA_DECLARATION_ROW_LIMIT = 10000;
+/**
+ * Incident type the file uses for wildfire declarations.
+ *
+ * Fires arrive under several declaration programs (Fire Management, Fire
+ * Suppression, and occasionally Major Disaster), so the incident type is what
+ * the adapter counts rather than the program.
+ */
+export declare const FEMA_FIRE_INCIDENT_TYPE = "Fire";
+/**
+ * Builds the request URL for the whole declaration file.
+ *
+ * The endpoint is keyless. The row cap is high enough that one request
+ * covers the file, and the inline count lets the parser tell a complete
+ * response from a truncated one.
+ *
+ * @param options - an optional row cap
+ * @returns the full request URL
+ */
+export declare function buildFemaDeclarationUrl(options?: {
+    rowLimit?: number;
+}): string;
+/**
+ * Parses one response into the declarations it carries.
+ *
+ * A row without the fields the story reads stops the parse, so a changed
+ * response shape cannot quietly produce a half-empty file. A response whose
+ * row count falls short of the agency's own count means the file has outgrown
+ * the request and is also refused, rather than truncated.
+ *
+ * @param payload - the JSON body from the OpenFEMA API
+ * @returns the declarations, in the order the agency sent them
+ */
+export declare function parseFemaDeclarationPayload(payload: unknown): FemaDeclaration[];
+/**
+ * Folds the parsed file into the per-year and per-value counts a story reads.
+ *
+ * The years run from the oldest declaration in the file to the newest, and
+ * the newest one is a partial year whenever the current year is still open.
+ *
+ * @param declarations - the parsed declarations, in any order
+ * @returns the per-year counts, the busiest year, and the value counts
+ */
+export declare function buildFemaDeclarationCatalogue(declarations: FemaDeclaration[]): FemaDeclarationCatalogue;
+/**
+ * Reads the OpenFEMA disaster declaration file.
+ *
+ * One keyless request covers the whole file, from the 1953 declarations to
+ * the newest one the agency has published.
+ *
+ * @param options - an optional row cap and fetch stub
+ * @returns the declarations and the counts the story reads
+ */
+export declare function fetchFemaDeclarations(options?: {
+    rowLimit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<FemaDeclarationCatalogue>;
+/** FEMA disaster declarations, keyless. */
+export declare const femaDisasterDeclarationsAdapter: UsDataAdapter<FemaDeclarationCatalogue>;
+//# sourceMappingURL=femaDisasterDeclarations.d.ts.map

package/dist/femaDisasterDeclarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"femaDisasterDeclarations.d.ts","sourceRoot":"","sources":["../src/femaDisasterDeclarations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,qDAAqD;IACrD,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,uDAAuD;IACvD,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,qCAAqC,CAAC;AAE1E,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAqC9C;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQ/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CA2D/E;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,eAAe,EAAE,GAC9B,wBAAwB,CA+C1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAUpC;AAED,2CAA2C;AAC3C,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC,wBAAwB,CAanF,CAAC"}