us-gov-open-data-mcp 1.0.0

package/dist/sdk/sec.d.ts

@@ -0,0 +1,114 @@
+/**
+ * SEC EDGAR SDK — typed API client for SEC EDGAR data.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getCompanyByCik, getCompanyFacts, searchEdgar } from "us-gov-open-data/sdk/sec";
+ *
+ * No API key required. Must include User-Agent with contact info.
+ * Rate limit: 10 requests/second.
+ */
+export interface SecCompany {
+    cik: string;
+    name: string;
+    tickers: string[];
+    exchanges: string[];
+    sic: string;
+    sicDescription: string;
+    stateOfIncorporation: string;
+    entityType: string;
+    category: string;
+    fiscalYearEnd: string;
+    formerNames: {
+        name: string;
+        from: string;
+        to: string;
+    }[];
+    filings: {
+        recent: {
+            form: string[];
+            filingDate: string[];
+            primaryDocDescription: string[];
+            accessionNumber: string[];
+        };
+    };
+}
+export interface SecFiling {
+    form: string;
+    date: string;
+    description: string;
+    accessionNumber: string;
+}
+export interface SecCompanyFacts {
+    cik: number;
+    entityName: string;
+    facts: {
+        "us-gaap"?: Record<string, SecXbrlConcept>;
+        [namespace: string]: Record<string, SecXbrlConcept> | undefined;
+    };
+}
+export interface SecXbrlConcept {
+    label?: string;
+    description?: string;
+    units: Record<string, SecXbrlObservation[]>;
+}
+export interface SecXbrlObservation {
+    start?: string;
+    end?: string;
+    val: number;
+    accn: string;
+    fy: number;
+    fp: string;
+    form: string;
+    filed: string;
+    frame?: string;
+}
+export interface SecSearchResult {
+    total: number;
+    hits: {
+        names: string[];
+        form: string;
+        date: string;
+        description: string;
+    }[];
+}
+export declare const xbrlConcepts: Record<string, string>;
+/** Look up a company by CIK number. */
+export declare function getCompanyByCik(cik: string): Promise<SecCompany>;
+/** Get company financial facts (XBRL data). */
+export declare function getCompanyFacts(cik: string): Promise<SecCompanyFacts>;
+/** Full-text search across EDGAR filings. */
+export declare function searchEdgar(query: string, opts?: {
+    forms?: string;
+    startDate?: string;
+    endDate?: string;
+}): Promise<SecSearchResult>;
+/**
+ * Extract a specific XBRL concept from company facts.
+ * Traverses facts["us-gaap"][concept].units.USD
+ */
+export declare function extractConceptData(facts: SecCompanyFacts, concept: string): {
+    concept: string;
+    label: string;
+    description: string;
+    unit: string;
+    annual: SecXbrlObservation[];
+    quarterly: SecXbrlObservation[];
+} | null;
+/**
+ * Get a summary of key financial metrics from company facts.
+ */
+export declare function summarizeFinancials(facts: SecCompanyFacts): {
+    entityName: string;
+    totalMetrics: number;
+    keyMetrics: {
+        concept: string;
+        label: string;
+        value: number | null;
+        unit: string | null;
+        period: string | null;
+    }[];
+};
+/** Clear cached responses from both clients. */
+export declare function clearCache(): void;
+//# sourceMappingURL=sec.d.ts.map

package/dist/sdk/sec.d.ts.map

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

package/dist/sdk/sec.js

@@ -0,0 +1,151 @@
+/**
+ * SEC EDGAR SDK — typed API client for SEC EDGAR data.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getCompanyByCik, getCompanyFacts, searchEdgar } from "us-gov-open-data/sdk/sec";
+ *
+ * No API key required. Must include User-Agent with contact info.
+ * Rate limit: 10 requests/second.
+ */
+import { createClient } from "../client.js";
+// ─── Clients ─────────────────────────────────────────────────────────
+const USER_AGENT = `us-gov-open-data-mcp/2.0 (${process.env.SEC_CONTACT_EMAIL || "contact@example.com"})`;
+const dataApi = createClient({
+    baseUrl: "https://data.sec.gov",
+    name: "sec-data",
+    defaultHeaders: { "User-Agent": USER_AGENT, Accept: "application/json" },
+    rateLimit: { perSecond: 10, burst: 10 },
+    cacheTtlMs: 30 * 60 * 1000, // 30 min
+});
+const searchApi = createClient({
+    baseUrl: "https://efts.sec.gov/LATEST",
+    name: "sec-search",
+    defaultHeaders: { "User-Agent": USER_AGENT, Accept: "application/json" },
+    rateLimit: { perSecond: 10, burst: 10 },
+    cacheTtlMs: 30 * 60 * 1000,
+});
+// ─── Reference data ──────────────────────────────────────────────────
+export const xbrlConcepts = {
+    Revenues: "Total revenue",
+    RevenueFromContractWithCustomerExcludingAssessedTax: "Revenue from contracts (ASC 606)",
+    NetIncomeLoss: "Net income (loss)",
+    OperatingIncomeLoss: "Operating income",
+    GrossProfit: "Gross profit",
+    Assets: "Total assets",
+    Liabilities: "Total liabilities",
+    StockholdersEquity: "Total stockholders equity",
+    CashAndCashEquivalentsAtCarryingValue: "Cash and cash equivalents",
+    LongTermDebt: "Long-term debt",
+    EarningsPerShareBasic: "Basic earnings per share",
+    EarningsPerShareDiluted: "Diluted earnings per share",
+    CommonStockSharesOutstanding: "Common shares outstanding",
+    Goodwill: "Goodwill",
+    ResearchAndDevelopmentExpense: "R&D expense",
+    SellingGeneralAndAdministrativeExpense: "SG&A expense",
+    InterestExpense: "Interest expense",
+    IncomeTaxExpenseBenefit: "Income tax expense",
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function padCik(cik) {
+    return cik.padStart(10, "0");
+}
+// ─── Public API ──────────────────────────────────────────────────────
+/** Look up a company by CIK number. */
+export async function getCompanyByCik(cik) {
+    return dataApi.get(`/submissions/CIK${padCik(cik)}.json`);
+}
+/** Get company financial facts (XBRL data). */
+export async function getCompanyFacts(cik) {
+    return dataApi.get(`/api/xbrl/companyfacts/CIK${padCik(cik)}.json`);
+}
+/** Full-text search across EDGAR filings. */
+export async function searchEdgar(query, opts = {}) {
+    const params = {
+        q: query,
+        forms: opts.forms,
+        startdt: opts.startDate,
+        enddt: opts.endDate,
+    };
+    const raw = await searchApi.get("/search-index", params);
+    const hits = raw.hits;
+    const total = hits?.total?.value || 0;
+    const rawHits = hits?.hits || [];
+    return {
+        total,
+        hits: rawHits.map(hit => {
+            const source = hit._source;
+            return {
+                names: source.display_names || [],
+                form: String(source.form || "?"),
+                date: String(source.file_date || "?"),
+                description: String(source.file_description || ""),
+            };
+        }),
+    };
+}
+/**
+ * Extract a specific XBRL concept from company facts.
+ * Traverses facts["us-gaap"][concept].units.USD
+ */
+export function extractConceptData(facts, concept) {
+    const usgaap = facts.facts["us-gaap"];
+    if (!usgaap)
+        return null;
+    // Try exact match, then case-insensitive
+    let conceptData = usgaap[concept];
+    let resolvedName = concept;
+    if (!conceptData) {
+        const key = Object.keys(usgaap).find(k => k.toLowerCase() === concept.toLowerCase());
+        if (!key)
+            return null;
+        conceptData = usgaap[key];
+        resolvedName = key;
+    }
+    const unitKey = Object.keys(conceptData.units)[0];
+    if (!unitKey)
+        return null;
+    const allData = conceptData.units[unitKey];
+    return {
+        concept: resolvedName,
+        label: conceptData.label || resolvedName,
+        description: conceptData.description || "",
+        unit: unitKey,
+        annual: allData.filter(d => d.form === "10-K").slice(-20),
+        quarterly: allData.filter(d => d.form === "10-Q").slice(-8),
+    };
+}
+/**
+ * Get a summary of key financial metrics from company facts.
+ */
+export function summarizeFinancials(facts) {
+    const usgaap = facts.facts["us-gaap"];
+    if (!usgaap)
+        return { entityName: facts.entityName, totalMetrics: 0, keyMetrics: [] };
+    const keyMetrics = Object.keys(xbrlConcepts)
+        .filter(m => usgaap[m])
+        .map(m => {
+        const concept = usgaap[m];
+        const unitKey = Object.keys(concept.units)[0];
+        const data = unitKey ? concept.units[unitKey] : [];
+        const latest = data[data.length - 1];
+        return {
+            concept: m,
+            label: xbrlConcepts[m],
+            value: latest ? latest.val : null,
+            unit: unitKey || null,
+            period: latest?.end || null,
+        };
+    });
+    return {
+        entityName: facts.entityName,
+        totalMetrics: Object.keys(usgaap).length,
+        keyMetrics,
+    };
+}
+/** Clear cached responses from both clients. */
+export function clearCache() {
+    dataApi.clearCache();
+    searchApi.clearCache();
+}
+//# sourceMappingURL=sec.js.map

package/dist/sdk/sec.js.map

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

package/dist/sdk/senate-lobbying.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Senate Lobbying Disclosure Act (LDA) SDK — lobbying filings, contributions, registrants, and clients.
+ *
+ * API docs: https://lda.gov/api/v1/ (Django REST framework, self-documenting)
+ * No API key required. Returns paginated JSON.
+ *
+ * Usage:
+ *   import { searchFilings, searchContributions } from "us-gov-open-data-mcp/sdk/senate-lobbying";
+ *   const filings = await searchFilings({ registrant_name: "Pfizer", filing_year: 2025 });
+ */
+export interface LdaPaginated<T> {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: T[];
+}
+export interface LdaFiling {
+    filing_uuid: string;
+    filing_type: string;
+    filing_type_display: string;
+    filing_year: number;
+    filing_period_display: string;
+    filing_document_url: string;
+    income: string | null;
+    expenses: string | null;
+    registrant: {
+        id: number;
+        name: string;
+        description: string | null;
+    } | null;
+    client: {
+        id: number;
+        name: string;
+        general_description: string | null;
+    } | null;
+    lobbying_activities: LdaActivity[];
+    posted_by_name: string;
+    dt_posted: string;
+    [key: string]: unknown;
+}
+export interface LdaActivity {
+    general_issue_code: string;
+    general_issue_code_display: string;
+    description: string;
+    lobbyists: {
+        lobbyist_full_display_name: string | null;
+    }[];
+}
+export interface LdaContributionItem {
+    contribution_type: string;
+    contribution_type_display: string;
+    contributor_name: string;
+    payee_name: string;
+    honoree_name: string;
+    amount: string;
+    date: string;
+}
+export interface LdaContribution {
+    filing_uuid: string;
+    filing_type_display: string;
+    filing_year: number;
+    filing_period_display: string;
+    filer_type_display: string;
+    registrant: {
+        name: string;
+    } | null;
+    lobbyist: {
+        first_name: string;
+        last_name: string;
+        prefix_display: string;
+    } | null;
+    no_contributions: boolean;
+    contribution_items: LdaContributionItem[];
+    [key: string]: unknown;
+}
+export interface LdaRegistrant {
+    id: number;
+    name: string;
+    description: string | null;
+    address_1: string;
+    city: string;
+    state: string;
+    contact_name: string;
+    contact_telephone: string;
+    [key: string]: unknown;
+}
+export interface LdaClient {
+    id: number;
+    client_id: number;
+    name: string;
+    general_description: string | null;
+    state: string;
+    country_display: string;
+    [key: string]: unknown;
+}
+/** Filing type codes */
+export declare const FILING_TYPES: Record<string, string>;
+/** General issue area codes (most common) */
+export declare const ISSUE_CODES: Record<string, string>;
+/** Search lobbying filings — the core data showing who lobbied, for whom, on what, and how much. */
+export declare function searchFilings(opts: {
+    filing_year?: number;
+    filing_type?: string;
+    registrant_name?: string;
+    client_name?: string;
+    issue_code?: string;
+    page_size?: number;
+    page?: number;
+}): Promise<LdaPaginated<LdaFiling>>;
+/** Get a specific filing by UUID — includes full lobbying activity detail. */
+export declare function getFilingDetail(uuid: string): Promise<LdaFiling>;
+/** Search lobbying contributions (campaign donations by lobbyists). */
+export declare function searchContributions(opts: {
+    filing_year?: number;
+    registrant_name?: string;
+    lobbyist_name?: string;
+    page_size?: number;
+}): Promise<LdaPaginated<LdaContribution>>;
+/** Search lobbying registrants (lobbying firms and organizations). */
+export declare function searchRegistrants(opts: {
+    registrant_name?: string;
+    page_size?: number;
+}): Promise<LdaPaginated<LdaRegistrant>>;
+/** Search lobbying clients (who hired lobbyists). */
+export declare function searchClients(opts: {
+    client_name?: string;
+    page_size?: number;
+}): Promise<LdaPaginated<LdaClient>>;
+/** Search individual lobbyists by name. */
+export declare function searchLobbyists(opts: {
+    lobbyist_name?: string;
+    registrant_name?: string;
+    page_size?: number;
+    page?: number;
+}): Promise<LdaPaginated<{
+    id: number;
+    prefix?: string;
+    first_name?: string;
+    last_name?: string;
+    suffix?: string;
+    registrant?: {
+        name: string;
+    };
+    [key: string]: unknown;
+}>>;
+export declare function clearCache(): void;
+//# sourceMappingURL=senate-lobbying.d.ts.map

package/dist/sdk/senate-lobbying.d.ts.map

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

package/dist/sdk/senate-lobbying.js

@@ -0,0 +1,125 @@
+/**
+ * Senate Lobbying Disclosure Act (LDA) SDK — lobbying filings, contributions, registrants, and clients.
+ *
+ * API docs: https://lda.gov/api/v1/ (Django REST framework, self-documenting)
+ * No API key required. Returns paginated JSON.
+ *
+ * Usage:
+ *   import { searchFilings, searchContributions } from "us-gov-open-data-mcp/sdk/senate-lobbying";
+ *   const filings = await searchFilings({ registrant_name: "Pfizer", filing_year: 2025 });
+ */
+import { createClient } from "../client.js";
+const api = createClient({
+    baseUrl: "https://lda.gov/api/v1",
+    name: "senate-lobbying",
+    rateLimit: { perSecond: 3, burst: 8 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+    timeoutMs: 30_000,
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+/** Filing type codes */
+export const FILING_TYPES = {
+    Q1: "1st Quarter Report",
+    Q2: "2nd Quarter Report",
+    Q3: "3rd Quarter Report",
+    Q4: "4th Quarter Report",
+    MM: "Mid-Year Report",
+    MY: "Year-End Report",
+    RN: "Registration (New)",
+    RA: "Registration Amendment",
+    RR: "Registration Renewal",
+    TE: "Termination",
+};
+/** General issue area codes (most common) */
+export const ISSUE_CODES = {
+    HCR: "Health Issues",
+    MMM: "Medicare/Medicaid",
+    TAX: "Taxation/Internal Revenue Code",
+    BUD: "Budget/Appropriations",
+    DEF: "Defense",
+    ENV: "Environment/Superfund",
+    ENG: "Energy/Nuclear",
+    TRD: "Trade (Domestic/Foreign)",
+    FIN: "Financial Institutions/Investments/Securities",
+    TEC: "Science/Technology",
+    EDU: "Education",
+    IMM: "Immigration",
+    LBR: "Labor Issues/Antitrust/Workplace",
+    TRA: "Transportation",
+    AGR: "Agriculture",
+    HOM: "Housing",
+    CPT: "Consumer Issues/Safety/Products",
+    DIS: "Disaster Planning/Emergencies",
+    GOV: "Government Issues",
+    LAW: "Law Enforcement/Crime/Criminal Justice",
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/** Search lobbying filings — the core data showing who lobbied, for whom, on what, and how much. */
+export async function searchFilings(opts) {
+    const params = {
+        page_size: opts.page_size || 20,
+    };
+    if (opts.filing_year)
+        params.filing_year = opts.filing_year;
+    if (opts.filing_type)
+        params.filing_type = opts.filing_type;
+    if (opts.registrant_name)
+        params.registrant_name = opts.registrant_name;
+    if (opts.client_name)
+        params.client_name = opts.client_name;
+    if (opts.issue_code)
+        params.filing_lobbying_activities__general_issue_code = opts.issue_code;
+    if (opts.page)
+        params.page = opts.page;
+    return api.get("/filings/", params);
+}
+/** Get a specific filing by UUID — includes full lobbying activity detail. */
+export async function getFilingDetail(uuid) {
+    return api.get(`/filings/${uuid}/`);
+}
+/** Search lobbying contributions (campaign donations by lobbyists). */
+export async function searchContributions(opts) {
+    const params = {
+        page_size: opts.page_size || 20,
+    };
+    if (opts.filing_year)
+        params.filing_year = opts.filing_year;
+    if (opts.registrant_name)
+        params.registrant_name = opts.registrant_name;
+    if (opts.lobbyist_name)
+        params.lobbyist_name = opts.lobbyist_name;
+    return api.get("/contributions/", params);
+}
+/** Search lobbying registrants (lobbying firms and organizations). */
+export async function searchRegistrants(opts) {
+    const params = {
+        page_size: opts.page_size || 20,
+    };
+    if (opts.registrant_name)
+        params.registrant_name = opts.registrant_name;
+    return api.get("/registrants/", params);
+}
+/** Search lobbying clients (who hired lobbyists). */
+export async function searchClients(opts) {
+    const params = {
+        page_size: opts.page_size || 20,
+    };
+    if (opts.client_name)
+        params.client_name = opts.client_name;
+    return api.get("/clients/", params);
+}
+/** Search individual lobbyists by name. */
+export async function searchLobbyists(opts) {
+    const params = {
+        page_size: opts.page_size || 20,
+    };
+    if (opts.lobbyist_name)
+        params.lobbyist_name = opts.lobbyist_name;
+    if (opts.registrant_name)
+        params.registrant_name = opts.registrant_name;
+    if (opts.page)
+        params.page = opts.page;
+    return api.get("/lobbyists/", params);
+}
+export function clearCache() { api.clearCache(); }
+//# sourceMappingURL=senate-lobbying.js.map

package/dist/sdk/senate-lobbying.js.map

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

package/dist/sdk/treasury.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Treasury Fiscal Data SDK — typed API client for the U.S. Treasury Fiscal Data API.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { queryFiscalData, searchEndpoints, ENDPOINTS } from "us-gov-open-data/sdk/treasury";
+ *
+ * No API key required — completely open.
+ * Base URL: https://api.fiscaldata.treasury.gov/services/api/fiscal_service
+ */
+export interface FiscalDataResponse {
+    data: Record<string, string>[];
+    meta: {
+        count: number;
+        labels: Record<string, string>;
+        dataTypes: Record<string, string>;
+        dataFormats: Record<string, string>;
+        "total-count": number;
+        "total-pages": number;
+    };
+    links: {
+        self: string;
+        first: string;
+        prev: string | null;
+        next: string | null;
+        last: string;
+    };
+}
+export interface EndpointInfo {
+    dataset: string;
+    slug: string;
+    dataTable: string;
+    endpoint: string;
+    description: string;
+}
+export interface QueryParams {
+    fields?: string;
+    filter?: string;
+    sort?: string;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare const ENDPOINTS: EndpointInfo[];
+/** List all datasets, grouped by dataset name. */
+export declare function listDatasets(): Record<string, {
+    dataTable: string;
+    endpoint: string;
+    description: string;
+    slug: string;
+}[]>;
+/** Search endpoints by keyword (local — no API call). */
+export declare function searchEndpoints(query: string): EndpointInfo[];
+/** Get field metadata for an endpoint (calls API with page[size]=1). */
+export declare function getEndpointFields(endpoint: string): Promise<FiscalDataResponse>;
+/** Query the Treasury Fiscal Data API. */
+export declare function queryFiscalData(endpoint: string, params?: QueryParams): Promise<FiscalDataResponse>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=treasury.d.ts.map

package/dist/sdk/treasury.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treasury.d.ts","sourceRoot":"","sources":["../../src/sdk/treasury.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC/B,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,eAAO,MAAM,SAAS,EAAE,YAAY,EA61CnC,CAAC;AAIF,kDAAkD;AAClD,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAY3H;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAS7D;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAOrF;AAED,0CAA0C;AAC1C,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAY7B;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}